Commit Graph

216 Commits

Author SHA1 Message Date
skyace65
3e734afb43 Remove outdated references to other tutorial 2024-02-04 12:09:23 -05:00
谢天
6177568e15 Update spatial_shader.rst to delete outdated light shader usage 2024-01-23 10:44:11 +08:00
Max Hilbrunner
946fc5281f Merge pull request #8694 from seadylan/patch-1
Fixed unordered list markup in "Converting GLSL to Godot shaders"
2024-01-15 02:04:18 +01:00
Hugo Locurcio
95fb178429 Add support for user-provided comments with Giscus
This allows users to leave comments on pages that don't have
`:allow_comments: False` somewhere in the page's source.
Both manual and class reference pages can receive comments.
Index pages cannot have comments, as discussion should occur on "leaf" pages.

GitHub Discussions is used as a backend on the same repository. This means
that Discussions *must* be enabled on godotengine/godot-docs before this
commit is merged to `master`. Users can choose to use the "Custom" watch
mode if they don't want to get notifications for discussion updates,
but still get notifications for issue and pull request updates.

User comments are intended to be used for the following purposes:

- Add a clarification or correct something in the documentation,
  without having to open a pull request. Contributors are encouraged to
  take a look at discussions from time to time, and see if there's information
  worth incorporating in the pages themselves. Don't forget to reply to
  the comment when doing so :)
- Mention a workaround for a common issue.
- Link to useful third-party resources that are relevant to the current page,
  such as tutorials or add-ons.

User comments should *not* be used for technical support. Other community
platforms should be used for that.

Page-to-discussion matching is done using the `pagename` Sphinx variable,
which is independent of the Godot version and documentation language.
Being independent of the Godot version allows keeping old comments
when the Godot version changes, while also allowing users from `/stable`
and `/4.1` to "see" each other in discussions.

