From b8d4a815453acac752c6fb3c56d047e39a76fd05 Mon Sep 17 00:00:00 2001 From: skal Date: Sat, 14 Feb 2026 19:05:34 +0100 Subject: feat(gpu): add SDF camera infrastructure and effect base class Add unified camera system for SDF raymarching effects: - CameraParams struct (80 bytes): inv_view matrix + FOV/near/far/aspect - SDFEffect base class: manages camera uniform, provides update_camera() helpers - camera_common.wgsl: getCameraRay(), position/forward/up/right extractors - SDFTestEffect: working example with orbiting camera + animated sphere Refactor effect headers: - Extract class definitions from demo_effects.h to individual .h files - Update includes in .cc files to use specific headers - Cleaner compilation dependencies, faster incremental builds Documentation: - Add SDF_EFFECT_GUIDE.md with complete workflow - Update ARCHITECTURE.md, UNIFORM_BUFFER_GUIDELINES.md - Update EFFECT_WORKFLOW.md, CONTRIBUTING.md Tests: 34/34 passing, SDFTestEffect validated Co-Authored-By: Claude Sonnet 4.5 --- doc/ARCHITECTURE.md | 26 ++++++++++++++++++++++++++ 1 file changed, 26 insertions(+) (limited to 'doc/ARCHITECTURE.md') diff --git a/doc/ARCHITECTURE.md b/doc/ARCHITECTURE.md index 4c36ec5..ebb2a59 100644 --- a/doc/ARCHITECTURE.md +++ b/doc/ARCHITECTURE.md @@ -4,6 +4,28 @@ Detailed system architecture for the 64k demo project. --- +## SDF Camera System + +**Purpose**: Unified camera infrastructure for SDF raymarching effects. + +**CameraParams** (80 bytes, `src/gpu/camera_params.h`): +- `inv_view`: mat4 (inverse view matrix for screen→world transform) +- `fov`, `near_plane`, `far_plane`, `aspect_ratio`: f32 (camera parameters) + +**SDFEffect Base Class** (`src/gpu/sdf_effect.h`): +- Manages `UniformBuffer` +- Provides `update_camera()` helper methods (from Camera object or manual values) +- Standard binding: 0=CommonUniforms, 1=CameraParams + +**WGSL Helpers** (`common/shaders/camera_common.wgsl`): +- `getCameraRay(cam, uv)`: Generate ray from screen UV coordinates +- `getCameraPosition/Forward/Up/Right()`: Extract camera vectors from inv_view +- Integrates with existing `render/raymarching.wgsl` (rayMarch, normal, shadow) + +**Usage**: Effects inherit from SDFEffect, update camera each frame, shader accesses camera uniforms for raymarching. + +--- + ## Hybrid 3D Renderer **Core Idea**: Uses standard rasterization to draw proxy hulls (boxes), then raymarches inside the fragment shader to find the exact SDF surface. @@ -18,6 +40,10 @@ Detailed system architecture for the 64k demo project. **Effect**: Abstract base for visual elements. Supports `compute` and `render` phases. +**PostProcessEffect**: Subclass for full-screen post-processing effects. + +**SDFEffect**: Subclass for SDF raymarching effects with camera management (see SDF Camera System below). + **Sequence**: Timeline of effects with start/end times defined in beats. **MainSequence**: Top-level coordinator and framebuffer manager. -- cgit v1.2.3