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

Expand docs for "TextureParameterTriplanar" visual node #10082

Open
Sturlen opened this issue Oct 14, 2024 · 1 comment
Open

Expand docs for "TextureParameterTriplanar" visual node #10082

Sturlen opened this issue Oct 14, 2024 · 1 comment

Comments

@Sturlen
Copy link

Sturlen commented Oct 14, 2024

Your Godot version:
4.3

Issue description:
The visual node in question:

image

The documentation for this node only says:

Performs a uniform texture lookup with triplanar within the visual shader graph.
Performs a lookup operation on the texture provided as a uniform for the shader, with support for triplanar mapping.

It would be helpful if the docs explained what these inputs are and how they are used. An example would also go a long way.

URL to the documentation page (if already existing):
https://docs.godotengine.org/en/stable/classes/class_visualshadernodetextureparametertriplanar.html

@tetrapod00
Copy link
Contributor

To start off with, I agree that visual shaders are underdocumented. Some documentation is done in the class ref, it only picks up the properties of a visual shader node, such as the enum dropdowns, but not the inputs and outputs. There is also a page just for Visual Shaders, but it's underdeveloped.

So the place to fix this is either the Visual Shaders page, or the class reference, or both. I think that long-term the right way to document visual shader nodes would be an expanded page in the manual, not the class reference, with screenshots of each node and descriptions of the inputs and outputs. The class reference just can't automatically pick up all the information it needs. That's a much larger change, though.

Also, if you're looking for documentation about the various enum dropdowns, that is currently available in the parent class, VisualShaderNodeTextureParameter. Another limitation of the class ref is that properties are only documented on on a parent class, not child classes.

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

No branches or pull requests

2 participants