Commit Graph

212 Commits

Author SHA1 Message Date
tetrapod00
0da4dbe145 Add self links to shader functions page 2024-12-13 22:17:49 -08:00
Ryan
7c1eefda90 TIME is affected by time_scale 2024-12-07 21:14:22 -05:00
tetrapod00
55cd8723fc Improve Shader functions page 2024-12-05 13:09:40 -08:00
Max Hilbrunner
bac98a0aa2 Merge pull request #10344 from tetrapod00/shader-function-modified
Note that shader function descriptions are modified from OpenGL docs
2024-11-30 01:55:01 +01:00
tetrapod00
f40128b9ba Note that shader function descriptions are modified from OpenGL docs 2024-11-29 15:53:13 -08:00
tetrapod00
f2ce3eee91 Standardize renderer names and terms 2024-11-29 13:26:48 -08:00
Chaosus
b1190d5371 Add SCREEN_UV shader built-in to spatial light shader 2024-11-26 21:43:29 +03:00
Chaosus
ef7e5e39be Remove extra paragraph textureQueryLod from shader_functions.rst 2024-11-23 12:32:44 +03:00
Chaosus
c46c219825 Add samplerExternalOES type to variable types of shading language 2024-11-21 23:42:55 +03:00
Daniel Ashby
c10b857b54 Improve shader function descriptions (#9338)
- Move built-in shader function descriptions from Shading Language
  to a new page, with a format like the class reference.
- Shader built-in functions are sorted by category, each with a summary
  table and then full descriptions of each function, with parameters, 
  returns, and links to the official Khronos docs.

---------

Co-authored-by: clayjohn <claynjohn@gmail.com>
Co-authored-by: ashbygeek <daniel.ashby@sern.blueskydevops.net>
Co-authored-by: Yuri Rubinsky <chaosus89@gmail.com>
Co-authored-by: A Thousand Ships <96648715+AThousandShips@users.noreply.github.com>
Co-authored-by: tetrapod <145553014+tetrapod00@users.noreply.github.com>
2024-11-19 22:41:36 -08:00
Amirtha Krishnan
1b51bb7b1a Add documentation for hint_enum uniform in shading_language.rst (#9841)
* Adding documentation for ``hint_enum`` uniform in shading_language.rst

Added explanation regarding ``hint_enum`` behaviour and usage in Uniforms section.
Also added a row in the Uniforms section table to reflect this new hint type

This PR is documentation regarding : godotengine/godot#94324

---------

Co-authored-by: A Thousand Ships <96648715+AThousandShips@users.noreply.github.com>
2024-11-19 16:26:46 -08:00
Max Hilbrunner
07fbf9ee05 Merge pull request #10259 from tetrapod00/clarify-vertex
Clarify VERTEX and other shader built-ins
2024-11-19 10:54:35 +01:00
Max Hilbrunner
8c291253b8 Merge pull request #10235 from tetrapod00/builtin-built-in
Use "built-in" and "built into", avoid "builtin", "built in", and "built-in to"
2024-11-14 13:32:14 +01:00
tetrapod00
6919723ae2 Clarify VERTEX and other shader built-ins 2024-11-13 14:11:45 -08:00
tetrapod00
76bcb140d4 Consistently use "built-in" and "built into", avoid "builtin" and "built-in to" 2024-11-08 17:28:29 -08:00
tetrapod00
6afebce86f Document CURRENT_RENDERER built-in shader define 2024-11-08 12:40:19 -08:00
tetrapod00
5994348764 Change all usages of "run-time" to "runtime" 2024-11-06 23:36:58 -08:00
Max Hilbrunner
5b0f7925be Merge pull request #10171 from tetrapod00/global-const-arrays
Fix inaccurate/misleading note about shader global arrays
2024-11-05 00:45:45 +01:00
Flarkk
7c78f294be Clarify when fragcoord z is used as depth output 2024-10-31 16:36:48 +01:00
tetrapod00
ed8b4c8099 Fix inaccurate note about shader global arrays 2024-10-30 02:17:08 -07:00
Hugo Locurcio
4679999c4d Tweak constant example in Shading language to avoid referring to reserved PI 2024-10-29 15:15:43 +01:00
Max Hilbrunner
d904c1df55 Merge pull request #10153 from tetrapod00/shader-uniform-limit
Add note about shader uniform size limit to Shading Language
2024-10-28 21:03:07 +01:00
tetrapod00
58867df52b Add note about uniform buffer size limit to Shading Language 2024-10-28 09:14:09 -07:00
Max Hilbrunner
2d0b917e79 Merge pull request #10114 from tetrapod00/renderer-comparison
Add new Renderers page
2024-10-28 14:37:25 +01:00
tetrapod00
04a986db73 Add new Renderers page
Adds a new page which gives a summary of the three renderers. This page briefly
describes the renderers, gives some guidance on how to choose a renderer. It also
contains a comparison table between the renderers.
Adds an entry in the FAQ which links to this new page.
Adds a note about subsurface scattering limitations to the Standard Material page.
Adjusts some other pages which had incorrect information.
2024-10-27 18:51:36 -07:00
Matthew
d7135355fa Merge pull request #10143 from tetrapod00/large-world-coords-shader
Note limitation of shader world coordinates with large world coordinates
2024-10-25 18:52:51 -04:00
tetrapod00
e4d395de48 Note limitation of shader world coordinates with large world coordinates 2024-10-25 11:03:58 -07:00
Max Hilbrunner
cb2a53f881 Merge pull request #10119 from tetrapod00/shader-source-color
Clarify use of source_color in Shading Language
2024-10-25 13:27:41 +02:00
Chaosus
5320185f73 Fix typo in spatial_shader.rst 2024-10-25 14:13:23 +03:00
Yuri Rubinsky
bb40500d11 Merge pull request #10129 from Chaosus/shader_clip_space_far
Add `CLIP_SPACE_FAR` built-in description to spatial shaders
2024-10-25 14:09:14 +03:00
Chaosus
f93332bd75 Add CLIP_SPACE_FAR built-in description to spatial shaders 2024-10-25 14:04:23 +03:00
tetrapod00
7303e5733e Clarify use of source_color in Shading Language
Rewrite section on using the source_color uniform hint. Content is mostly the same,
but is more clear.
Rename one instance of "shader hint" to "uniform hint".
Adds a section header for Uniform hints.
2024-10-24 21:03:17 -07:00
Chaosus
212ce6746d Note about stage func/discard may be used in custom shader function 2024-10-24 17:35:09 +03:00
Chaosus
e3af8aa69b Add #error shader preprocessor directive description 2024-10-22 12:00:21 +03:00
Max Hilbrunner
7061a2aa92 Merge pull request #9846 from Flarkk/shader_matrix_convention
Fix shader language matrix row/col convention
2024-10-20 04:13:42 +02:00
Max Hilbrunner
a31b251589 Merge pull request #10107 from tetrapod00/canvasitem-shader-color-texture
Clarify COLOR and TEXTURE in CanvasItem shaders
2024-10-19 05:25:26 +02:00
tetrapod00
be84df8210 Clarify COLOR and TEXTURE in CanvasItem shaders 2024-10-18 10:55:46 -07:00
Max Hilbrunner
3a3fa0ee7c Merge pull request #9939 from clayjohn/shaders-instance-uniform-note
Remove note about not supporting per-instance uniforms in the Compatibility backend
2024-10-18 05:46:55 +02:00
tetrapod00
b757d4019d Add warning about uninitialized variables in shaders
Adds a warning note to shading_language.rst. GDShader does not
initialize local variables to 0, and an uninitialized local variable can
contain an arbitrary value.
2024-10-17 12:51:38 -07:00
Chaosus
c3feaed32a Fix shader function overloading paragraph 2024-10-15 09:26:17 +03:00
Brian Huynh
67e37b547c Add notes on bit depth for ints and floats (#10028)
* Added notes on bit depth for ints and floats

Added a small note about the bit depth of integers and floats in Godot's shading language as it is not explicitly stated anywhere.

The bit depth of integer and floats in GDscript and Godot's shading language are different, which can cause problems with lost precision in calculations when integers are set from GDscript as floats/ints in GDscript are 64 bits instead of 32 bits (the standard in GLSL ES 3.0).

While most are unlikely to run into problems due to this difference in bit depth, it can cause mathematical errors in edge cases. As stated by previous contributors, no error will be thrown if types do not match while setting a shader uniform. This includes GDscript floats being set as Godot shader floats (which may not be intuitive).
2024-10-04 03:30:24 +02:00
tetrapod00
4e02ee375a Standardize style within spatial_shader.rst, etc 2024-09-20 12:36:09 -07:00
clayjohn
f890412082 Remove note about not supporting per-instance uniforms in the Compatibility backend 2024-09-10 14:59:19 -07:00
Florent Guiocheau
54f368c4de Fix shader language matrix row/col convention 2024-08-27 16:44:02 +02:00
Matthew
6a61ee7632 Merge pull request #9735 from tetrapod00/spatial-custom-uvs
Update spatial_shaders.rst with CUSTOM0,1,2,3 descriptions (used for extra UVs)
2024-08-14 19:50:27 -04:00
Matthew
603f4dcd1a Merge pull request #9734 from tetrapod00/time-shader
Update description of shader variable TIME and add description to Fog, Particle, Sky, and Spatial shader pages
2024-08-14 19:47:02 -04:00
tetrapod00
27a205a9cc Update spatial_shaders.rst with CUSTOM0,1,2,3 descriptions. 2024-08-14 11:24:46 -07:00
tetrapod00
19dc2ff818 Add description of TIME to shader pages, add label to global uniform header
Added/changed description of TIME in CanvasItem, Fog, Particle, Sky, and Spatial shader pages. Description now links to other relevant docs pages. Added a label to the global uniform header of shading_languge.rst, so it can be cross referenced from elsewhere.
2024-08-10 17:39:44 -07:00
Hugo Locurcio
48df572ab9 Add cubemap template images to Importing images
Images were generated using
<https://github.com/Calinou/godot-cubemap-generator>.
2024-08-08 19:34:33 +02:00
Hana - Piralein
88ee7438be Add description for custom vertex values
Co-Authored-By: Clay John <claynjohn@gmail.com>
2024-07-13 13:45:02 +02:00