Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

VERTEX shader built-in description confusing #10250

Open
tetrapod00 opened this issue Nov 11, 2024 · 0 comments · May be fixed by #10259
Open

VERTEX shader built-in description confusing #10250

tetrapod00 opened this issue Nov 11, 2024 · 0 comments · May be fixed by #10259

Comments

@tetrapod00
Copy link
Contributor

tetrapod00 commented Nov 11, 2024

Your Godot version:
4.4
Issue description:
This issue came from a help chat discussion, making this issue to track for myself.

VERTEX in fragment() assumes a bit of shader knowledge. The current description "Vertex position that comes from the vertex() function (default, in view space)" assumes that you already know that the pixel/fragment position is the interpolated vertex position. I'm not even sure if the docs currently document how values get interpolated like this. The table can't explain how everything in shaders works, of course, but this seems like it can be made more clear with only a few words.

Possible improvements:

  • Improve the VERTEX description itself, and likely the vertex() VERTEX and maybe vertex() POSITION ones too, to avoid confusion when searching for "position" in the page.
  • Check that interpolation between vertex() and fragment() is covered somewhere, maybe mention it briefly in this page.

URL to the documentation page (if already existing):
https://docs.godotengine.org/en/latest/tutorials/shaders/shader_reference/spatial_shader.html

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

Successfully merging a pull request may close this issue.

1 participant