Novolis Docs
novolis-rendering / roadmap-raytracing.md

Roadmap — Materials, backends, and interchangeable display

dotnetgraphicsrenderingnovolis

Status: finished (v1 path-trace experiment closed). Shipped authoring → compile → progressive path trace → present, with CPU + ILGPU backends and host-swappable presentation. Remaining GPU Vulkan execution stays outside Rendering (Silk closed island).

Governance: library-boundaries.md. Design snapshot: design.md, materials-and-backends.md.


Exit checklist (done)

ItemResult
Phase 0 FoundationRepo, Abstractions, CI builds, boundaries
Phase 1 PresentationIFramePresenter + Presentation.Raylib; Silk blit via GAME compose
Phase 2 MaterialsStandard / Glass / Skin / Emissive → GpuMaterial
Phase 3 Scene + BVHSceneCompiler + Math TriangleBvh
Phase 4 CPU tracerProgressive samples; material branches; deterministic goldens
Phase 5 DIAddRayTracing / UseCpu / UseIlgpu / UseVulkan (shim)
Phase 6a ILGPUReal kernels + CPU fallback; parity test (deterministic)
Phase 6b Vulkan in RenderingIntentional CPU shim — label Vulkan (CPU shim — Silk.Compute owns real VK); Shaderc in Novolis.Silk.Compute
Phase 6c GL computeDeferred (optional; not required for v1 exit)
Phase 7 QualityNOV2005 bans Scene in Raylib; FramebufferGoldenAssert; pinned UnitCubeRoom SHA-256; Math BVH

Pinned golden (CPU deterministic): UnitCubeRoom, 32×24, samples 0+1, LookAt (1.2,0.8,2)→0, FOV 55° → e1f7c0113c5708b9d6e7aa177f8dd08e78b4897b429b2d2b2f3d3a144efcaa2f


Target architecture (shipped)

┌─────────────────────────────────────────────────────────────────┐
│  novolis-rendering (authoring + compile + backends)             │
│  Scene, Materials, SceneCompiler, CompiledScene                 │
│  IRayTracingBackend — Cpu / Ilgpu / Vulkan(CPU shim)            │
└────────────────────────────┬────────────────────────────────────┘
                             │ IRenderOutput (CPU pixels)
                             ▼
┌─────────────────────────────────────────────────────────────────┐
│  Presentation.Abstractions — IFramePresenter                      │
└──────────────┬──────────────────────────────┬───────────────────┘
               ▼                              ▼
   Presentation.Raylib                 GAME + Novolis.Silk
   (texture blit)                      (SilkFrame.Blit / Submit)

Non-negotiable: scene/materials stay in Rendering. Raylib and Silk never import Novolis.Rendering.Scene. Rendering never references Silk.NET (NOV2016).


Why Vulkan backend is a CPU shim

Silk.NET may only live in novolis-silk. A true Vulkan path tracer would either:

  1. Break the island (forbidden), or
  2. Live as GAME composition: Rendering produces CompiledScene / CPU frames; Novolis.Silk.Compute (GlslCompiler) owns SPIR-V; apps upload buffers.

VulkanRayTracingBackend preserves the IRayTracingBackend + lab “B / 1 / 2 / 3” cycle without lying about GPU execution. Prefer UseCpuBackend / UseIlgpuBackend for real work.


Labs

LabHost
RaytraceHelloRaylib presenter
SilkTraceHello / SilkTraceStudioSilk blit + backend switch
MeshBenchAvalonia + path-trace viewport
dotnet run --project d:\novolis\novolis-lab\labs\rendering\SilkTraceStudio\SilkTraceStudio.csproj -p:NovolisUseProjectReferences=true
dotnet test d:\novolis\novolis-rendering\tests\Novolis.Rendering.Unit\Novolis.Rendering.Unit.csproj -p:NovolisUseProjectReferences=true

Post-v1 (in progress / next)

Inspired by Sebastian Lague’s Ray-Tracing (throughput paths, RR, Fresnel glass, sky+sun, near-child BVH order):

  • GPU-first interactive path: Lague-style scatter on ILGPU + CPU parity
  • Glass on GPU (was missing → broken cubes in Studio)
  • Mesh vertex normals / multi-model local BVH
  • Debug vis modes (tri/box heatmaps)
  • Hardware RTX / full Vulkan RT in Silk.Compute + GAME upload
  • Texture atlas / OpenGL compute / production SSS

Explicitly deferred

  • Registry republish ceremony beyond normal merge.yml

Critical “do not” checklist

Do notWhy
Add Scene / IMaterial to Novolis.Raylib.*Scene is rendering domain
Reference Silk.NET from RenderingClosed Silk island (NOV2016)
Put Camera3D in renderingUse CameraSnapshot
Inherit SkinMaterial : StandardMaterialDifferent transport models
Reference Simulation from RenderingApps glue ViewPose → CameraSnapshot

Related