See https://giscus.app for more information.
2024-01-11 17:51:53 +01:00
谢天
d8f2ce6d6f Update spatial_shader.rst to mention godot use the same VIEW vector for both perspective and orthogonal cameras. 2024-01-03 11:52:08 +08:00
seadylan
83cad834b2 Fixed unordered list markup in "Converting GLSL to Godot shaders"
The unordered list markup was missing a blank line at the beginning, so it displayed all the list item on a single line of text instead of in a proper bulleted list.
2024-01-02 11:35:49 +01:00
谢天
1c2a030049 Update textureQueryLevels to mention it returns 1 when the texture is unassigned 2023-12-22 14:32:13 +01:00
Hugo Locurcio
59842e9c35 Fix per-instance shader parameter classref link in Shading language 2023-12-16 22:08:28 +01:00
AveMo
ebf5a78578 Removed reference to 'DEPTH' in CanvasItem shaders (#8616)
* Remove 'DEPTH' constant from CanvasItem shaders

* Re-added Origin mention
2023-12-13 17:10:56 +01:00
Patrick Exner
03ddb93d0a Update first 2D shader TEXTURE built-in variable section 2023-12-07 20:45:58 +01:00
Hugo Locurcio
7fb4080299 Document limitations of local RenderingDevices in Using compute shaders 2023-11-24 20:38:21 +01:00
Matthew
fabd885d89 Merge pull request #8459 from ShlomiRex/visual_shaders_interface
Add visual shader node interface explanation
2023-11-24 14:28:24 -05:00
Max Hilbrunner
1088ee341b Merge pull request #8523 from AThousandShips/comment_fix
Fix some headers that were incorrectly comments
2023-11-23 13:08:48 +01:00
Max Hilbrunner
37a5a9b4f7 Merge pull request #8506 from clayjohn/shaders-CI-particles
Update shader reference pages for canvas_item shaders and particle shaders for 4.2
2023-11-23 13:08:04 +01:00
A Thousand Ships
00e4e554e1 Fix some headers that were incorrectly comments 2023-11-23 12:21:53 +01:00
clayjohn
da93553be2 Update shader reference pages for canvas_item shaders and particle shaders for 4.2 2023-11-21 11:43:36 -07:00
tetrapod
ab5bba9dfe Removed specular_phong and specular_blinn from spatial_shader.rst 2023-11-19 22:29:25 -08:00
Shlomi
ee9e10e6a9 Update vs_node.webp
Added port types
2023-11-19 01:11:51 +02:00
Max Hilbrunner
9aba4a087a Merge pull request #8467 from Calinou/remove-unused-images
Remove unused images
2023-11-15 07:10:03 +01:00
Pikario
b65d7cab1b Update the default diffuse mode 2023-11-13 23:34:58 +01:00
Hugo Locurcio
f9817954c7 Remove unused images
This reduces the size of ZIP downloads for offline reading.

Unused images were found by running `_tools/list-unused-images.sh`.
These images were used in Godot 2.x and 3.x documentation,
but have been replaced by remade images with different names since.
2023-11-13 21:57:19 +01:00
kleonc
be0806bbc0 Document VERTEX_ID, INSTANCE_ID built-ins for canvas_item vertex shader 2023-11-02 12:35:45 +01:00
Hugo Locurcio
2b3c3c3ef4 Document source_color shader hint being relevant for 2D HDR 2023-11-01 19:25:04 +01:00
Hugo Locurcio
9773552257 Emphasize the importance of mipmaps for textureLod() in Screen-reading shaders
This also mentions that reading the normal/roughness buffer is only
currently supported in Forward+.
2023-10-26 02:32:37 +02:00
Max Hilbrunner
a6411c7d9d Merge pull request #8198 from tetrapod00/patch-2
Reorder "Advanced Postprocessing" page to after "Custom Postprocessing"
2023-10-21 20:55:14 +02:00
Jan Thomä
c490d5ede6 fix: vertex coordinates are in canvas space 2023-10-19 17:37:03 +02:00
tetrapod
bbb9f3efb8 Add link to "Environment and Post-Processing" from "Custom Post-Processing" 2023-10-08 20:47:30 -07:00
tetrapod
94c606058b Move "Advanced Postprocessing" to follow "Custom Postprocessing" 2023-10-08 19:19:51 -07:00
Max Hilbrunner
20a6f9ea14 Merge pull request #8069 from kb173/master
Add instructions on sky shader optimization
2023-10-03 23:57:21 +02:00
Hex-4
37a96ba407 Close #7690 (add info for shader hints and default values) (#8117)
* add comment for default values

* Add a line telling where the default value goes

---------

Co-authored-by: A Thousand Ships <96648715+AThousandShips@users.noreply.github.com>
2023-10-02 10:57:16 +02:00
Aaron Franke
3407328860 Fix typos: "modelling" -> "modeling" 2023-10-01 12:52:25 -05:00
LandscapeLab Office
d1fc885543 Add instructions on sky shader optimization 2023-09-27 14:16:05 +02:00
Rémi Verschelde
adbab1482c Merge pull request #6979 from JohanAR/shaderpp_concat
Add concatenation to shader preprocessor
2023-09-27 10:51:36 +02:00
Max Hilbrunner
a766184cf1 Merge pull request #8015 from thygrrr/shader-example-lighting-fix
Update spatial_shader.rst
2023-09-27 03:04:25 +02:00
Luna
0fe7ff833e Fixed typos in several doc files (#8002)
* Fixed typos in
- c_sharp_differences.rst
- debugger_panel.rst
- gdextension_cpp_example.rst
- gui_using_fonts.rst
- openxr_hand_tracking.rst
- overview_of_debugging_tools.rst
- setting_up_xr.rst
- shading_language.rst
- the_profiler.rst
- your_second_3d_shader.rst

* Update tutorials/shaders/shader_reference/shading_language.rst

Co-authored-by: A Thousand Ships <96648715+AThousandShips@users.noreply.github.com>

* PR Feedback

---------

Co-authored-by: Luna <2650849-Lunalicious@users.noreply.gitlab.com>
Co-authored-by: A Thousand Ships <96648715+AThousandShips@users.noreply.github.com>
2023-09-25 00:41:33 +02:00
Thygrrr
bd7eb30f29 Update spatial_shader.rst
The reference page suggests a very unfortunate lighting function that modulades the color values in ALBEDO again. This does not seem representative of the shading model.

Also, it omitted LIGHT_COLOR; repalcing the ALBEDO term with LIGHT_COLOR gives a much more expected diffuse lighting example.
2023-09-23 13:00:40 +02:00
Max Hilbrunner
8b4cc3b229 Merge pull request #7897 from TidB/master
Fix SIZE built-in in fog shader reference
2023-09-13 04:16:06 +02:00
TidB
4d22f09704 Fix SIZE built-in in fog shader reference
It has been renamed from EXTENTS; while its description was completely unrelated (copied from the sky shader reference)
2023-09-09 14:39:15 +02:00
Milan Gruner
ed7b0374cc Add documentation for render mode fog_disabled and Disable Fog in BaseMaterial3D 2023-09-05 21:44:20 +02:00
Johan Aires Rastén
d3f86dc941 Add concatenation to shader preprocessor 2023-08-16 16:42:09 +02:00
Max Hilbrunner
1442ace7a5 Merge pull request #7560 from cridenour/patch-1 2023-07-18 13:43:49 +02:00
Max Hilbrunner
fa01e18ae3 Merge pull request #7655 from Calinou/fix-backticks 2023-07-18 13:21:11 +02:00
Bruno
ca634145ac Update particle_shader.rst 2023-07-18 00:31:49 -06:00
Bruno
f2bfa933a2 Update tutorials/shaders/shader_reference/particle_shader.rst
Co-authored-by: Clay John <claynjohn@gmail.com>
2023-07-17 22:59:00 -06:00
Bruno
a88b6888b7 add USERDATA* built in reference 2023-07-17 00:43:33 -06:00
Hugo Locurcio
df904137db Fix incorrect usage of backticks in various pages 2023-07-14 19:31:01 +02:00
Matthew
d3d680729e Merge pull request #7561 from Calinou/spatial-shader-light-color-pi-multiplier
Document `LIGHT_COLOR` being multiplied by `PI` in Spatial shader
2023-07-05 20:10:53 -04:00
ffernn
2076e147c2 Added sky and fog shaders the the "Built-in variables" section 2023-06-28 17:47:02 +10:00
Hugo Locurcio
f57bdb3758 Document LIGHT_COLOR being multiplied by PI in Spatial shader 2023-06-26 10:12:28 +02:00
Chris Ridenour
2bea88b4ea Fix OBJECT_POSITION description to match engine behavior. 2023-06-25 23:34:26 -04:00