Render Pipeline
Thread uses a forward renderer behind an API-agnostic RendererAPI /
RenderCommand layer, with backends for DirectX 11, DirectX 12 and
Vulkan (one shader language: HLSL, compiled to SPIR-V through DXC on Vulkan). The scene renders into an HDR off-screen target and is composited to the
screen through a fullscreen post-process pass.
Pass order
A frame of Scene::RenderScene runs, in order:
- Shadow pass — depth-only render from each shadow-casting light's POV into a shadow map (directional = ortho; spot = perspective; point = six faces packed into a 3×2 atlas). The scene publishes the sun's view-projection for god-rays.
- Sky — skybox with a procedural sun disc/glow aligned to the directional light direction.
- Opaque geometry — primitives, meshes (with GPU bone skinning when an AnimationComponent supplies bone matrices), terrain (per-chunk LOD), grass/scatter. Lit by the directional / point / spot / ambient lights and sampling the shadow maps.
- Transparent / additive — particles and sprites via the batched
Renderer2D, depth-tested against the opaque scene. - Post-process — one fullscreen pass: SSAO, volumetric fog + god-rays, SSR, colour grading, bloom, FXAA, vignette. See PostProcessComponent.
HDR & targets
The scene colour target is RGBA16F, so lights and emissive surfaces can push
values above 1.0. That headroom is what makes tonemapping and bloom behave — the post pass
reads this HDR buffer plus the scene depth (bound automatically when SSAO / fog / SSR need
it) and the sun shadow map (for god-rays).
Shadows
| Light | Technique | Cast flag |
|---|---|---|
| Directional | Orthographic shadow map (the scene uses the first caster) | CastShadows = true (default) |
| Spot | Single perspective depth map from the spot's POV | CastShadows (default off) |
| Point | Six 90° faces packed into one 3×2 atlas (no cube map) | CastShadows (default off) |
Every light exposes ShadowBias (fights acne) and ShadowSoftness
(penumbra radius in shadow-map texels; 0 = hard). Terrain both casts and receives.
Backends & a DX gotcha
The backends aim for parity. One recurring difference: in DirectX, a fullscreen pass
whose vertex shader maps uv=(0,0) to the bottom-left reads textures vertically
mirrored (D3D has v=0 at the top), while Load(pixel) is exact. Shaders that
Sample() the scene/depth in the post pass flip V where the backend needs it.
Symptom of getting it wrong: an effect that "slides with the camera" instead of sticking to
geometry.
Related
- PostProcessComponent — every post-process knob.
- MaterialComponent — PBR albedo/MR/normal, tiling.
- TerrainComponent, SpriteComponent, ParticleEmitterComponent.
Potok renderowania
Thread używa renderera forward za niezależną od API warstwą RendererAPI /
RenderCommand, z backendami DirectX 11, DirectX 12 i Vulkan (jeden język
shaderów: HLSL, kompilowany do SPIR-V przez DXC na Vulkanie). Scena renderuje się do pozaekranowego
celu HDR i trafia na ekran przez pełnoekranowy pass post-processingu.
Kolejność passów
Klatka Scene::RenderScene wykonuje po kolei:
- Pass cieni — render samej głębi z punktu widzenia każdego światła rzucającego cień do mapy cieni (kierunkowe = ortogonalnie; stożkowe = perspektywicznie; punktowe = sześć ścian w atlasie 3×2). Scena publikuje view-projection słońca na potrzeby god-rays.
- Niebo — skybox z proceduralną tarczą/poświatą słońca zgodną z kierunkiem światła kierunkowego.
- Geometria nieprzezroczysta — prymitywy, siatki (ze skinningiem kości na GPU, gdy AnimationComponent daje macierze kości), teren (LOD per fragment), trawa/scatter. Oświetlana światłami kierunkowymi / punktowymi / stożkowymi / otoczenia i próbkująca mapy cieni.
- Przezroczyste / addytywne — cząsteczki i sprite'y przez wsadowy
Renderer2D, z testem głębi względem sceny nieprzezroczystej. - Post-process — jeden pełnoekranowy pass: SSAO, mgła wolumetryczna + god-rays, SSR, korekcja kolorów, bloom, FXAA, winieta. Zob. PostProcessComponent.
HDR i cele renderowania
Cel koloru sceny to RGBA16F, więc światła i powierzchnie emisyjne mogą przekraczać
1.0. Ten zapas sprawia, że tonemapping i bloom działają — pass post-processingu czyta ten bufor HDR
oraz głębię sceny (podpinaną automatycznie, gdy potrzebują jej SSAO / mgła / SSR) i mapę cieni
słońca (dla god-rays).
Cienie
| Światło | Technika | Flaga |
|---|---|---|
| Kierunkowe | Ortogonalna mapa cieni (scena używa pierwszego rzucającego) | CastShadows = true (domyślnie) |
| Stożkowe | Jedna perspektywiczna mapa głębi z punktu widzenia światła | CastShadows (domyślnie wył.) |
| Punktowe | Sześć ścian 90° w jednym atlasie 3×2 (bez cubemapy) | CastShadows (domyślnie wył.) |
Każde światło ma ShadowBias (przeciw „shadow acne”) i ShadowSoftness
(promień półcienia w tekselach mapy cieni; 0 = ostry). Teren zarówno rzuca, jak i przyjmuje cienie.
Backendy i pułapka DX
Backendy dążą do zgodności. Jedna powracająca różnica: w DirectX pełnoekranowy pass, którego
vertex shader mapuje uv=(0,0) na lewy dolny róg, czyta tekstury odbite w pionie (D3D ma
v=0 na górze), podczas gdy Load(pixel) jest dokładne. Shadery, które w passie
post-processingu robią Sample() sceny/głębi, odwracają V tam, gdzie backend tego
wymaga. Objaw pomyłki: efekt, który „jedzie z kamerą”, zamiast trzymać się geometrii.
Powiązane
- PostProcessComponent — każde pokrętło post-processingu.
- MaterialComponent — albedo/MR/normalne PBR, tiling.
- TerrainComponent, SpriteComponent, ParticleEmitterComponent.