eng doc

docs/user/effects/README.md

@@ -0,0 +1,19 @@
+# Effects — user documentation
+
+The **post-process side**: everything that happens between the main pass and the screen.
+All effects are opt-in — a feature you don't enable costs nothing (no textures, no passes).
+
+| Page | Topic |
+|------|-------|
+| [HDR & tone mapping](hdr.md) | Offscreen float render + ACES/Reinhard, opt-in via `with_hdr` |
+| [Bloom](bloom.md) | Post-process glow: threshold → blur → composite |
+| [MSAA (anti-aliasing)](msaa.md) | Multi-sample edge smoothing, opt-in via `with_msaa(4)` |
+| [Fog (distance)](fog.md) | Distance fog (3 modes), masks world edges, opt-in via `with_fog()` |
+| [DoF (depth of field)](dof.md) | Cinematic bokeh blur, focus distance, opt-in via `with_dof()` |
+
+Example folder: [`lib/examples/effects/`](../../../lib/examples/effects/README.md)
+(`demo`, `bloom`, `hdr`, `msaa`, `fog`, `dof`).
+
+## Links
+
+- [User documentation index](../README.md) · [Quickstart](../quickstart.md) · [Examples](../examples.md)