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:

  1. 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.
  2. Sky — skybox with a procedural sun disc/glow aligned to the directional light direction.
  3. 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.
  4. Transparent / additive — particles and sprites via the batched Renderer2D, depth-tested against the opaque scene.
  5. 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

LightTechniqueCast flag
DirectionalOrthographic shadow map (the scene uses the first caster)CastShadows = true (default)
SpotSingle perspective depth map from the spot's POVCastShadows (default off)
PointSix 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

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:

  1. 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.
  2. Niebo — skybox z proceduralną tarczą/poświatą słońca zgodną z kierunkiem światła kierunkowego.
  3. 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.
  4. Przezroczyste / addytywne — cząsteczki i sprite'y przez wsadowy Renderer2D, z testem głębi względem sceny nieprzezroczystej.
  5. 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łoTechnikaFlaga
KierunkoweOrtogonalna mapa cieni (scena używa pierwszego rzucającego)CastShadows = true (domyślnie)
StożkoweJedna perspektywiczna mapa głębi z punktu widzenia światłaCastShadows (domyślnie wył.)
PunktoweSześć ś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