Overview
This skill covers crafting seamless loop edits — clips that cut and loop without visible seams — using HyperFrames timing. Use it for background loops, ambient scenes, or transition-heavy sequences. It renders the looped MP4 deterministically.
HyperFrames — Seam Craft
Render-correctness doctrine for scene-to-scene seams: the prerequisites and master-timeline mechanics that make any transition composite correctly, independent of which specific transition is chosen.
When to Use
- User wants to assemble the master timeline / index.html
- User sees a white flash at a cut (especially on dark films)
- User wants to understand transition opacity dips
- User wants to verify render-side mechanics of overlapping scene wrappers
- User is working with Tier-B-ready transitions (transform/opacity/filter on clip wrappers)
When NOT to Use
Workflow
1 · Paint the stage ground
#root { background: var(--canvas-deep, var(--canvas, #000)); }
2 · Verify no same-track overlap
At each break boundary, the injector reassigns clip data-track-index as a 0/1 ping-pong. Verify no two overlapping wrappers share a track.
3 · Apply template placeholders
Substitute __OLD__, __NEW__, __T__, __DUR__, __DX__, __DY__ in each transition template.
4 · Verify with seam-gate
node scripts/seam-gate.mjs verify --ledger ledger.json --project .
Anti-Rationalization Table
- User wants the motion law (use
hyperframes-motion-doctrine) - User wants a full video workflow (use
hyperframes-product-launch-video)
Stage Ground Prerequisite (White-Flash Guard)
Several templates open a window where the two wrappers' summed opacity < 1 (the cut-the-curve mid-window cut, zoom-through's 0.15 floor, plain crossfade's power-curve dip). Whatever is BEHIND the wrappers shows through during that window. If #root has no opaque background, the renderer composites the dip over its default white page → a white flash at every seam.
The assembler must paint the stage:
#root { background: var(--canvas-deep, var(--canvas, #000)); }
How the Injector Applies a Transition
At a break boundary between scene i (from) and scene i+1 (to), the injector:
- Extends
#el-<from>wrapperdata-durationbyduration_s(holds its final frame) - Pulls
#el-<to>wrapperdata-startearlier byduration_s(creates the overlap window) - Reassigns all clip
data-track-indexas a 0/1 ping-pong so the two overlapping wrappers never share a track - Stamps the
gsap_templateintowindow.__timelines["main"]atT = overlap-start
Template Placeholders
| Token | Meaning |
|---|---|
__OLD__ |
"#el-<from>" — outgoing clip wrapper selector |
__NEW__ |
"#el-<to>" — incoming clip wrapper selector |
__T__ |
overlap-start time in seconds |
__DUR__ |
duration_s for this boundary |
__DX__ |
horizontal travel: -1920 (LEFT) / 1920 (RIGHT) |
__DY__ |
vertical travel: -1080 (UP) / 1080 (DOWN) |
Anti-Rationalization Table
| Rationalization | Reality |
|---|---|
| "I'll leave #root transparent" | White flash at every seam — paint the stage |
| "I'll let both wrappers share a track" | Same-track overlap is illegal — ping-pong reassignment |
| "I'll start the transition at the break" | Transition starts at overlap-start, not the break |
| "I'll use a unique transition per scene" | Budget is 2-3 per film — repetition creates cohesion |
Verification
-
#roothas opaque background - No same-track overlap between wrappers
- Template placeholders substituted correctly
-
seam-gate.mjs verifypasses with 0 fail - No white flashes on 3+ sampled frames at cuts