Motion vocabulary · Energy builds
Energy flow chain
Node cards pop in; a pulse rides each connector and lights the next node on arrival; pulses keep flowing behind.
Live loop · 7 s · 1920×1080 at 24 fps
Parameters
| Parameter | Type | What it does |
|---|---|---|
| text / radius / tilt | string / px / ratio | ring: the line in its centre after it lights; its half width (560) and tilt (0.34) |
| items / result | string[] / string | converge: 3-6 parts that come together and what they become |
| nodes | [{label, icon?}] | flow: 3-5 nodes in order; icon "page", "chat", "play", "check", "bolt", "gear", "box", "dot" |
| step_ms | ms | flow: node to node; converge: the hold before the pull |
| ease | {"<move>": ease} | retune any named move (see the entry's moves): a preset name ("out-expo"), a cubic-bezier [x1, y1, x2, y2], {spring: [hz, damping]} or {trapezoid: [accel, decel]}. A wrong move name or curve throws, it never falls back. A move measured from a reference clip (the replica workbench's measure/*.json, frame-keyed) becomes a curve without conversion: MV.fitEase(doc, "x", {from: 133, to: 142}) or `motion-fit <file> --measure x --from 133 --to 142 --ease` |
| camera | {focal?, x?, y?, z?} | the scene's camera: pan x / y and push z as numbers or keyframes [[ms, value, ease?], ...]; objects at different depths move differently (real parallax). focal default 1800 |
| brand | hexDefault: #6B5BFF | the site's brand colour; the component derives its accent (>= 3:1 on the stage), surfaces and ink from it |
| stage | "dark" | "light"Default: "dark" | the stage the component sits on |
| display | font stemDefault: "Inter-Bold" | headline stem; name it in the call so the runtime loads it |
| body | font stemDefault: "Inter-Regular" | UI / body stem; name it in the call so the runtime loads it |
| start_ms | msDefault: 300 | when the component starts, ms into the shot |
| background | booleanDefault: false | draw the stage background (off: transparent over the shot's own stage) |
| place | {x, y, w, h, z?} | the component's place in the shot's layout: it fits its 1920x1080 composition into this stage rect (centred, aspect kept); z orders components front to back. Default: the whole stage |
Moves and their curves
Every move is eased on its own. Retune one with ease: { "<move>": <curve> }, a curve name or cubic-bezier handles.
| Move | Curve | What it does |
|---|---|---|
| card.pop | overshoot | each card popping in |
| card.activate | {"spring":[2.2,0.7]} | a card settling from 1.12x when it activates |
| wire.draw | out-cubic | the live connector drawing to the next card |
| pulse.ride | in-out-sine | a pulse riding a connector |
| slam.drop | in-quad | the last card's landing fall from 1.5x |
| slam.settle | in-out-sine | the last card's settle to 1x |
| goal.bloom | out-expo | the last card's bloom opening |
This demo
| variant | "flow" |
|---|---|
| nodes | [{"label":"Your page","icon":"page"},{"label":"Script","icon":"chat"},{"label":"Shots","icon":"play"},{"label":"Film","icon":"check"}] |
| brand | #2F9E6E |
| stage | light |
<script src="/vendor/motion-vocab.js"></script>
MV.bind("s3", MV.energy(el, {"variant":"flow","nodes":[{"label":"Your page","icon":"page"},{"label":"Script","icon":"chat"},{"label":"Shots","icon":"play"},{"label":"Film","icon":"check"}],"brand":"#2F9E6E","stage":"light","display":"Inter-Bold","body":"Inter-Regular"}));When to use it in a launch film
A pipeline the product runs: input, steps, output. Three to five nodes.
Why it works
Cause becomes visible: the next step lights exactly when the pulse arrives, so the order needs no words.
Do not combine with
- branching flows (one line only)
- more than five nodes
Job in the film
Natural length
4.5–7.0 s