|
1 | | -# v0.3.0 — Phase 2: Shader Editing, Extended Export, CI Assertions |
| 1 | +# v0.3.0 — Phase 2-4: Shader Editing, Diff Engine, Pass Analysis |
2 | 2 |
|
3 | | -**Date:** 2026-04-01 |
| 3 | +**Date:** 2026-04-02 |
4 | 4 |
|
5 | 5 | ## Highlights |
6 | 6 |
|
7 | | -- **40 MCP tools** (13 new in Phase 2) |
8 | | -- Shader hot-editing: compile, replace, and restore shaders at runtime |
9 | | -- Mesh export: OBJ/JSON vertex data from draw calls |
10 | | -- Draw snapshots: export complete rendering state in one call |
11 | | -- Resource usage tracking: see how resources are used across events |
12 | | -- CI assertions: automated validation of pixel values, pipeline state, images, counts, and debug messages |
| 7 | +- **52 MCP tools** (25 new since v0.2.x) |
| 8 | +- Phase 2: Shader hot-editing, mesh/snapshot export, CI assertions (13 tools) |
| 9 | +- Phase 3: Dual-capture diff engine with 6 comparison modes (8 tools) |
| 10 | +- Phase 4: Pass-level analysis with dependency DAG and unused RT detection (4 tools) |
13 | 11 |
|
14 | | -## New Tools |
| 12 | +## Phase 2: Shader Editing, Extended Export, CI Assertions (13 tools) |
15 | 13 |
|
16 | 14 | ### Shader Hot-Editing |
17 | | -- `shader_encodings` — List supported shader compilation encodings |
18 | | -- `shader_build` — Compile shader source code |
19 | | -- `shader_replace` — Replace shader at event/stage |
20 | | -- `shader_restore` — Restore single shader |
21 | | -- `shader_restore_all` — Restore all shaders |
| 15 | +- `shader_encodings` / `shader_build` / `shader_replace` / `shader_restore` / `shader_restore_all` |
22 | 16 |
|
23 | 17 | ### Extended Export |
24 | | -- `export_mesh` — Export post-transform vertex data as OBJ or JSON |
25 | | -- `export_snapshot` — Export complete draw state (pipeline + shaders + render targets) |
26 | | -- `get_resource_usage` — Query resource usage across all events |
| 18 | +- `export_mesh` — OBJ/JSON vertex data |
| 19 | +- `export_snapshot` — Complete draw state bundle |
| 20 | +- `get_resource_usage` — Resource usage across events |
27 | 21 |
|
28 | 22 | ### CI Assertions |
29 | | -- `assert_pixel` — Validate pixel RGBA with tolerance |
30 | | -- `assert_state` — Validate pipeline state fields |
31 | | -- `assert_image` — Compare PNG images pixel-by-pixel |
32 | | -- `assert_count` — Validate resource/event/draw counts |
33 | | -- `assert_clean` — Validate no debug messages above severity |
| 23 | +- `assert_pixel` / `assert_state` / `assert_image` / `assert_count` / `assert_clean` |
| 24 | + |
| 25 | +## Phase 3: Diff Engine (8 tools) |
| 26 | + |
| 27 | +Dual-capture comparison with LCS-aligned draw matching: |
| 28 | +- `diff_open` / `diff_close` / `diff_summary` / `diff_draws` |
| 29 | +- `diff_resources` / `diff_stats` / `diff_pipeline` / `diff_framebuffer` |
| 30 | + |
| 31 | +**CLI:** `renderdoc-cli diff FILE_A FILE_B [--draws|--resources|--stats|--pipeline|--framebuffer]` |
| 32 | + |
| 33 | +## Phase 4: Pass-Level Analysis (4 tools) |
| 34 | + |
| 35 | +Hybrid pass enumeration (marker + synthetic gap-fill): |
| 36 | +- `get_pass_attachments` — Color/depth attachment query |
| 37 | +- `get_pass_statistics` — Per-pass draw/triangle/RT stats |
| 38 | +- `get_pass_deps` — Inter-pass resource dependency DAG |
| 39 | +- `find_unused_targets` — Dead render target detection with wave ranking |
| 40 | + |
| 41 | +**CLI:** `pass-stats` / `pass-deps` / `unused-targets` |
| 42 | + |
| 43 | +## Notes |
| 44 | +- Windows x64 only |
| 45 | +- Requires RenderDoc v1.43+ runtime (bundled in release packages) |
0 commit comments