chore(conductor): Add new track 'Custom Shader and Window Frame Support'

This commit is contained in:
2026-03-09 21:37:57 -04:00
parent e3fd58a0c8
commit fe0f349c12
5 changed files with 87 additions and 3 deletions

View File

@@ -0,0 +1,35 @@
# Implementation Plan: Custom Shader and Window Frame Support
## Phase 1: Investigation & Architecture Prototyping
- [ ] Task: Investigate `imgui-bundle` and Dear PyGui capabilities for injecting raw custom shaders (OpenGL/D3D11) vs extending ImDrawList batching.
- [ ] Task: Investigate Python ecosystem capabilities for overloading OS window frames (e.g., `pywin32` for DWM vs ImGui borderless mode).
- [ ] Task: Draft architectural design document (`docs/guide_shaders_and_window.md`) detailing the chosen shader injection method and window frame overloading strategy.
- [ ] Task: Conductor - User Manual Verification 'Phase 1: Investigation & Architecture Prototyping' (Protocol in workflow.md)
## Phase 2: Custom OS Window Frame Implementation
- [ ] Task: Write Tests: Verify the application window launches with the custom frame/borderless mode active.
- [ ] Task: Implement: Integrate custom window framing logic into the main GUI loop (`src/gui_2.py` / Dear PyGui setup).
- [ ] Task: Write Tests: Verify standard window controls (minimize, maximize, close, drag) function correctly with the new frame.
- [ ] Task: Implement: Add custom title bar and window controls matching the application's theme.
- [ ] Task: Conductor - User Manual Verification 'Phase 2: Custom OS Window Frame Implementation' (Protocol in workflow.md)
## Phase 3: Core Shader Pipeline Integration
- [ ] Task: Write Tests: Verify the shader manager class initializes without errors and can load a basic shader program.
- [ ] Task: Implement: Create `src/shader_manager.py` (or extend `src/shaders.py`) to handle loading, compiling, and binding true GPU shaders or advanced Faux-Shaders.
- [ ] Task: Write Tests: Verify shader uniform data can be updated from Python dictionaries/TOML configurations.
- [ ] Task: Implement: Add support for uniform passing (time, resolution, mouse pos) to the shader pipeline.
- [ ] Task: Conductor - User Manual Verification 'Phase 3: Core Shader Pipeline Integration' (Protocol in workflow.md)
## Phase 4: Specific Shader Implementations (CRT, Post-Process, Backgrounds)
- [ ] Task: Write Tests: Verify background shader logic can render behind the main ImGui layer.
- [ ] Task: Implement: Add "Dynamic Background" shader implementation (e.g., animated noise/gradients).
- [ ] Task: Write Tests: Verify post-process shader logic can capture the ImGui output and apply an effect over it.
- [ ] Task: Implement: Add "CRT / Retro" (NERV theme) and general "Post-Processing" (bloom/blur) shaders.
- [ ] Task: Conductor - User Manual Verification 'Phase 4: Specific Shader Implementations' (Protocol in workflow.md)
## Phase 5: Configuration and Live Editor UI
- [ ] Task: Write Tests: Verify shader and window frame settings can be parsed from `config.toml`.
- [ ] Task: Implement: Update `src/theme.py` / `src/project_manager.py` to parse and apply shader/window configurations from TOML.
- [ ] Task: Write Tests: Verify the Live UI Editor panel renders and modifying its values updates the shader uniforms.
- [ ] Task: Implement: Create a "Live UI Editor" Dear PyGui/ImGui panel to tweak shader uniforms in real-time.
- [ ] Task: Conductor - User Manual Verification 'Phase 5: Configuration and Live Editor UI' (Protocol in workflow.md)