godotengine/godot-docs
1
0
Fork 0
mirror of https://github.com/godotengine/godot-docs.git synced 2026-01-03 05:48:42 +03:00
Code Issues Packages Projects Releases Wiki Activity
10,894 Commits 20 Branches 0 Tags
stable
Commit Graph

243 Commits

Author SHA1 Message Date
Ted Gignac
304d1070f2 Add details on the shader's eye position built-ins 
Changed descriptions for CAMERA_POSITION_WORLD and EYE_OFFSET to benefit XR developers.
I decided to make this pull request because my dad spent a while trying to get the eye positions correct, eventually finding  that CAMERA_POSITION_WORLD is the same for both eyes, and later that the EYE_OFFSET is not in world space.
My dad and I were almost led to believe that the perspective artifacts we saw with our custom shader were due to an optimization in the headset, and that we would have to work around it in our game, but it has since been fixed.
 2025-10-02 15:54:07 +02:00
Max Hilbrunner
bbb393cfc7 Merge pull request #11201 from stuckupfool/patch-1 
Update shading_language.rst
 2025-09-13 04:06:19 +02:00
Hugo Locurcio
0fc73a7c0d Document REGION_RECT canvas shader built-in 
This was added in 4.5 to better accomodate Sprite2D with regions enabled.
 2025-08-22 18:18:33 +02:00
Justin Hertel
7a479aab52 Update shading_language.rst 
Updated warning on per-instance shader uniforms indicating that "instance uniform arrays" are not supported
 2025-08-13 15:04:07 -04:00
Adam Sawicki
0e4fee7988 Fix shader_functions.rst - description of pack/unpack for Snorm/Unorm functions 2025-07-28 12:53:34 +02:00
Danil Alexeev
3946ede7aa Replace remaining uses of shorthand codeblock syntax, add CI check 2025-07-25 16:20:16 -04:00
A Thousand Ships
92cd36b50e Various grammar and spelling fixes 2025-06-23 16:37:26 +02:00
Hugo Locurcio
8a6ad4c926 Replace uses of shorthand codeblock syntax to avoid issues with localization 
Previously, many paragraphs in the documentation used `::` at the end of a line
as a replacement for a single colon (and `::` on the following line).
Due to this, the `::` was part of the extracted string for localization.
Weblate also showed a warning about the trailing `::`, as it's not
normally expected to be there.

This change requires translators to revalidate all modified strings.
However, considering many of those have broken code blocks due to translators
replacing `::` with `:`, it can be a good idea.

This also adds documentation writing guidelines for code blocks and admonitions.
This commit does not modify existing admonitions in any way (as this would
lead to a much larger diff, and require more localizable text to be revalidated
by translators).
 2025-05-30 02:02:30 +02:00
Chaosus
916c65fe71 Few fixes for shader's built-in methods 2025-05-01 14:45:29 +03:00
Gio Aleman
c910af068e Minor formatting fix 2025-04-16 21:37:34 -04:00
Matthew
7329907b4a Merge pull request #10834 from pixcai/patch-1 
Fix description of `shadows_disabled` shader render mode
 2025-04-06 19:25:37 -04:00
Hugo Locurcio
93963ab701 Document support for 2D per-instance uniforms in Shading language (#10749) 
* Document support for 2D per-instance uniforms in Shading language
 2025-04-05 13:22:18 -04:00
pixcai
ba72293880 Update spatial_shader.rst 2025-04-04 17:14:33 +08:00
Max Hilbrunner
e2c795c03d Merge pull request #10680 from Calinou/ci-check-urls 
GitHub Actions: Check URLs using lychee
 2025-02-19 19:53:49 +01:00
Hugo Locurcio
51a597f7b6 GitHub Actions: Check URLs using lychee 
This makes it possible to be aware of dead links and replace
them with other resources (such as archived versions) as
soon as possible.
 2025-02-17 15:56:09 +01:00
GlitchCode24
619edd2cae Update tutorials/shaders/shader_reference/shading_language.rst 
Co-authored-by: tetrapod <145553014+tetrapod00@users.noreply.github.com>
 2025-02-15 22:56:43 +02:00
GlitchCode24
99b4f2494c Add else if 2025-02-15 22:47:20 +02:00
Matthew
ea1b882aa7 Merge pull request #10606 from tetrapod00/first-3d-update 
Improve First 3D shader tutorial
 2025-02-04 17:35:24 -05:00
tetrapod00
287ad02f83 Improve First 3D shader tutorial 2025-02-02 14:53:13 -08:00
tetrapod00
858c663ab1 Add note to use varyings to access builtins in shader pages 2025-02-02 13:00:12 -08:00
Matthew
0c82320d79 Merge pull request #10558 from tetrapod00/shader-tweaks 
Improve shading language page
 2025-01-28 20:08:31 -05:00
tetrapod00
a2d2c07aee Improve shading language page 2025-01-28 00:36:30 -08:00
Hugo Locurcio
e43dd0821c Update list of spatial shader render modes for Godot 4.3 
This also improves the documentation for existing render modes.
 2025-01-25 18:42:57 +01: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