Skip to content

Spec: a render in layers for CapCut, Premiere, Resolve and raea's timeline (docs/layers.feature) - #166

Merged
shinyobjectz merged 1 commit into
shinyobjectz:mainfrom
wackyza:layers-spec
Nov 16, 2026
Merged

shinyobjectz merged 1 commit into
shinyobjectz:mainfrom
wackyza:layers-spec

Conversation

@wackyza

@wackyza wackyza commented Nov 16, 2026

Copy link
Copy Markdown

Spec only, no code: docs/layers.feature (LA1–LA7), for agreement before implementation.

What it proposes

Export a composition as separate layers, top to bottom:

layer what the editor gets
captions a styled transparent movie on its own track, plus an .srt beside it (not imported)
text a transparent movie: words with their own style, as Premiere/Resolve/CapCut define text
graphics a transparent movie: shapes, bars, 3D, effects
footage clips of the original files, referenced in place (CapCut still copies, CC2d)
under backgrounds beneath the footage; left out when all black
sound audio clips; footage's own sound linked to its clip, separable with each editor's own control
  • LA1: captions marked data-raea-role="caption", including those the captions operation (TL7c) writes; today they become text ops indistinguishable from titles.
  • LA2: one --alpha pass per non-empty layer, only on raea export. A normal render stays one pass (LA2o), and an export reuses an existing render of the same version as its reference.
  • LA3: the layers composited back must match the reference render; text covered by something drawn after it drops to graphics, and blend/backdrop effects stay with what they mix with, all reported.
  • LA4: one editor-neutral layers.json behind raea export layers; raea export capcut moves onto it, gaining captions and text tracks.
  • LA5: raea export premiere / raea export resolve via FCP7 XML (xmeml v5), verified by importing into both.
  • LA6: raea's timeline (raea-feed) puts captions, text and graphics on their own tracks when reading the code. No renders.
  • LA7: the delivery guide teaches it.

reference.mp4 goes into every export's folder, CapCut's draft included (a change from CC2d).

Proposed PR order

  1. This spec
  2. LA1 markers + LA2 passes
  3. LA3 check + LA4 layers.json / raea export layers
  4. CapCut on layers.json
  5. Premiere / Resolve export
  6. raea-feed: Export to menu entries and LA6

🤖 Generated with Claude Code

…nder, sound) for CapCut, Premiere, Resolve and raea's timeline

docs/layers.feature LA1-LA7: captions and text marked (data-raea-role), a transparent pass per layer only at export
(a render outside an export stays one pass), the layers composited back checked against the reference render, one
editor-neutral layers.json behind raea export layers, capcut, premiere and resolve (FCP7 XML), captions as a styled
movie with an .srt beside it, reference.mp4 in every export's folder, and raea's timeline laid out the same way.
Spec only; no code.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@shinyobjectz
shinyobjectz merged commit 1046ee9 into shinyobjectz:main Nov 16, 2026
4 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants