Eve library

phase-168.md

Tracker

Revision 1

On this page

Historical task source. The Eve task board holds current task state.

Phase 168: Neith Engine Modern Global Illumination Pipeline — Godot SDFGI / Unreal Lumen / DDGI / NVIDIA RTXGI / UE Virtual Shadow Maps / Intel XeGTAO / Armory3D Irradiance Volumes Unified#

Closes the GI sovereignty gap. Phase 40.2.2 references GI. Phase 42.1.5 mentions Lumen. Phase 154 (EEVEE-class) plans probe-based GI. Godot's SDFGI is scattered across ~5 tasks. None deliver a unified modern dynamic GI pipeline where SDFGI, voxel GI, irradiance probes, ReSTIR-GI, and Lumen-style software / hardware ray-trace paths compose into a single render-graph selectable per project and per scene.

Sovereign replacement for Godot SDFGI, Unreal Lumen (software + hardware trace), NVIDIA DDGI / RTXGI + ReSTIR-GI + Real-Time Denoisers, Unity HDRP Enlighten / Progressive Lightmapper, CryEngine SVOGI, Armory3D Irradiance Volumes, UE Virtual Shadow Maps, Intel XeGTAO, AMD FidelityFX Brixelizer.


168.1 @neith/gi-core — GI Abstraction & Render Graph#

  • 168.1.1 Unified GI interface (diffuse / specular / shadows)
  • 168.1.2 Project-level GI profile selector
  • 168.1.3 Scene-level GI override
  • 168.1.4 Quality tier (ultra / high / med / low / mobile)
  • 168.1.5 Fallback chain (hw-RT → sw-RT → SDFGI → probes)
  • 168.1.6 Feature capability probing per GPU
  • 168.1.7 Per-pass enable / bypass
  • 168.1.8 Temporal accumulation buffer management
  • 168.1.9 Async compute dispatch
  • 168.1.10 Multi-GPU-aware distribution
  • 168.1.11 Frame-budget governor
  • 168.1.12 Integration with Phase 154 raster + Phase 138 path tracer
  • 168.1.13 Deterministic debug-capture (Phase 160 integration)
  • 168.1.14 Lighting debug overlay (direct / indirect / specular)
  • 168.1.15 Reference-mode (offline path trace ground truth)

168.2 @neith/gi-sdfgi — Signed Distance Field GI (Godot / Brixelizer-class)#

  • 168.2.1 Global SDF generation from scene meshes
  • 168.2.2 Cascaded SDF around camera (4–8 cascades)
  • 168.2.3 SDF update incremental per-frame
  • 168.2.4 SDF voxel colour / albedo bake
  • 168.2.5 SDF-based cone-trace for diffuse GI
  • 168.2.6 SDF reflection trace for specular
  • 168.2.7 Dynamic object inject into cascades
  • 168.2.8 Sky contribution through SDF traversal
  • 168.2.9 Temporal denoise of SDFGI output
  • 168.2.10 Screen-space first-hit fallback
  • 168.2.11 Adaptive cascade resolution
  • 168.2.12 SDF surface emission for emissive GI
  • 168.2.13 Occlusion probe hints
  • 168.2.14 Mobile-SDFGI low-profile variant
  • 168.2.15 Baked-SDF asset bundle for runtime start

168.3 @neith/gi-voxel — Voxel GI (SVOGI / VXGI-class)#

  • 168.3.1 Sparse voxel octree of scene
  • 168.3.2 Anisotropic voxel lighting
  • 168.3.3 Cone-trace lookup
  • 168.3.4 Voxel irradiance cache
  • 168.3.5 Per-direction occlusion
  • 168.3.6 Voxel emission injection
  • 168.3.7 Streaming voxel regions
  • 168.3.8 Refinement around camera
  • 168.3.9 Voxel per-light shadow
  • 168.3.10 Voxel denoiser

168.4 @neith/gi-probe — Irradiance + Reflection Probes#

  • 168.4.1 Spherical harmonics irradiance probe
  • 168.4.2 Cubemap reflection probe
  • 168.4.3 Planar reflection probe (mirrors / water)
  • 168.4.4 Probe auto-placement (manual + ML-suggested)
  • 168.4.5 Probe runtime update (dynamic light)
  • 168.4.6 Probe baking offline
  • 168.4.7 DDGI-style dynamic diffuse probe grid
  • 168.4.8 Probe LOD fall-off
  • 168.4.9 Blend between probes per pixel
  • 168.4.10 Probe relocation (avoid inside-geometry)
  • 168.4.11 Moving actor local probe (follow-camera)
  • 168.4.12 Probe visibility mask
  • 168.4.13 Probe attribute sampling UV
  • 168.4.14 Probe volume streaming
  • 168.4.15 Probe authoring tool

168.5 @neith/gi-lumen — Software + Hardware Ray-Trace GI (Lumen-class)#

  • 168.5.1 Surface cache (on-mesh GI)
  • 168.5.2 Screen-space + world-space tracing hybrid
  • 168.5.3 BVH acceleration structure builder
  • 168.5.4 Hardware ray-trace path (DXR / Vulkan RT / Metal RT)
  • 168.5.5 Software trace path for platforms without RT
  • 168.5.6 Final gather pass
  • 168.5.7 Radiance cache (per-light)
  • 168.5.8 ReSTIR-GI / ReSTIR-PT integration
  • 168.5.9 Screen-probe gather
  • 168.5.10 Cluster-based light culling
  • 168.5.11 Skylight importance sampling
  • 168.5.12 Emissive geometry sampling
  • 168.5.13 Denoiser (SVGF / OIDN / NRD-class)
  • 168.5.14 Sampling quality vs budget slider
  • 168.5.15 Transparent / translucent path

