Commit Graph

221 Commits

Author SHA1 Message Date
tetrapod00
a2d2c07aee Improve shading language page 2025-01-28 00:36:30 -08:00
Ben
d251fe8442 Divide pi out of light color
This should have been updated in https://github.com/godotengine/godot-docs/pull/7568
2025-01-12 20:13:49 -08:00
Max Hilbrunner
70a32c6950 Merge pull request #10261 from tetrapod00/improve-uniform
Reorganize and improve shader Uniforms section
2025-01-03 10:47:26 +01:00
Max Hilbrunner
0ebcd118d2 Merge pull request #10315 from tetrapod00/shader-global-clarify
Explain difference between global shader uniforms and global scope in shaders
2025-01-03 10:30:05 +01:00
tetrapod00
c4d3aa134a Standardize RST header syntax 2024-12-29 13:44:09 -08:00
Max Hilbrunner
8c18786cc1 Merge pull request #10409 from tetrapod00/no-simply
Simply remove some words
2024-12-15 17:31:18 +01:00
tetrapod00
bd25f5813a Simply remove some words 2024-12-14 20:36:17 -08:00
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
tetrapod00
17bb2f368c Explain difference between global shader uniforms and global scope in shaders 2024-11-25 10:36:52 -08:00
tetrapod00
3ee7142208 Reorganize and improve shader Uniforms section 2024-11-23 15:43:56 -08: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