How lisyarus/webgpu-raytracer works
Core Components (Main Layer)
a) Window Management & Platform Integration
• SDL2 Window System
• WebGPU Surface Creation (via SDL_WGPU bridge)
• Platform-specific adaptations (Windows/Linux/MacOS)
b) Rendering Pipeline
• Preview Pipeline (Fast preview rendering)
• Raytracing Pipeline
• First Hit Pipeline
• Monte Carlo Pipeline (Main raytracing implementation)
• Compose Pipeline (Final image composition)
c) Scene Management
• GLTF Asset Loading
• BVH (Bounding Volume Hierarchy) System
• Scene Data Management
• Camera System
Resource Management Layer
a) Bind Groups (WebGPU Resource Organizations)
• Accumulation Bind Group
• Camera Bind Group
• Geometry Bind Group
• Material Bind Group
• Compose Uniforms Bind Group
b) Shader Management
• Shader Registry
• WGSL Shader Collection
• BRDF
• BVH Traverse
• Camera
• Material
• Environment Map
• etc.
Support Systems
• Profiler
• Timer
• Scene Data Structures (AABB, etc.)
Key Relationships to Highlight:
Data Flow
SDL Window → WebGPU Surface → Renderer → Pipelines → Final Output
Resource Management
Bind Groups ←→ Pipelines
Shader Registry → Pipelines
Scene Data → Geometry Bind Group
Raytracing Pipeline Detail
Scene BVH → Ray Intersection → Material Evaluation → Monte Carlo Integration
Special Considerations:
1. Multiple importance sampling system in the Monte Carlo pipeline, showing connections to:
• BRDF sampling
• Light sampling
• VNDF sampling
• Transmission sampling
BVH construction and traversal system, highlighting
• Initial construction at program start
• Runtime traversal during raytracing
• Surface area heuristic optimization
Material System
• Cook-Torrance GGX implementation
• Texture management (albedo, normal, material maps)
• VNDF normal distribution
Environment Integration
• HDRI environment maps
• Background system
• Environment sampling
• Environment map importance sampling
• Refraction support
• Wavefront path-tracing
• GLB support
This structure captures both the current implementation and future expansion possibilities while maintaining clarity about the system's core architecture.