godotengine / godotengine/godot-docs

Merge Sections on Post-Processing/Screen-Reading Shaders

Open
#7,500 1 comment 1 reaction 0 assignees View on GitHub
area:manual content:organization enhancement topic:shaders
Dominant language
reStructuredText
Stars
5.7k
Forks
3.8k
Avg merge
1d 20h
Merged PRs (30d)
25

Description

**Your Godot version:**
4.0.3

**Issue description:**
The latest version of the Godot manual has three different sections on implementing post-processing shaders (linked below). Each of them introduces a different aspect (back-buffer copies, full-screen quad, full-screen canvas layer) and its benefits/drawbacks, but they never draw a full picture due to being partially outdated (e.g. the section "Screen-reading shaders" still suggests creating Viewports, which is not possible anymore), making it necessary to cross-reference a lot to understand a single one of them. This also makes it hard to tell which approach is most suitable for which context.

On top of that, two of the sections mentioned are named "Custom Post-Processing" and "Advanced Post-Processing". Personally I find this confusing, as those titles are almost synonymous despite describing two very different things.

I therefore propose that all three sections shall be merged into one that explains and compares the approaches in a more systematic way.

**URL to the documentation page (if already existing):**
https://docs.godotengine.org/en/latest/tutorials/shaders/screen-reading_shaders.html
https://docs.godotengine.org/en/latest/tutorials/shaders/advanced_postprocessing.html
https://docs.godotengine.org/en/latest/tutorials/shaders/custom_postprocessing.html

Contributor guide

No contributing guide indexed for this repository

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.