Skip to content

The truly free, open-source, local-first, cross-platform CapCut replacement. Scriptable through a JSON-RPC API & MCP.

Create ARCHITECTURE-TODO.md

Jareerdc3fd081878f
diff --git a/ARCHITECTURE-TODO.md b/ARCHITECTURE-TODO.md
new file mode 100644
index 00000000..3c90858f
--- /dev/null
+++ b/ARCHITECTURE-TODO.md
@@ -0,0 +1,27 @@
+# Architecture: left for later
+
+What the 16 September architecture proposal ticked off with a note that
+part of it waits. The proposal itself is gone; `ARCHITECTURE.md` describes
+the tree as it is, and this is the list of what it does not yet do. Each
+item names where the seam is, so the next person starts at the file and
+not at the history.
+
+- [ ] **GPU-texture pooling of cached frames.** The source-frame cache
+ (`concat-host/src/pool.rs`) hands out CPU frames; a frame that goes to the
+ wgpu compositor is uploaded again each time it is drawn. Pool the textures
+ beside the frames now that both compositors read one `FramePlan`.
+- [ ] **Zero-copy hardware decode.** VideoToolbox frames
+ (`concat-media/src/hardware.rs`) are copied out to system memory and back
+ up to the GPU. An IOSurface handed straight to wgpu skips both copies; the
+ seam is the decoder's output frame and the compositor's texture upload.
+- [ ] **Crop, flips and transition fades filled by the export.** `FramePlan`
+ carries all three, the parity tests fill them, and the compositors honour
+ them - but the export path still bakes them into the decoder's filter
+ chain (`concat-export/src/resolve.rs`, `concat-media` filter graph). Fill
+ the plan from the export and take them out of the chain.
+- [ ] **Timeline drawing at 2 ms.** Clips are virtualised
+ (`TimelinePane::published_span`), but filmstrips and waveforms are still
+ one image and one path per clip; the design is one texture per track per
+ zoom level. The Slint repaint itself has not been measured
+ (`SLINT_DEBUG_PERFORMANCE` needs the window), so the target is not yet
+ shown either way.