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

Document writing shaders that work in multiple renderers #10204

Open
tetrapod00 opened this issue Nov 4, 2024 · 0 comments
Open

Document writing shaders that work in multiple renderers #10204

tetrapod00 opened this issue Nov 4, 2024 · 0 comments
Labels
area:manual Issues and PRs related to the Manual/Tutorials section of the documentation enhancement topic:shaders

Comments

@tetrapod00
Copy link
Contributor

Your Godot version:
4.4
Issue description:
Since godotengine/godot#97142 allowed falling back from Vulkan/D3D12/Metal to OpenGL, it is now more expected that rendering, including shaders, works on multiple renderers.

We should document writing shaders that work in multiple renderers, using OUTPUT_SRGB, CLIP_SPACE_FAR, and/or CURRENT_RENDERER (once godotengine/godot#98549 is merged).

This is currently half-documented in two places:

Changes to make:

  • Advanced postprocessing should include a snippet for using CLIP_SPACE_FAR to create correct NDCs for all renderers.
  • Possibly, some shader page should include a general section on writing shaders that work in all renderers. Possibly, the Renderers page should link to that shader section.

URL to the documentation page (if already existing):
https://docs.godotengine.org/en/latest/tutorials/migrating/upgrading_to_godot_4.html#updating-shaders
https://docs.godotengine.org/en/latest/tutorials/shaders/advanced_postprocessing.html

@Calinou Calinou added area:manual Issues and PRs related to the Manual/Tutorials section of the documentation topic:shaders labels Nov 11, 2024
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
area:manual Issues and PRs related to the Manual/Tutorials section of the documentation enhancement topic:shaders
Projects
None yet
Development

No branches or pull requests

2 participants