Reference
Transitions
Transition kinds between scenes — cut, crossfade, fade_color, wipe, and slide.
Transitions smooth the cut between scenes. Set a default in the
manifest, or call
s.transition(kind, duration, [r, g, b]) inside a scene. Scene transitions
accept raw frames or helpers like ms(600).
[transition]
kind = "crossfade"
frames = 18s.transition("fade_color", ms(800), 0.03, 0.04, 0.08); // dark navy, channels 0..1Kinds
| Kind | Aliases | Description |
|---|---|---|
cut | — | Instant change, no blend. |
crossfade | dissolve, fade | Blend the outgoing and incoming scenes. |
fade_color | dip, fade_through | Dip to a solid color, then up into the next scene. |
wipe_left | — | New scene wipes in from the right toward the left. |
wipe_right | — | Wipe in from the left toward the right. |
wipe_up | — | Wipe in from the bottom upward. |
wipe_down | — | Wipe in from the top downward. |
slide_left | push_left | New scene pushes the old one to the left. |
slide_right | push_right | Pushes to the right. |
slide_up | push_up | Pushes upward. |
slide_down | push_down | Pushes downward. |
Parameters
| Parameter | Description |
|---|---|
kind | One of the kinds above. |
frames | Duration of the transition, as raw frames or ms(...) / sec(...). |
r, g, b | Color for fade_color, with channels in 0..1 (defaults to black). |
Choosing a transition
crossfadeis the safe documentary default.fade_colormarks a chapter break — dip to the project background.slide_*implies spatial continuation (e.g. moving along a pipeline).wipe_*is bolder; use sparingly.
In the example project, all 17 scenes are joined with an 18-frame crossfade,
which is the same as ms(600) at 30 fps.