Scenes
Scenes are the visual sections of your video. Each scene gets its own background, transition, camera movement, and collection of elements.
Declaration
Scene "Opening"
The string after Scene names the scene. It appears in the RenderGraph and diagnostics but is not rendered on screen.
Duration
Specify duration in brackets after the title. If omitted, the compiler calculates duration from element timing and beats.
Scene "Quick" [3s]
Scene "Long" [1.5min]
Scene "Auto"
Calculated durations account for entrance animations, hold times (based on text length and reading speed), exit animations, and beats.
background
| Value | Effect |
|---|---|
dark |
Mood's primary background color |
light |
Mood's alternate lighter background |
accent |
Mood's accent color as background |
#FF0000 |
Any hex color |
video "clouds.mp4" |
Looping video background |
Default: dark
transition
How the scene enters from the previous scene.
| Transition | Effect |
|---|---|
cut |
Instant switch |
fade |
Crossfade |
dissolve |
Gradual blend |
push |
Slides in from side |
wipe |
Wipes across |
morph |
Shape-based morph |
Default: cut
camera
Subtle camera movement throughout the scene.
| Camera | Effect |
|---|---|
still |
No movement |
breathe |
Gentle scale oscillation with slight drift |
drift left |
Slow horizontal pan left |
drift right |
Slow horizontal pan right |
push-in |
Gradual zoom toward content |
pull-out |
Gradual zoom away |
Default: still
intent
Semantic hint that influences entrance animation and palette variation. See Intents for the full reference.
Scene "Revenue" intent: proof
layout
Arrange elements in a structured grid or split view. See Layouts.
Scene "Stats"
layout: grid 2x2
From Template
Instantiate a scene from a registered template:
Scene "Chapter 1" from chapter-card
title: "The Beginning"
subtitle: "Where it all started"
See Styles and Defines for template syntax.
Next Steps
- Content Elements — what appears inside scenes
- Layouts — grid and split arrangements
- Intents — semantic scene labels