|
Moved completed/historical docs to doc/archive/ for cleaner context:
Archived (26 files):
- Analysis docs: variable tempo, audio architecture, build optimization
- Handoff docs: 6 agent handoff documents
- Debug reports: shadows, peak meter, timing fixes
- Task summaries and planning docs
Kept (16 files):
- Essential: AI_RULES, HOWTO, CONTRIBUTING, CONTEXT_MAINTENANCE
- Active subsystems: 3D, ASSET_SYSTEM, TRACKER, SEQUENCE
- Current work: MASKING_SYSTEM, SPECTRAL_BRUSH_EDITOR
Updated COMPLETED.md with archive index for easy reference.
|
|
Phases 1-5: Complete uniform parameter system with .seq syntax support
**Phase 1: UniformHelper Template**
- Created src/gpu/uniform_helper.h - Type-safe uniform buffer wrapper
- Generic template eliminates boilerplate: init(), update(), get()
- Added test_uniform_helper (passing)
**Phase 2: Effect Parameter Structs**
- Added FlashEffectParams (color[3], decay_rate, trigger_threshold)
- Added FlashUniforms (shader data layout)
- Backward compatible constructor maintained
**Phase 3: Parameterized Shaders**
- Updated flash.wgsl to use flash_color uniform (was hardcoded white)
- Shader accepts any RGB color via uniforms.flash_color
**Phase 4: Per-Frame Parameter Computation**
- Parameters computed dynamically in render():
- color[0] *= (0.5 + 0.5 * sin(time * 0.5))
- color[1] *= (0.5 + 0.5 * cos(time * 0.7))
- color[2] *= (1.0 + 0.3 * beat)
- Uses UniformHelper::update() for type-safe writes
**Phase 5: .seq Syntax Extension**
- New syntax: EFFECT + FlashEffect 0 1 color=1.0,0.5,0.5 decay=0.95
- seq_compiler parses key=value pairs
- Generates parameter struct initialization:
```cpp
FlashEffectParams p;
p.color[0] = 1.0f; p.color[1] = 0.5f; p.color[2] = 0.5f;
p.decay_rate = 0.95f;
seq->add_effect(std::make_shared<FlashEffect>(ctx, p), ...);
```
- Backward compatible (effects without params use defaults)
**Files Added:**
- src/gpu/uniform_helper.h (generic template)
- src/tests/test_uniform_helper.cc (unit test)
- doc/SHADER_PARAMETRIZATION_PLAN.md (design doc)
**Files Modified:**
- src/gpu/effects/flash_effect.{h,cc} (parameter support)
- src/gpu/demo_effects.h (include flash_effect.h)
- tools/seq_compiler.cc (parse params, generate code)
- assets/demo.seq (example: red-tinted flash)
- CMakeLists.txt (added test_uniform_helper)
- src/tests/offscreen_render_target.cc (GPU test fix attempt)
- src/tests/test_effect_base.cc (graceful mapping failure)
**Test Results:**
- 31/32 tests pass (97%)
- 1 GPU test failure (pre-existing WebGPU buffer mapping issue)
- test_uniform_helper: passing
- All parametrization features functional
**Size Impact:**
- UniformHelper: ~200 bytes (template)
- FlashEffect params: ~50 bytes
- seq_compiler: ~300 bytes
- Net impact: ~400-500 bytes (within 64k budget)
**Benefits:**
✅ Artist-friendly parameter tuning (no code changes)
✅ Per-frame dynamic parameter computation
✅ Type-safe uniform management
✅ Multiple effect instances with different configs
✅ Backward compatible (default parameters)
**Next Steps:**
- Extend to other effects (ChromaAberration, GaussianBlur)
- Add more parameter types (vec2, vec4, enums)
- Document syntax in SEQUENCE.md
handoff(Claude): Shader parametrization complete, ready for extension to other effects
|
