diff --git a/docs/layers.feature b/docs/layers.feature new file mode 100644 index 00000000..7942ebee --- /dev/null +++ b/docs/layers.feature @@ -0,0 +1,159 @@ +@spec +Feature: A render in layers: captions, text, graphics, footage and sound apart, for CapCut, Premiere, Resolve and raea's timeline + wackyza, 2026-11-16: "export a rendered video, in all its component layers (video, audio, graphics, all separate) to + Premiere, Resolve and Capcut ... keep graphics on one overlay track. Titles aka text elements should be their own + track. And captions, if applicable, should be their own track. I think this separation would be valuable for the + internal (in-app) timeline as well ... the best order of events might be to get the layers rendering really robust, + then be able to push it to the in-app timeline and all the ext editors". + + A cut finished in another editor needs its parts, not one flattened movie. `raea export capcut` (docs/capcut.feature) + already hands CapCut the footage and sounds as clips of their own files and everything raea draws as one + transparent overlay. This spec takes that split out of the CapCut export, makes it finer (captions and text apart + from the other graphics), proves it against the render, and gives it to every editor from one place: CapCut, + Premiere Pro and DaVinci Resolve, and the layout of raea's own timeline. + + What there is to build on (read 11-16): + - apps/capcut: the manifest's frames grouped into runs of footage and sound (plan.rs), the overlay rendered with + the footage hidden (RAEA_HIDE_MEDIA=1) and what's under it (RAEA_HIDE_MEDIA=under), written as a CapCut draft + (io/capcut). Its plan is written in CapCut's types, so no other editor can use it as it is. + - systems/layers: hide.rs hides layers by key (RAEA_HIDE_LAYERS) and the footage (RAEA_HIDE_MEDIA) as page CSS; + page.rs already calls an element whose children are all text "text", and footage "video". + - io/alpha: transparent movies without ffmpeg (CC1): ProRes 4444, HEVC with alpha, QuickTime Animation, PNG. + - sdk/timeline: tracks by kind (effect, text, overlay, main, sound, TL1a); the captions operation (TL7c) puts + lines on a track named Captions, and read.ts writes each line into the composition as a `text` op, the same op + a title is written with, so once in the code a caption and a title can't be told apart. + + The layers, top to bottom, and what each is: + | layer | what it holds | what the editor gets | + | captions | the words said, as raea draws them (CA1) | a transparent movie + an .srt beside | + | text | titles and other words on the picture that aren't captions | a transparent movie | + | graphics | everything else raea draws over the footage: shapes, 3D, FX | a transparent movie | + | footage | each