168.6 @neith/gi-shadow — Unified Shadow Pipeline#

  • 168.6.1 Virtual Shadow Maps (VSM) with page table
  • 168.6.2 Cascaded shadow maps (CSM) with soft transition
  • 168.6.3 Ray-traced shadows
  • 168.6.4 Contact shadows (screen-space)
  • 168.6.5 Stochastic soft shadow
  • 168.6.6 Hair / strand shadow (Phase 155)
  • 168.6.7 Translucent-material shadow with thickness
  • 168.6.8 Shadow LOD across distance
  • 168.6.9 Per-light shadow budget
  • 168.6.10 Shadow debug visualisation

168.7 @neith/gi-lightmap — Progressive / Baked Lightmapping#

  • 168.7.1 Path-traced lightmap baker
  • 168.7.2 Radiosity solver fallback
  • 168.7.3 GPU-accelerated bake
  • 168.7.4 Atlas packing & UV-chart gen
  • 168.7.5 Directional lightmap (NdotL + dominant direction)
  • 168.7.6 Mixed lighting (static + dynamic blend)
  • 168.7.7 Stationary light support
  • 168.7.8 Lightmap denoiser
  • 168.7.9 Lightmap retopology refresh
  • 168.7.10 Per-instance lightmap override

168.8 @neith/gi-ao — Ambient Occlusion#

  • 168.8.1 GTAO / HBAO+ / XeGTAO screen-space
  • 168.8.2 Bent normals for direction
  • 168.8.3 Ray-traced AO alternative
  • 168.8.4 Multi-bounce approximation
  • 168.8.5 AO contribution to indirect diffuse
  • 168.8.6 AO per-material override
  • 168.8.7 Thickness map alternative
  • 168.8.8 Capsule AO for characters
  • 168.8.9 Distance field AO
  • 168.8.10 Temporal filter

168.9 @neith/gi-volumetric — Volumetric Lighting#

  • 168.9.1 Froxel volume integrator
  • 168.9.2 Volumetric fog density field
  • 168.9.3 Volumetric shadows through participating media
  • 168.9.4 God-rays / light shafts
  • 168.9.5 Heterogeneous volume (VDB) runtime
  • 168.9.6 Volumetric clouds integration with sun
  • 168.9.7 Volumetric light groups
  • 168.9.8 Caustic approximation in volume
  • 168.9.9 Volumetric denoiser
  • 168.9.10 Temporal scatter

168.10 @neith/gi-emissive — Emissive Light Injection#

  • 168.10.1 Emissive mesh → light sampling
  • 168.10.2 Clustered light injection
  • 168.10.3 Emissive material contribution to GI
  • 168.10.4 Per-triangle area light sampling
  • 168.10.5 Moving emissive object update
  • 168.10.6 Importance sampling by luminance
  • 168.10.7 Emissive LOD cutoff
  • 168.10.8 Emissive-only-no-GI override
  • 168.10.9 HDR bloom feed
  • 168.10.10 Sprite / VFX emissive (Phase 161)

168.11 @neith/gi-sky — Sky + Atmosphere + Time-of-Day#

  • 168.11.1 Physically-based sky (Bruneton)
  • 168.11.2 Procedural sun + moon + stars
  • 168.11.3 Weather driving sky
  • 168.11.4 Sky convolved to cubemap at runtime
  • 168.11.5 Sky contribution to GI chain
  • 168.11.6 Horizon occlusion
  • 168.11.7 Dynamic cloud shadowing
  • 168.11.8 Aerial perspective / Mie / Rayleigh
  • 168.11.9 Eclipse / aurora / custom celestial
  • 168.11.10 Time-of-day animation timeline

168.12 Testing & Validation#

  • 168.12.1 Reference-vs-realtime RMSE on test scenes
  • 168.12.2 Temporal stability / ghost-free
  • 168.12.3 Shadow occlusion correctness test corpus
  • 168.12.4 GI stability on moving objects
  • 168.12.5 Cross-GPU parity (NVIDIA / AMD / Intel / Apple) — the fail-closed evidence grading and gi-validate parity operator path are complete; the residual is matched live captures on all four vendors. The fleet has only an Apple GPU (the Mac); NVIDIA, AMD and Intel GPUs are absent, so a four-vendor parity capture cannot be produced (stated 2026-09-18). blocked:hardware
  • 168.12.6 Mobile profile 60 FPS target — the sustained frame-time grader and gi-validate mobile path are complete; the residual is a live target mobile SoC capture. Needs a target mobile phone/SoC; the fleet has none (stated 2026-09-18). blocked:hardware
  • 168.12.7 Console profile 60 FPS + 4K — the 4K frame-time grader and gi-validate console path are complete; the residual is a live target console capture. Needs a console devkit; the fleet has none (stated 2026-09-18). blocked:hardware
  • 168.12.8 Path-traced reference agreement
  • 168.12.9 Memory budget per GI profile
  • 168.12.10 Dogfood: Phase 79 open-world + Phase 163 VP LED wall — the milestone/artifact grader and gi-validate dogfood path are complete; the residual is an identified live run. Needs the physical Phase 163 virtual-production LED wall (and a shipping open-world build) to capture against; the fleet has neither (stated 2026-09-18). blocked:hardware