Skip to content

Spec update: docs/layers.feature (captions split out, text stays in graphics, one raea export xml) - #167

Open
wackyza wants to merge 1 commit into
shinyobjectz:mainfrom
wackyza:layers-spec-v2
Open

wackyza wants to merge 1 commit into
shinyobjectz:mainfrom
wackyza:layers-spec-v2

Conversation

@wackyza

@wackyza wackyza commented Nov 17, 2026

Copy link
Copy Markdown

A heads-up on what's coming: an update to the layers spec merged in #166, after working through the implementation. Spec only, no code.

What changed

  • Text stays in the graphics layer. Splitting words from the graphics they're built into (kinetic type, words cut from a shape, a word behind a graphic) caused more problems than it solved. A separate text layer could come later as opt-in only (data-raea-role="text"), never guessed.
  • Captions are the only thing split out of graphics. They're marked with data-raea-role="caption", and nothing is guessed.
  • One raea export xml for Premiere and Resolve. An editor gets its own command only if testing shows it reads the XML differently.
  • Leaner:
    • Compositing the layers back together is a test of the method, not something every export runs.
    • An export always renders its own reference.
    • No raea check warning for unmarked captions.
    • No moving covered captions: captions always go on top.
  • What a prototype of the render passes showed:
    • The page keeps only the data-raea- props it names.
    • It draws nothing inside a hidden element, so the captions pass clears the elements that hold a caption instead of hiding them.
    • 3D is drawn by Bevy, which CSS can't hide, so the captions and under layers leave the 3D out of the scene and keep its cameras.

What follows

The implementation is being built and tested end to end on my fork first. It will come as a set of stacked PRs:

  1. Caption marker + RAEA_LAYER passes
  2. layers.json / raea export layers / SRT
  3. CapCut moved onto layers.json
  4. raea export xml

That way each one has been proven working with the others before you merge it.

🤖 Generated with Claude Code

…the only layer split out of it

docs/layers.feature after working through the implementation:
- Text is part of the graphics layer. Pulling words apart from the graphics they're built into (kinetic type, words
  cut from a shape, a word behind a graphic) caused more problems than it solved; a text layer may come later, opt-in
  only (an element marked data-raea-role="text"), never guessed.
- Captions are the only layer split from the graphics: marked data-raea-role="caption", nothing guessed.
- One `raea export xml` for Premiere and Resolve; a command of an editor's own only if testing finds it reads the XML
  differently.
- Leaner: the layers composited back is a test of the method, not run on every export; an export always renders its
  own reference; no `raea check` heuristic for unmarked captions; no moving covered captions (captions go on top).
- What rendering the passes taught: the page keeps only the data-raea- props it names, it draws nothing inside a
  hidden element (so the captions pass clears what holds a caption), and 3D is Bevy's, so a layer without it leaves
  the 3D out of the scene and keeps its cameras.

Spec only; no code.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
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.

1 participant