Update to Picsart
Snapshot Nov 7, 2026 · 00:09 UTC · version 2.4.0
Collection source: downloaded plugin package.
Instructions updated for motion-pattern-library
Full description — Now says: drawn strokes, and cartoon fast motion (smears, multiples, speed lines).
Observed in instructions or declared skills. Runtime behavior has not been tested.
Up to 3 plugins free · no card required.
All fields and original values.
Full description
Nov 3, 2026 · 18:14 UTC
and drawn strokes.
Nov 7, 2026 · 00:09 UTC
drawn strokes, and cartoon fast motion (smears, multiples, speed lines).
Skill instructions
Nov 3, 2026 · 18:14 UTC
and drawn strokes. Use when the motion intent is known and you need supported scene properties and keyframe structures to adapt; values are starting points, not universal timing rules. version: '1.5'
Nov 7, 2026 · 00:09 UTC
drawn strokes, and cartoon fast motion (smears, multiples, speed lines). Use when the motion intent is known and you need supported scene properties and keyframe structures to adapt; values are starting points, not universal timing rules...
Supporting files
Nov 3, 2026 · 18:14 UTC
[{"relative_path":"references/depth-from-one-camera.md","size_in_bytes":3928},{"relative_path":"references/focus-flip-and-wipe.md","size_in_bytes":4835},{"relative_path":"references/validation-by-pattern.md","size_in_bytes":22169}]
Nov 7, 2026 · 00:09 UTC
[{"relative_path":"references/cartoon-fast-motion.md","size_in_bytes":3572},{"relative_path":"references/depth-from-one-camera.md","size_in_bytes":3928},{"relative_path":"references/focus-flip-and-wipe.md","size_in_bytes":5033},{"relativ...
Compare saved observations
Download comparison JSONSKILL.md text changes
− removed · + added
--- before +++ after @@ -1,9 +1,10 @@ --- name: motion-pattern-library -description: Worked scene motion patterns for entrances, exits, stagger, directional nudges, emphasis, ambient life, springs, arcs, layered beats, parenting, parallax, focus, wipes, and drawn strokes. Use when the motion intent is known and you need supported scene properties and keyframe structures to adapt; values are starting points, not universal timing rules. +description: Worked scene motion patterns for entrances, exits, stagger, directional nudges, emphasis, ambient life, springs, arcs, layered beats, parenting, parallax, focus, wipes, drawn strokes, and cartoon fast motion (smears, multiples, speed lines). Use when the motion intent is known and you need supported scene properties and keyframe structures to adapt; values are starting points, not universal timing rules. metadata: category: authoring - version: '1.5' + version: '1.6' + ported-from: motion-patterns 1.6 at 55.104.0 --- # Worked beats @@ -123,6 +124,9 @@ The exponential damps the amplitude; the cosine controls oscillation frequency. Check extrema and the settled tail, not only endpoints. Confirm the expression's clock when the layer starts late. +A part that lags ANOTHER part's motion (hair behind a turning head) is not this: apply the +`follow_through` preset to a parameter (`picsart_scene_recipe scene-animation-reference`, "Secondary motion and characters"). + ## Ambient life Background motion that keeps looping while the beat lasts: @@ -139,6 +143,29 @@ For text, inspect the available ambient text-animation presets; caption decorations and ordinary text layers have different authoring entry points (`scene-animation-reference`). +## Confetti, sparks and snow + +Many small copies of one thing, thrown and falling, are one layer with `particles`, not hand-copied +layers. The layer's `content` is the particle; its `transform.position` places the emitter: + +```json +{ "id": "confetti", "transform": { "position": [540, 1080] }, + "content": { "kind": "shape", "items": [{ "type": "rect", "size": [22, 12] }, { "type": "fill", "color": "#ff3b6b" }] }, + "particles": { "seed": 1, "emit": { "bursts": [{ "time": 0, "count": 120 }] }, + "life": [2, 3.2], "direction": -90, "spread": 40, "speed": [1100, 2300], "gravity": [0, 1500], + "spin": [-450, 450], "opacityOverLife": [1, 0.3] } } +``` + +Every particle draws the layer's content, so several colours are several such layers, each with its +own colour and `seed`. Each burst releases `count` particles at its `time`; a stream is +`"emit": { "rate": 40 }`, which emits until the layer ends (or for its `"duration"`), and a negative +`start` has it already running at the layer's first frame. Snow streams from a wide +`"origin": { "shape": "line", "size": [1400, 1] }` on a layer placed above the frame, with +`"direction": 90`, a small `"spread": 30` and little `gravity`: a directed throw needs a small spread, +since the default 360 throws every way. Two layers with different particle sizes, speeds and +opacities read as depth. Change `seed` for another throw of the same effect; the same seed always +draws the same frames. + ## An arc instead of a straight line Tangents bow the path; easing still shapes the timing along it: @@ -455,3 +482,14 @@ fill lands on top). `ease_in_out` reads hand-drawn; `linear` reads mechanical, right for a progress bar. This lives at the shape-`items` level, which layer presets don't reach, so it is a pattern rather than a preset. Preview the start, partial stroke and completion; verify the intended path direction. + +An ink line that writes on — a signature, a doodle, a character's outline — is the same trim track with a +tapered stroke (`character-rigging`, "Ink lines"). The taper is laid along the drawn part, so the moving +end keeps its point as it writes on. + +## Cartoon fast motion: smears, multiples and speed lines + +A dash, a fast wave or a zip exit reads as a cartoon when its fast frames are drawn differently. The +`smear`, `multiple` and `speed_lines` motion presets read the layer's real motion and draw only above a +speed threshold, along the motion. Which layer each goes on, frame counts, the exit zip and how they +combine with motion blur are in [references/cartoon-fast-motion.md](references/cartoon-fast-motion.md).
Full technical diff · 3 changed fields
changed /description
"Worked scene motion patterns for entrances, exits, stagger, directional nudges, emphasis, ambient life, springs, arcs, layered beats, parenting, parallax, focus, wipes, and drawn strokes. Use when the motion intent is known and you need supported scene properties and keyframe structures to adapt; values are starting points, not universal timing rules."
"Worked scene motion patterns for entrances, exits, stagger, directional nudges, emphasis, ambient life, springs, arcs, layered beats, parenting, parallax, focus, wipes, drawn strokes, and cartoon fast motion (smears, multiples, speed lines). Use when the motion intent is known and you need supported scene properties and keyframe structures to adapt; values are starting points, not universal timing rules."
changed /included_files
[
{
"relative_path": "references/depth-from-one-camera.md",
"size_in_bytes": 3928
},
{
"relative_path": "references/focus-flip-and-wipe.md",
"size_in_bytes": 4835
},
{
"relative_path": "references/validation-by-pattern.md",
"size_in_bytes": 22169
}
][
{
"relative_path": "references/cartoon-fast-motion.md",
"size_in_bytes": 3572
},
{
"relative_path": "references/depth-from-one-camera.md",
"size_in_bytes": 3928
},
{
"relative_path": "references/focus-flip-and-wipe.md",
"size_in_bytes": 5033
},
{
"relative_path": "references/validation-by-pattern.md",
"size_in_bytes": 22169
}
]changed /skill_md_contents
"---\nname: motion-pattern-library\ndescription: Worked scene motion patterns for entrances, exits, stagger, directional nudges, emphasis, ambient life, springs, arcs, layered beats, parenting, parallax, focus, wipes, and drawn strokes. Use when the motion intent is known and you need supported scene properties and keyframe structures to adapt; values are starting points, not universal timing rules.\nmetadata:\n category: authoring\n version: '1.5'\n---\n\n# Worked beats\n\nChoose a construction for the intended beat, adapt it to the scene, then check the result.\nThe snippets are fragments, not complete scenes or ready-to-run MCP calls; `…` marks omitted input.\nTimes, distances and amplitudes are starting choices, not quality guarantees. Use `picsart_scene_validate`\nfor structure, `picsart_scene_query_layout` / `picsart_scene_lint_layout` for declared geometry, and `picsart_scene_contact_sheet` with explicit `times` and `resolution` equal to the composition dimensions\nplus continuous playback to judge the motion. Fetch current preset/look parameters before applying one.\n\nBefore adapting **any pattern below**, read\n[Validation by pattern](references/validation-by-pattern.md). Select its row, declare the intended\noutcome and tolerance, and retain its measurement and visual checks in the beat's acceptance plan.\nFetch it through MCP with `picsart_scene_recipe` using `name: \"motion-pattern-library\"` and\n`reference: \"references/validation-by-pattern.md\"`. A successful render or schema check alone is\nnot motion acceptance; report measured, visually inspected, and unchecked outcomes separately.\n\nDecisions behind these — which beat, which register, how long — are\n`picsart_scene_recipe motion-intent`. The fields themselves are\n`picsart_scene_recipe scene-animation-reference`. For whole-sequence relationships, visual carriers, intentional\nresets, and seam choice, start with `picsart_scene_recipe motion-scene-continuity`. This is the middle: shapes\nthat work.\n\n## Entrance, and the exit that answers it\n\nA useful pacing trial is an exit around 65–75% of its entrance. This is a motion heuristic, not an\nscene rule. Pick the form by what happens next:\na **motion preset** when the keyframes will be edited afterwards (by the agent or in the editor), a\n**look** when the motion should stay a named, swappable entry for the editor.\n\nAs a look, both halves are one look played at either end of the layer by `role`:\n\n```json\n{ \"scene\": …, \"layerId\": \"card\", \"preset\": \"look:zoom\", \"params\": { \"role\": \"in\", \"length\": 0.5, \"scale\": 0.9 } }\n{ \"scene\": …, \"layerId\": \"card\", \"preset\": \"look:zoom\", \"params\": { \"role\": \"out\", \"length\": 0.35, \"scale\": 0.9 } }\n```\n\nEach call appends one `looks[]` entry, so the document keeps both by name and an editor can show and\nswap them. `role: in` starts at the layer's start; `role: out` ends exactly at its end, however the\nlayer is later trimmed.\n\nAs motion presets, `picsart_scene_apply_preset` with `motionPreset:<id>` (iOS `applyMotionPreset`) expands each into ordinary\nkeyframes you then own:\n\n```json\n{ \"scene\": …, \"layerId\": \"card\", \"preset\": \"motionPreset:zoom_in\", \"params\": { \"duration\": 0.5, \"from\": 0.9 } }\n{ \"scene\": …, \"layerId\": \"card\", \"preset\": \"motionPreset:zoom_out\", \"params\": { \"duration\": 0.35, \"to\": 0.9 } }\n```\n\nCheck start, midpoint and end bounds: the size should change around the intended pivot, with no\nunintended center drift. Check the exit against the layer's actual end after trimming.\n\nThe motion looks at a glance, so a substitution is an informed one (`picsart_scene_capabilities`\n`look:<id>` has every param):\n\n| Look | What it does |\n|---|---|\n| `fade` (`in` / `out`) | opacity only; nothing moves |\n| `slide` (`in` / `out`) | travels `distance` multiples of its own size along `direction`, `up` by default |\n| `zoom` (`in` / `out`) | grows from, or shrinks to, `scale` of its own size |\n| `spin` (`in` / `out`) | turns through `angle` while scaling from `scale`; `scale: 1` turns without scaling |\n| `wipe` (`in` / `out`) | a hard edge uncovers or covers it along `direction` |\n| `blur` (`in` / `out`) | focus pull: `gaussian_blur` from, or to, `amount` |\n| `flip` (`in` / `out`) | turns edge-on through `angle` about `axis` (`y`, or `x`) in perspective |\n| `pop` (`in`) | overshoots to `overshoot` and settles |\n| `float`, `sway`, `shake`, `pulse` | loops for the layer's whole length |\n| `glow_pulse` | a blurred copy screened over the layer swells and fades each `period` |\n| `ken_burns` | zooms or pans the picture inside a fixed frame; `media` / `scene_ref` only |\n\n`fade` on a motion look blends its motion toward the layer's rest: `fade: 0.5` slides half the\ndistance, `fade: 0` leaves the layer where it stands, and a keyframed fade ramps the motion in.\n\nA look plays over its whole layer unless the entry names a window — `start` (on the layer's clock)\nand `duration`: `{ \"look\": \"shake\", \"start\": 1.2, \"duration\": 0.4 }` shakes for 0.4s and rests\naround it. An entrance inside a window starts at the window's start and holds its start before it;\nan exit ends at the window's end and holds there after it.\n\nPreset behaviour at a glance (`picsart_scene_capabilities` with `sections: [\"motionPresets\"]` lists preset parameters):\n\n| Preset | Construction to inspect |\n|---|---|\n| `fade_in` / `fade_out` | opacity only; nothing moves |\n| `slide_in` | directional arrival; inspect the selected direction and travel |\n| `slide_out` | directional departure; inspect the final visible frame |\n| `zoom_in` | scales from `from` toward rest |\n| `zoom_out` | scales from rest toward `to` |\n| `scale_pop` | inspect the peak and settling; do not assume an entrance from small to large |\n| `glow_pulse` | continuous pulse, does not resolve |\n| `ken_burns` | `media` / `scene_ref` only |\n\nA one-shot beat at a chosen moment — `spring`, `tap_pulse`, `scale_pop` — is a preset only: looks\nhold entrances, exits and loops.\n\n## A settle with overshoot\n\nOne segment, no third keyframe — the curve carries it:\n\n```json\n\"scale\": { \"keyframes\": [\n { \"time\": 0.0, \"value\": [0.8, 0.8],\n \"easing\": { \"kind\": \"cubic_bezier\", \"control\": [0.175, 0.885, 0.32, 1.275] } },\n { \"time\": 0.45, \"value\": [1.0, 1.0] }\n] }\n```\n\nThe `y2` control ordinate influences overshoot but is not the rendered overshoot percentage.\nSample the track through its peak and landing; judge the peak against this element's size and role.\n\n## A real spring\n\nWhen one overshoot is not enough — a damped oscillation as a single expression:\n\n```json\n\"scale\": { \"expression\": \"return value * (1 + 0.35 * math.exp(-6*time) * math.cos(18*time))\" }\n```\n\nThe exponential damps the amplitude; the cosine controls oscillation frequency. Check extrema and\nthe settled tail, not only endpoints. Confirm the expression's clock when the layer starts late.\n\n## Ambient life\n\nBackground motion that keeps looping while the beat lasts:\n\n```json\n\"scale\": { \"expression\": \"return value * (1 + 0.02 * math.sin(2*math.pi*time/4))\" }\n```\n\nThe `0.02` coefficient varies the base scale by ±2%. Keeping ambient amplitude below the leader is a motion\nheuristic; leaving the background still is also valid.\nThe literal `4` is a four-second period: changing the beat's duration does not retime it. Change the\nperiod explicitly if the intended number of cycles must stay fixed, then recheck the loop and ending.\n\nFor text, inspect the available ambient text-animation presets; caption decorations and ordinary\ntext layers have different authoring entry points (`scene-animation-reference`).\n\n## An arc instead of a straight line\n\nTangents bow the path; easing still shapes the timing along it:\n\n```json\n\"position\": { \"keyframes\": [\n { \"time\": 0, \"value\": [200, 540], \"easing\": \"ease_in_out\", \"outTangent\": [120, -160] },\n { \"time\": 1.6, \"value\": [880, 540], \"inTangent\": [-120, -160] }\n] }\n```\n\nInspect the swept path for collisions and unintended depth crossings. The handles bow this path;\nwithout them the same two keyframes describe a straight line.\n\n## Two motion layers on one element\n\nPrimary and ambient as separate components, so each stays re-timeable:\n\n```json\n\"transforms\": [\n { \"id\": \"entrance\", \"animations\": { \"translation\": { \"keyframes\": [\n { \"time\": 0, \"value\": [0, 200], \"easing\": \"ease_out\" }, { \"time\": 0.6, \"value\": [0, 0] } ] } } },\n { \"id\": \"breathe\", \"animations\": { \"scale\": {\n \"expression\": \"return value * (1 + 0.12 * math.sin(2*math.pi*time/1.5))\" } } }\n]\n```\n\nCheck that the entrance lands at its intended time while the ambient track continues independently.\nThe 12% amplitude here demonstrates separation, not a recommendation for subtle background motion.\n\n## A whole beat in one register\n\nBrief: *\"clean, professional quarterly review card\"*. Try a restrained timing palette, then judge it\nagainst reading time and the actual layout. Four roles, each entering when its context justifies it:\n\n| Layer | Starts | Motion |\n|---|---|---|\n| background | 0 | 2% breathe expression — least motion in the frame |\n| card | 0.2 | `position` 600 → 520 with a co-terminous opacity fade, 0.5s `ease_out` |\n| headline | 0.8 | `slide_up_lines` 0.5s — a build, after its context |\n| CTA | 2.0 | scale 0.9 → 1.0; inspect any easing overshoot instead of deriving it from a control ordinate |\n\nPreview the entrance order and readable holds. If the background competes with the headline or the\nCTA arrives before its context is understood, reduce competing motion or retime the beat.\n\n## Staggering a row\n\nPer-item delay inside a `$each` body, using the loop index:\n\n```json\n{ \"$each\": \"tiles\", \"as\": \"tile\", \"body\": {\n \"id\": \"tile\",\n \"animations\": { \"opacity\": { \"keyframes\": [\n { \"time\": { \"$eval\": \"tile.@index * 0.08\" }, \"value\": 0 },\n { \"time\": { \"$eval\": \"tile.@index * 0.08 + 0.2\" }, \"value\": 1 } ] } } } }\n```\n\nA compact stagger is a starting trial; adjust the spread to the reading order. Resolve the\ntemplate first (`picsart_scene_apply_template` with `mode='bootstrap'`) — the tools refuse a stray\n`$each` by name.\n\n## A cascading spatial entrance\n\n**Intent.** Reveal a reading order without turning every item into a separate hero. The first item\nleads; later siblings repeat the same relationship with a compact delay.\n\n**scene translation.** Give each sibling the same position-plus-opacity arrival, offsetting its\nkeyframe times. The opacity and position tracks below end together, so each sibling reads as one\narrival. These are fragments for three ordinary layers, not a named preset:\n\n```json\n{ \"id\": \"item-a\", \"animations\": {\n \"position\": { \"keyframes\": [\n { \"time\": 0.00, \"value\": [540, 680], \"easing\": \"ease_out\" },\n { \"time\": 0.50, \"value\": [540, 600] } ] },\n \"opacity\": { \"keyframes\": [\n { \"time\": 0.00, \"value\": 0, \"easing\": \"ease_out\" },\n { \"time\": 0.50, \"value\": 1 } ] } } }\n{ \"id\": \"item-b\", \"animations\": {\n \"position\": { \"keyframes\": [\n { \"time\": 0.08, \"value\": [540, 880], \"easing\": \"ease_out\" },\n { \"time\": 0.58, \"value\": [540, 800] } ] },\n \"opacity\": { \"keyframes\": [\n { \"time\": 0.08, \"value\": 0, \"easing\": \"ease_out\" },\n { \"time\": 0.58, \"value\": 1 } ] } } }\n{ \"id\": \"item-c\", \"animations\": {\n \"position\": { \"keyframes\": [\n { \"time\": 0.16, \"value\": [540, 1080], \"easing\": \"ease_out\" },\n { \"time\": 0.66, \"value\": [540, 1000] } ] },\n \"opacity\": { \"keyframes\": [\n { \"time\": 0.16, \"value\": 0, \"easing\": \"ease_out\" },\n { \"time\": 0.66, \"value\": 1 } ] } } }\n```\n\n**Heuristic, not contract.** `0.08s`, `0.5s`, and `80px` are trial values. Compress the spread for a\ndense row, lengthen it when order needs to be read, and change travel with the layout. scene only\nrequires valid ascending times and supported values; it does not define an ideal cascade.\n\n**Avoid when.** Use a single group motion when the items form one inseparable object, or when the\nlast sibling would arrive too late for the available reading time. Do not add overshoot to every\nitem merely because they are staggered.\n\n**Check.** Validate the assembled scene, query each landing, and preview the entire cascade to check\nreading order and the time left for the last item.\n\n## A three-phase directional nudge\n\n**Intent.** Emphasize a direction after the cascade reaches rest. Nudge the semantic leader only;\nsubordinates stay still so the second beat does not restart the entire row.\n\n**scene translation.** Keep the entrance and the nudge as separate motion responsibilities.\nUse an outer empty control for the leader's entrance, an inner empty control for the nudge, and\nparent the painted leader to the inner control. The inner positions are offsets in the outer empty's\nlocal space. Keep the leader's opacity track on the painted item as in the cascade example above;\nonly its spatial motion moves to the two controls:\n\n```json\n{ \"id\": \"leader-entrance-rig\",\n \"content\": { \"kind\": \"empty\" },\n \"transform\": { \"position\": [540, 600] },\n \"animations\": { \"position\": { \"keyframes\": [\n { \"time\": 0.00, \"value\": [540, 680], \"easing\": \"ease_out\" },\n { \"time\": 0.50, \"value\": [540, 600] }\n ] } } },\n{ \"id\": \"leader-nudge-rig\", \"parentId\": \"leader-entrance-rig\",\n \"content\": { \"kind\": \"empty\" },\n \"transform\": { \"position\": [0, 0] },\n \"animations\": { \"position\": { \"keyframes\": [\n { \"time\": 0.80, \"value\": [0, 0], \"easing\": \"ease_in_out\" },\n { \"time\": 0.86, \"value\": [-12, 0], \"easing\": \"ease_out\" },\n { \"time\": 1.02, \"value\": [30, 0], \"easing\": \"ease_in_out\" },\n { \"time\": 1.22, \"value\": [0, 0] }\n ] } } },\n{ \"id\": \"item-a\", \"parentId\": \"leader-nudge-rig\",\n \"transform\": { \"position\": [0, 0] },\n \"content\": { \"kind\": \"color\", \"color\": \"#61d5ffff\", \"size\": [720, 120] },\n \"animations\": { \"opacity\": { \"keyframes\": [\n { \"time\": 0.00, \"value\": 0, \"easing\": \"ease_out\" },\n { \"time\": 0.50, \"value\": 1 }\n ] } } }\n```\n\nThe small local move left is anticipation, the move through zero to the right is the directional\naction, and the final keyframe resolves at `[0, 0]`. The entrance rig lands before the nudge rig\nstarts. One motion responsibility per track also keeps the entrance and nudge independently\nretimeable. A single long spatial track is also valid; choose controls when separate editing helps.\n\n**Heuristic, not contract.** The `12px` anticipation, `30px` action, and phase durations are trials.\nScale them to the element and viewing size. A nudge can omit anticipation when speed or restraint\nmatters more than character.\n\n**Avoid when.** Do not nudge a decorative element that does not own the direction, repeat the gesture\nuntil it becomes jitter, or copy it to every sibling. Skip the nudge entirely if the cascade already\nspent the beat's attention budget.\n\n**Check.** Query the leader and siblings before, during and after the nudge: only the leader should\ndeviate from its settled position. Inspect playback to decide whether anticipation reads or flickers.\n\n## A persistent shared element\n\n**Intent.** Let the eye follow one object into a new arrangement when its identity matters.\n\n**scene translation.** Keep one layer id and one layer window alive across both states; animate\nits placement delta while subordinate layers leave or arrive around it:\n\n```json\n{ \"id\": \"shared-card\", \"start\": 0, \"duration\": 4,\n \"animations\": {\n \"position\": { \"keyframes\": [\n { \"time\": 1.7, \"value\": [540,720], \"easing\": \"ease_in_out\" },\n { \"time\": 2.3, \"value\": [320,520] } ] },\n \"scale\": { \"keyframes\": [\n { \"time\": 1.7, \"value\": [1,1], \"easing\": \"ease_in_out\" },\n { \"time\": 2.3, \"value\": [0.74,0.74] } ] } } }\n```\n\n**Heuristic, not contract.** Match the path and pace to the surrounding layout; scene requires\nvalid tracks, not a particular duration or scale delta. **Avoid when.** Use two layers when the\nobjects are not semantically identical or cannot share one lifetime. **Check.** Declare the carrier\nwith `present` across the seam, then inspect playback: geometric presence alone cannot prove that\nthe viewer recognizes the same object.\n\n## A direction-matched seam\n\n**Intent.** Continue an already-established whole-frame direction across a clip boundary.\n\n**scene translation.** Use a catalog transition on the track gap; omit the entry for a deliberate\nhard reset:\n\n```json\n\"content\": { \"kind\": \"track\", \"clips\": [\n { \"duration\": 2, \"content\": { \"kind\": \"color\", \"color\": \"#1b2d45ff\" } },\n { \"duration\": 2, \"content\": { \"kind\": \"color\", \"color\": \"#34234dff\" } }\n], \"transitions\": [\n { \"between\": 0, \"id\": \"slide\", \"duration\": 0.6,\n \"params\": { \"direction\": \"left\" } }\n] }\n```\n\n**Heuristic, not contract.** Match direction only when continuation is the message; a cut,\ncrossfade, or reversal may better express punctuation, ambiguity, or interruption. **Avoid when.** Do\nnot spend a transition to disguise an unresolved semantic relationship. **Check.** Preview both\nsides of the actual seam and its midpoint; compare a simple cut when the intended relationship is a reset.\n\n## A causal handoff\n\n**Intent.** Make an action visibly cause a response and reveal instead of reading as three unrelated\nanimations.\n\n**scene translation.** Give the action landing, response onset, and reveal onset one event time;\ntheir later settling times may differ:\n\n```json\n{ \"id\": \"action\", \"animations\": { \"position\": { \"keyframes\": [\n { \"time\": 1.35, \"value\": [230,1350], \"easing\": \"ease_in_out\" },\n { \"time\": 2.2, \"value\": [760,1220] } ] } } },\n{ \"id\": \"response\", \"animations\": { \"opacity\": { \"keyframes\": [\n { \"time\": 2.2, \"value\": 0, \"easing\": \"ease_out\" },\n { \"time\": 2.35, \"value\": 0.85 }, { \"time\": 2.6, \"value\": 0 } ] } } },\n{ \"id\": \"reveal\", \"animations\": { \"position\": { \"keyframes\": [\n { \"time\": 2.2, \"value\": [540,1660], \"easing\": \"ease_out\" },\n { \"time\": 2.7, \"value\": [540,1540] } ] } } }\n```\n\n**Heuristic, not contract.** Share the onset unless latency is an intentional story or interface\nstate; amplitude and settling remain project trials. **Avoid when.** Do not synchronize unrelated\nevents merely because they are nearby in time. **Check.** Query immediately before and after the\nevent, then watch whether action, response and reveal read as one causal sequence.\n\n## Depth from one camera\n\nParallax and an exploded stack, built from one camera move rather than per-layer offsets, are in\n[references/depth-from-one-camera.md](references/depth-from-one-camera.md). Read it before giving layers\ndifferent depths.\n\n## Moving a group without grouping it\n\n`parentId` names a SIBLING whose transform this layer rides — animate the parent, the children come\nalong, and each keeps its own timing, opacity and easing:\n\n```json\n{ \"id\": \"card\", \"content\": { \"kind\": \"color\", \"color\": \"#3355ff\", \"size\": [200, 140] },\n \"transform\": { \"position\": [200, 420] },\n \"animations\": { \"position\": { \"keyframes\": [\n { \"time\": 0, \"value\": [200, 420], \"easing\": \"ease_out\" }, { \"time\": 2, \"value\": [600, 420] } ] } } },\n{ \"id\": \"badge\", \"parentId\": \"card\", \"transform\": { \"position\": [140, 70] },\n \"content\": { \"kind\": \"color\", \"color\": \"#ffcc00\", \"size\": [40, 40] } }\n```\n\n**The child's position is in the parent's local pixel space, not the composition's.**\nWith the default centered anchor, a `[200, 140]` parent pivots at `[100, 70]`, so a child at `[140, 70]` sits 40px right\nof it — and a child at `[500, 400]` is 400px right and 330px down, which is almost never what the\nnumber looked like. Author the child near the parent's box centre and read the offset from there.\nIf the parent's anchor changes, recompute that offset and query the result.\n\nOnly the transform travels — Placement and its `transforms[]` stack, in that order. A child of a\ntransparent parent does not inherit that opacity through `parentId`. For a group\nfade or a group mask, nest the layers in an inline composition instead —\n`{ \"kind\": \"composition\", \"layers\": [...] }` — and put the fade or `mask` on that layer. It is part\nof this scene and shares its assets. A `scene_ref` is a separate document, for a body you reuse.\nBuild a card this way as one group: its backing, image, label and icon in one composition,\nkeyframed once, so its parts cannot drift apart.\n\n**A control layer is the driver you did not have to elect.** `{ \"kind\": \"empty\" }` draws nothing and\nexists to be parented to — After Effects' Null Object:\n\n```json\n{ \"id\": \"rig\", \"content\": { \"kind\": \"empty\" }, \"transform\": { \"position\": [200, 150] },\n \"animations\": { \"rotation\": { \"keyframes\": [\n { \"time\": 0, \"value\": 0, \"easing\": \"ease_in_out\" }, { \"time\": 2, \"value\": 90 } ] } } },\n{ \"id\": \"a\", \"parentId\": \"rig\", \"transform\": { \"position\": [120, 0] }, \"content\": … },\n{ \"id\": \"b\", \"parentId\": \"rig\", \"transform\": { \"position\": [0, 120] }, \"content\": … }\n```\n\nAn empty occupies no area, so it is a POINT — which changes the rule above in the way you want:\nits children's positions are measured from the empty ITSELF (a child at `[0, 0]` sits on it), and\nturning or scaling it swings them around it. It carries no `effects`, `looks`, `mask` or\n`blendMode` — there are no pixels for those, so authoring one is an error rather than a no-op.\n\nQuery the parent and child at rest and during travel; use `translation` only while their sizes and\nrotations remain fixed. A cycle, self-reference or unknown parent id is invalid.\n\n## A focus pull, and a card that turns\n\nBlur and flip are effects rather than transforms, so they compose with motion instead of competing\nwith it. The preset/look choices, checks, stacking behavior, and wipe\nconstruction live in [references/focus-flip-and-wipe.md](references/focus-flip-and-wipe.md).\n\n## A wipe\n\nNothing about a transform can hide half a layer, so a wipe is a mask. Prefer a wipe look when it\nmust stack with other masks; a layer has only one direct `mask` field. See the linked reference above\nfor role slots, directions, reveal presets, checks, and look ordering constraints.\n\n## Drawing a line on\n\nA stroke that appears to be *drawn* — a line, an underline, a checkmark, an arrow, a progress bar — is\none mechanism: a `shape` whose `trim` item is animated. `trim.end` 0 → 1 reveals the stroked path\nprogressively. Order the items `[path, trim, stroke]` — the trim modifies the geometry before it, the\nstroke paints the trimmed result:\n\n```json\n{ \"kind\": \"shape\", \"items\": [\n { \"type\": \"path\", \"closed\": false, \"vertices\": [ { \"point\": [-400, 0] }, { \"point\": [400, 0] } ] },\n { \"type\": \"trim\", \"start\": 0, \"end\": { \"keyframes\": [\n { \"time\": 0, \"value\": 0, \"easing\": \"ease_in_out\" }, { \"time\": 1.2, \"value\": 1 } ] } },\n { \"type\": \"stroke\", \"color\": \"#5b6cff\", \"width\": 18 } ] }\n```\n\nThis path authors an 800px line with a 1.2s reveal. The four\n\"variants\" are the SAME trim track — only the path geometry and stroke change: a 3-point `V` polyline\nis a checkmark, an arrow-shaped path an arrow, and a fat round-capped stroke over a dim full-length\ntwin is a progress bar (the twin is a second layer with no trim — the track, drawn first so the bright\nfill lands on top). `ease_in_out` reads hand-drawn; `linear` reads mechanical, right for a progress\nbar. This lives at the shape-`items` level, which layer presets don't reach, so it is a pattern rather\nthan a preset. Preview the start, partial stroke and completion; verify the intended path direction.\n""---\nname: motion-pattern-library\ndescription: Worked scene motion patterns for entrances, exits, stagger, directional nudges, emphasis, ambient life, springs, arcs, layered beats, parenting, parallax, focus, wipes, drawn strokes, and cartoon fast motion (smears, multiples, speed lines). Use when the motion intent is known and you need supported scene properties and keyframe structures to adapt; values are starting points, not universal timing rules.\nmetadata:\n category: authoring\n version: '1.6'\n ported-from: motion-patterns 1.6 at 55.104.0\n---\n\n# Worked beats\n\nChoose a construction for the intended beat, adapt it to the scene, then check the result.\nThe snippets are fragments, not complete scenes or ready-to-run MCP calls; `…` marks omitted input.\nTimes, distances and amplitudes are starting choices, not quality guarantees. Use `picsart_scene_validate`\nfor structure, `picsart_scene_query_layout` / `picsart_scene_lint_layout` for declared geometry, and `picsart_scene_contact_sheet` with explicit `times` and `resolution` equal to the composition dimensions\nplus continuous playback to judge the motion. Fetch current preset/look parameters before applying one.\n\nBefore adapting **any pattern below**, read\n[Validation by pattern](references/validation-by-pattern.md). Select its row, declare the intended\noutcome and tolerance, and retain its measurement and visual checks in the beat's acceptance plan.\nFetch it through MCP with `picsart_scene_recipe` using `name: \"motion-pattern-library\"` and\n`reference: \"references/validation-by-pattern.md\"`. A successful render or schema check alone is\nnot motion acceptance; report measured, visually inspected, and unchecked outcomes separately.\n\nDecisions behind these — which beat, which register, how long — are\n`picsart_scene_recipe motion-intent`. The fields themselves are\n`picsart_scene_recipe scene-animation-reference`. For whole-sequence relationships, visual carriers, intentional\nresets, and seam choice, start with `picsart_scene_recipe motion-scene-continuity`. This is the middle: shapes\nthat work.\n\n## Entrance, and the exit that answers it\n\nA useful pacing trial is an exit around 65–75% of its entrance. This is a motion heuristic, not an\nscene rule. Pick the form by what happens next:\na **motion preset** when the keyframes will be edited afterwards (by the agent or in the editor), a\n**look** when the motion should stay a named, swappable entry for the editor.\n\nAs a look, both halves are one look played at either end of the layer by `role`:\n\n```json\n{ \"scene\": …, \"layerId\": \"card\", \"preset\": \"look:zoom\", \"params\": { \"role\": \"in\", \"length\": 0.5, \"scale\": 0.9 } }\n{ \"scene\": …, \"layerId\": \"card\", \"preset\": \"look:zoom\", \"params\": { \"role\": \"out\", \"length\": 0.35, \"scale\": 0.9 } }\n```\n\nEach call appends one `looks[]` entry, so the document keeps both by name and an editor can show and\nswap them. `role: in` starts at the layer's start; `role: out` ends exactly at its end, however the\nlayer is later trimmed.\n\nAs motion presets, `picsart_scene_apply_preset` with `motionPreset:<id>` (iOS `applyMotionPreset`) expands each into ordinary\nkeyframes you then own:\n\n```json\n{ \"scene\": …, \"layerId\": \"card\", \"preset\": \"motionPreset:zoom_in\", \"params\": { \"duration\": 0.5, \"from\": 0.9 } }\n{ \"scene\": …, \"layerId\": \"card\", \"preset\": \"motionPreset:zoom_out\", \"params\": { \"duration\": 0.35, \"to\": 0.9 } }\n```\n\nCheck start, midpoint and end bounds: the size should change around the intended pivot, with no\nunintended center drift. Check the exit against the layer's actual end after trimming.\n\nThe motion looks at a glance, so a substitution is an informed one (`picsart_scene_capabilities`\n`look:<id>` has every param):\n\n| Look | What it does |\n|---|---|\n| `fade` (`in` / `out`) | opacity only; nothing moves |\n| `slide` (`in` / `out`) | travels `distance` multiples of its own size along `direction`, `up` by default |\n| `zoom` (`in` / `out`) | grows from, or shrinks to, `scale` of its own size |\n| `spin` (`in` / `out`) | turns through `angle` while scaling from `scale`; `scale: 1` turns without scaling |\n| `wipe` (`in` / `out`) | a hard edge uncovers or covers it along `direction` |\n| `blur` (`in` / `out`) | focus pull: `gaussian_blur` from, or to, `amount` |\n| `flip` (`in` / `out`) | turns edge-on through `angle` about `axis` (`y`, or `x`) in perspective |\n| `pop` (`in`) | overshoots to `overshoot` and settles |\n| `float`, `sway`, `shake`, `pulse` | loops for the layer's whole length |\n| `glow_pulse` | a blurred copy screened over the layer swells and fades each `period` |\n| `ken_burns` | zooms or pans the picture inside a fixed frame; `media` / `scene_ref` only |\n\n`fade` on a motion look blends its motion toward the layer's rest: `fade: 0.5` slides half the\ndistance, `fade: 0` leaves the layer where it stands, and a keyframed fade ramps the motion in.\n\nA look plays over its whole layer unless the entry names a window — `start` (on the layer's clock)\nand `duration`: `{ \"look\": \"shake\", \"start\": 1.2, \"duration\": 0.4 }` shakes for 0.4s and rests\naround it. An entrance inside a window starts at the window's start and holds its start before it;\nan exit ends at the window's end and holds there after it.\n\nPreset behaviour at a glance (`picsart_scene_capabilities` with `sections: [\"motionPresets\"]` lists preset parameters):\n\n| Preset | Construction to inspect |\n|---|---|\n| `fade_in` / `fade_out` | opacity only; nothing moves |\n| `slide_in` | directional arrival; inspect the selected direction and travel |\n| `slide_out` | directional departure; inspect the final visible frame |\n| `zoom_in` | scales from `from` toward rest |\n| `zoom_out` | scales from rest toward `to` |\n| `scale_pop` | inspect the peak and settling; do not assume an entrance from small to large |\n| `glow_pulse` | continuous pulse, does not resolve |\n| `ken_burns` | `media` / `scene_ref` only |\n\nA one-shot beat at a chosen moment — `spring`, `tap_pulse`, `scale_pop` — is a preset only: looks\nhold entrances, exits and loops.\n\n## A settle with overshoot\n\nOne segment, no third keyframe — the curve carries it:\n\n```json\n\"scale\": { \"keyframes\": [\n { \"time\": 0.0, \"value\": [0.8, 0.8],\n \"easing\": { \"kind\": \"cubic_bezier\", \"control\": [0.175, 0.885, 0.32, 1.275] } },\n { \"time\": 0.45, \"value\": [1.0, 1.0] }\n] }\n```\n\nThe `y2` control ordinate influences overshoot but is not the rendered overshoot percentage.\nSample the track through its peak and landing; judge the peak against this element's size and role.\n\n## A real spring\n\nWhen one overshoot is not enough — a damped oscillation as a single expression:\n\n```json\n\"scale\": { \"expression\": \"return value * (1 + 0.35 * math.exp(-6*time) * math.cos(18*time))\" }\n```\n\nThe exponential damps the amplitude; the cosine controls oscillation frequency. Check extrema and\nthe settled tail, not only endpoints. Confirm the expression's clock when the layer starts late.\n\nA part that lags ANOTHER part's motion (hair behind a turning head) is not this: apply the\n`follow_through` preset to a parameter (`picsart_scene_recipe scene-animation-reference`, \"Secondary motion and characters\").\n\n## Ambient life\n\nBackground motion that keeps looping while the beat lasts:\n\n```json\n\"scale\": { \"expression\": \"return value * (1 + 0.02 * math.sin(2*math.pi*time/4))\" }\n```\n\nThe `0.02` coefficient varies the base scale by ±2%. Keeping ambient amplitude below the leader is a motion\nheuristic; leaving the background still is also valid.\nThe literal `4` is a four-second period: changing the beat's duration does not retime it. Change the\nperiod explicitly if the intended number of cycles must stay fixed, then recheck the loop and ending.\n\nFor text, inspect the available ambient text-animation presets; caption decorations and ordinary\ntext layers have different authoring entry points (`scene-animation-reference`).\n\n## Confetti, sparks and snow\n\nMany small copies of one thing, thrown and falling, are one layer with `particles`, not hand-copied\nlayers. The layer's `content` is the particle; its `transform.position` places the emitter:\n\n```json\n{ \"id\": \"confetti\", \"transform\": { \"position\": [540, 1080] },\n \"content\": { \"kind\": \"shape\", \"items\": [{ \"type\": \"rect\", \"size\": [22, 12] }, { \"type\": \"fill\", \"color\": \"#ff3b6b\" }] },\n \"particles\": { \"seed\": 1, \"emit\": { \"bursts\": [{ \"time\": 0, \"count\": 120 }] },\n \"life\": [2, 3.2], \"direction\": -90, \"spread\": 40, \"speed\": [1100, 2300], \"gravity\": [0, 1500],\n \"spin\": [-450, 450], \"opacityOverLife\": [1, 0.3] } }\n```\n\nEvery particle draws the layer's content, so several colours are several such layers, each with its\nown colour and `seed`. Each burst releases `count` particles at its `time`; a stream is\n`\"emit\": { \"rate\": 40 }`, which emits until the layer ends (or for its `\"duration\"`), and a negative\n`start` has it already running at the layer's first frame. Snow streams from a wide\n`\"origin\": { \"shape\": \"line\", \"size\": [1400, 1] }` on a layer placed above the frame, with\n`\"direction\": 90`, a small `\"spread\": 30` and little `gravity`: a directed throw needs a small spread,\nsince the default 360 throws every way. Two layers with different particle sizes, speeds and\nopacities read as depth. Change `seed` for another throw of the same effect; the same seed always\ndraws the same frames.\n\n## An arc instead of a straight line\n\nTangents bow the path; easing still shapes the timing along it:\n\n```json\n\"position\": { \"keyframes\": [\n { \"time\": 0, \"value\": [200, 540], \"easing\": \"ease_in_out\", \"outTangent\": [120, -160] },\n { \"time\": 1.6, \"value\": [880, 540], \"inTangent\": [-120, -160] }\n] }\n```\n\nInspect the swept path for collisions and unintended depth crossings. The handles bow this path;\nwithout them the same two keyframes describe a straight line.\n\n## Two motion layers on one element\n\nPrimary and ambient as separate components, so each stays re-timeable:\n\n```json\n\"transforms\": [\n { \"id\": \"entrance\", \"animations\": { \"translation\": { \"keyframes\": [\n { \"time\": 0, \"value\": [0, 200], \"easing\": \"ease_out\" }, { \"time\": 0.6, \"value\": [0, 0] } ] } } },\n { \"id\": \"breathe\", \"animations\": { \"scale\": {\n \"expression\": \"return value * (1 + 0.12 * math.sin(2*math.pi*time/1.5))\" } } }\n]\n```\n\nCheck that the entrance lands at its intended time while the ambient track continues independently.\nThe 12% amplitude here demonstrates separation, not a recommendation for subtle background motion.\n\n## A whole beat in one register\n\nBrief: *\"clean, professional quarterly review card\"*. Try a restrained timing palette, then judge it\nagainst reading time and the actual layout. Four roles, each entering when its context justifies it:\n\n| Layer | Starts | Motion |\n|---|---|---|\n| background | 0 | 2% breathe expression — least motion in the frame |\n| card | 0.2 | `position` 600 → 520 with a co-terminous opacity fade, 0.5s `ease_out` |\n| headline | 0.8 | `slide_up_lines` 0.5s — a build, after its context |\n| CTA | 2.0 | scale 0.9 → 1.0; inspect any easing overshoot instead of deriving it from a control ordinate |\n\nPreview the entrance order and readable holds. If the background competes with the headline or the\nCTA arrives before its context is understood, reduce competing motion or retime the beat.\n\n## Staggering a row\n\nPer-item delay inside a `$each` body, using the loop index:\n\n```json\n{ \"$each\": \"tiles\", \"as\": \"tile\", \"body\": {\n \"id\": \"tile\",\n \"animations\": { \"opacity\": { \"keyframes\": [\n { \"time\": { \"$eval\": \"tile.@index * 0.08\" }, \"value\": 0 },\n { \"time\": { \"$eval\": \"tile.@index * 0.08 + 0.2\" }, \"value\": 1 } ] } } } }\n```\n\nA compact stagger is a starting trial; adjust the spread to the reading order. Resolve the\ntemplate first (`picsart_scene_apply_template` with `mode='bootstrap'`) — the tools refuse a stray\n`$each` by name.\n\n## A cascading spatial entrance\n\n**Intent.** Reveal a reading order without turning every item into a separate hero. The first item\nleads; later siblings repeat the same relationship with a compact delay.\n\n**scene translation.** Give each sibling the same position-plus-opacity arrival, offsetting its\nkeyframe times. The opacity and position tracks below end together, so each sibling reads as one\narrival. These are fragments for three ordinary layers, not a named preset:\n\n```json\n{ \"id\": \"item-a\", \"animations\": {\n \"position\": { \"keyframes\": [\n { \"time\": 0.00, \"value\": [540, 680], \"easing\": \"ease_out\" },\n { \"time\": 0.50, \"value\": [540, 600] } ] },\n \"opacity\": { \"keyframes\": [\n { \"time\": 0.00, \"value\": 0, \"easing\": \"ease_out\" },\n { \"time\": 0.50, \"value\": 1 } ] } } }\n{ \"id\": \"item-b\", \"animations\": {\n \"position\": { \"keyframes\": [\n { \"time\": 0.08, \"value\": [540, 880], \"easing\": \"ease_out\" },\n { \"time\": 0.58, \"value\": [540, 800] } ] },\n \"opacity\": { \"keyframes\": [\n { \"time\": 0.08, \"value\": 0, \"easing\": \"ease_out\" },\n { \"time\": 0.58, \"value\": 1 } ] } } }\n{ \"id\": \"item-c\", \"animations\": {\n \"position\": { \"keyframes\": [\n { \"time\": 0.16, \"value\": [540, 1080], \"easing\": \"ease_out\" },\n { \"time\": 0.66, \"value\": [540, 1000] } ] },\n \"opacity\": { \"keyframes\": [\n { \"time\": 0.16, \"value\": 0, \"easing\": \"ease_out\" },\n { \"time\": 0.66, \"value\": 1 } ] } } }\n```\n\n**Heuristic, not contract.** `0.08s`, `0.5s`, and `80px` are trial values. Compress the spread for a\ndense row, lengthen it when order needs to be read, and change travel with the layout. scene only\nrequires valid ascending times and supported values; it does not define an ideal cascade.\n\n**Avoid when.** Use a single group motion when the items form one inseparable object, or when the\nlast sibling would arrive too late for the available reading time. Do not add overshoot to every\nitem merely because they are staggered.\n\n**Check.** Validate the assembled scene, query each landing, and preview the entire cascade to check\nreading order and the time left for the last item.\n\n## A three-phase directional nudge\n\n**Intent.** Emphasize a direction after the cascade reaches rest. Nudge the semantic leader only;\nsubordinates stay still so the second beat does not restart the entire row.\n\n**scene translation.** Keep the entrance and the nudge as separate motion responsibilities.\nUse an outer empty control for the leader's entrance, an inner empty control for the nudge, and\nparent the painted leader to the inner control. The inner positions are offsets in the outer empty's\nlocal space. Keep the leader's opacity track on the painted item as in the cascade example above;\nonly its spatial motion moves to the two controls:\n\n```json\n{ \"id\": \"leader-entrance-rig\",\n \"content\": { \"kind\": \"empty\" },\n \"transform\": { \"position\": [540, 600] },\n \"animations\": { \"position\": { \"keyframes\": [\n { \"time\": 0.00, \"value\": [540, 680], \"easing\": \"ease_out\" },\n { \"time\": 0.50, \"value\": [540, 600] }\n ] } } },\n{ \"id\": \"leader-nudge-rig\", \"parentId\": \"leader-entrance-rig\",\n \"content\": { \"kind\": \"empty\" },\n \"transform\": { \"position\": [0, 0] },\n \"animations\": { \"position\": { \"keyframes\": [\n { \"time\": 0.80, \"value\": [0, 0], \"easing\": \"ease_in_out\" },\n { \"time\": 0.86, \"value\": [-12, 0], \"easing\": \"ease_out\" },\n { \"time\": 1.02, \"value\": [30, 0], \"easing\": \"ease_in_out\" },\n { \"time\": 1.22, \"value\": [0, 0] }\n ] } } },\n{ \"id\": \"item-a\", \"parentId\": \"leader-nudge-rig\",\n \"transform\": { \"position\": [0, 0] },\n \"content\": { \"kind\": \"color\", \"color\": \"#61d5ffff\", \"size\": [720, 120] },\n \"animations\": { \"opacity\": { \"keyframes\": [\n { \"time\": 0.00, \"value\": 0, \"easing\": \"ease_out\" },\n { \"time\": 0.50, \"value\": 1 }\n ] } } }\n```\n\nThe small local move left is anticipation, the move through zero to the right is the directional\naction, and the final keyframe resolves at `[0, 0]`. The entrance rig lands before the nudge rig\nstarts. One motion responsibility per track also keeps the entrance and nudge independently\nretimeable. A single long spatial track is also valid; choose controls when separate editing helps.\n\n**Heuristic, not contract.** The `12px` anticipation, `30px` action, and phase durations are trials.\nScale them to the element and viewing size. A nudge can omit anticipation when speed or restraint\nmatters more than character.\n\n**Avoid when.** Do not nudge a decorative element that does not own the direction, repeat the gesture\nuntil it becomes jitter, or copy it to every sibling. Skip the nudge entirely if the cascade already\nspent the beat's attention budget.\n\n**Check.** Query the leader and siblings before, during and after the nudge: only the leader should\ndeviate from its settled position. Inspect playback to decide whether anticipation reads or flickers.\n\n## A persistent shared element\n\n**Intent.** Let the eye follow one object into a new arrangement when its identity matters.\n\n**scene translation.** Keep one layer id and one layer window alive across both states; animate\nits placement delta while subordinate layers leave or arrive around it:\n\n```json\n{ \"id\": \"shared-card\", \"start\": 0, \"duration\": 4,\n \"animations\": {\n \"position\": { \"keyframes\": [\n { \"time\": 1.7, \"value\": [540,720], \"easing\": \"ease_in_out\" },\n { \"time\": 2.3, \"value\": [320,520] } ] },\n \"scale\": { \"keyframes\": [\n { \"time\": 1.7, \"value\": [1,1], \"easing\": \"ease_in_out\" },\n { \"time\": 2.3, \"value\": [0.74,0.74] } ] } } }\n```\n\n**Heuristic, not contract.** Match the path and pace to the surrounding layout; scene requires\nvalid tracks, not a particular duration or scale delta. **Avoid when.** Use two layers when the\nobjects are not semantically identical or cannot share one lifetime. **Check.** Declare the carrier\nwith `present` across the seam, then inspect playback: geometric presence alone cannot prove that\nthe viewer recognizes the same object.\n\n## A direction-matched seam\n\n**Intent.** Continue an already-established whole-frame direction across a clip boundary.\n\n**scene translation.** Use a catalog transition on the track gap; omit the entry for a deliberate\nhard reset:\n\n```json\n\"content\": { \"kind\": \"track\", \"clips\": [\n { \"duration\": 2, \"content\": { \"kind\": \"color\", \"color\": \"#1b2d45ff\" } },\n { \"duration\": 2, \"content\": { \"kind\": \"color\", \"color\": \"#34234dff\" } }\n], \"transitions\": [\n { \"between\": 0, \"id\": \"slide\", \"duration\": 0.6,\n \"params\": { \"direction\": \"left\" } }\n] }\n```\n\n**Heuristic, not contract.** Match direction only when continuation is the message; a cut,\ncrossfade, or reversal may better express punctuation, ambiguity, or interruption. **Avoid when.** Do\nnot spend a transition to disguise an unresolved semantic relationship. **Check.** Preview both\nsides of the actual seam and its midpoint; compare a simple cut when the intended relationship is a reset.\n\n## A causal handoff\n\n**Intent.** Make an action visibly cause a response and reveal instead of reading as three unrelated\nanimations.\n\n**scene translation.** Give the action landing, response onset, and reveal onset one event time;\ntheir later settling times may differ:\n\n```json\n{ \"id\": \"action\", \"animations\": { \"position\": { \"keyframes\": [\n { \"time\": 1.35, \"value\": [230,1350], \"easing\": \"ease_in_out\" },\n { \"time\": 2.2, \"value\": [760,1220] } ] } } },\n{ \"id\": \"response\", \"animations\": { \"opacity\": { \"keyframes\": [\n { \"time\": 2.2, \"value\": 0, \"easing\": \"ease_out\" },\n { \"time\": 2.35, \"value\": 0.85 }, { \"time\": 2.6, \"value\": 0 } ] } } },\n{ \"id\": \"reveal\", \"animations\": { \"position\": { \"keyframes\": [\n { \"time\": 2.2, \"value\": [540,1660], \"easing\": \"ease_out\" },\n { \"time\": 2.7, \"value\": [540,1540] } ] } } }\n```\n\n**Heuristic, not contract.** Share the onset unless latency is an intentional story or interface\nstate; amplitude and settling remain project trials. **Avoid when.** Do not synchronize unrelated\nevents merely because they are nearby in time. **Check.** Query immediately before and after the\nevent, then watch whether action, response and reveal read as one causal sequence.\n\n## Depth from one camera\n\nParallax and an exploded stack, built from one camera move rather than per-layer offsets, are in\n[references/depth-from-one-camera.md](references/depth-from-one-camera.md). Read it before giving layers\ndifferent depths.\n\n## Moving a group without grouping it\n\n`parentId` names a SIBLING whose transform this layer rides — animate the parent, the children come\nalong, and each keeps its own timing, opacity and easing:\n\n```json\n{ \"id\": \"card\", \"content\": { \"kind\": \"color\", \"color\": \"#3355ff\", \"size\": [200, 140] },\n \"transform\": { \"position\": [200, 420] },\n \"animations\": { \"position\": { \"keyframes\": [\n { \"time\": 0, \"value\": [200, 420], \"easing\": \"ease_out\" }, { \"time\": 2, \"value\": [600, 420] } ] } } },\n{ \"id\": \"badge\", \"parentId\": \"card\", \"transform\": { \"position\": [140, 70] },\n \"content\": { \"kind\": \"color\", \"color\": \"#ffcc00\", \"size\": [40, 40] } }\n```\n\n**The child's position is in the parent's local pixel space, not the composition's.**\nWith the default centered anchor, a `[200, 140]` parent pivots at `[100, 70]`, so a child at `[140, 70]` sits 40px right\nof it — and a child at `[500, 400]` is 400px right and 330px down, which is almost never what the\nnumber looked like. Author the child near the parent's box centre and read the offset from there.\nIf the parent's anchor changes, recompute that offset and query the result.\n\nOnly the transform travels — Placement and its `transforms[]` stack, in that order. A child of a\ntransparent parent does not inherit that opacity through `parentId`. For a group\nfade or a group mask, nest the layers in an inline composition instead —\n`{ \"kind\": \"composition\", \"layers\": [...] }` — and put the fade or `mask` on that layer. It is part\nof this scene and shares its assets. A `scene_ref` is a separate document, for a body you reuse.\nBuild a card this way as one group: its backing, image, label and icon in one composition,\nkeyframed once, so its parts cannot drift apart.\n\n**A control layer is the driver you did not have to elect.** `{ \"kind\": \"empty\" }` draws nothing and\nexists to be parented to — After Effects' Null Object:\n\n```json\n{ \"id\": \"rig\", \"content\": { \"kind\": \"empty\" }, \"transform\": { \"position\": [200, 150] },\n \"animations\": { \"rotation\": { \"keyframes\": [\n { \"time\": 0, \"value\": 0, \"easing\": \"ease_in_out\" }, { \"time\": 2, \"value\": 90 } ] } } },\n{ \"id\": \"a\", \"parentId\": \"rig\", \"transform\": { \"position\": [120, 0] }, \"content\": … },\n{ \"id\": \"b\", \"parentId\": \"rig\", \"transform\": { \"position\": [0, 120] }, \"content\": … }\n```\n\nAn empty occupies no area, so it is a POINT — which changes the rule above in the way you want:\nits children's positions are measured from the empty ITSELF (a child at `[0, 0]` sits on it), and\nturning or scaling it swings them around it. It carries no `effects`, `looks`, `mask` or\n`blendMode` — there are no pixels for those, so authoring one is an error rather than a no-op.\n\nQuery the parent and child at rest and during travel; use `translation` only while their sizes and\nrotations remain fixed. A cycle, self-reference or unknown parent id is invalid.\n\n## A focus pull, and a card that turns\n\nBlur and flip are effects rather than transforms, so they compose with motion instead of competing\nwith it. The preset/look choices, checks, stacking behavior, and wipe\nconstruction live in [references/focus-flip-and-wipe.md](references/focus-flip-and-wipe.md).\n\n## A wipe\n\nNothing about a transform can hide half a layer, so a wipe is a mask. Prefer a wipe look when it\nmust stack with other masks; a layer has only one direct `mask` field. See the linked reference above\nfor role slots, directions, reveal presets, checks, and look ordering constraints.\n\n## Drawing a line on\n\nA stroke that appears to be *drawn* — a line, an underline, a checkmark, an arrow, a progress bar — is\none mechanism: a `shape` whose `trim` item is animated. `trim.end` 0 → 1 reveals the stroked path\nprogressively. Order the items `[path, trim, stroke]` — the trim modifies the geometry before it, the\nstroke paints the trimmed result:\n\n```json\n{ \"kind\": \"shape\", \"items\": [\n { \"type\": \"path\", \"closed\": false, \"vertices\": [ { \"point\": [-400, 0] }, { \"point\": [400, 0] } ] },\n { \"type\": \"trim\", \"start\": 0, \"end\": { \"keyframes\": [\n { \"time\": 0, \"value\": 0, \"easing\": \"ease_in_out\" }, { \"time\": 1.2, \"value\": 1 } ] } },\n { \"type\": \"stroke\", \"color\": \"#5b6cff\", \"width\": 18 } ] }\n```\n\nThis path authors an 800px line with a 1.2s reveal. The four\n\"variants\" are the SAME trim track — only the path geometry and stroke change: a 3-point `V` polyline\nis a checkmark, an arrow-shaped path an arrow, and a fat round-capped stroke over a dim full-length\ntwin is a progress bar (the twin is a second layer with no trim — the track, drawn first so the bright\nfill lands on top). `ease_in_out` reads hand-drawn; `linear` reads mechanical, right for a progress\nbar. This lives at the shape-`items` level, which layer presets don't reach, so it is a pattern rather\nthan a preset. Preview the start, partial stroke and completion; verify the intended path direction.\n\nAn ink line that writes on — a signature, a doodle, a character's outline — is the same trim track with a\ntapered stroke (`character-rigging`, \"Ink lines\"). The taper is laid along the drawn part, so the moving\nend keeps its point as it writes on.\n\n## Cartoon fast motion: smears, multiples and speed lines\n\nA dash, a fast wave or a zip exit reads as a cartoon when its fast frames are drawn differently. The\n`smear`, `multiple` and `speed_lines` motion presets read the layer's real motion and draw only above a\nspeed threshold, along the motion. Which layer each goes on, frame counts, the exit zip and how they\ncombine with motion blur are in [references/cartoon-fast-motion.md](references/cartoon-fast-motion.md).\n"Full snapshot data
{
"description": "Worked scene motion patterns for entrances, exits, stagger, directional nudges, emphasis, ambient life, springs, arcs, layered beats, parenting, parallax, focus, wipes, drawn strokes, and cartoon fast motion (smears, multiples, speed lines). Use when the motion intent is known and you need supported scene properties and keyframe structures to adapt; values are starting points, not universal timing rules.",
"included_files": [
{
"relative_path": "references/cartoon-fast-motion.md",
"size_in_bytes": 3572
},
{
"relative_path": "references/depth-from-one-camera.md",
"size_in_bytes": 3928
},
{
"relative_path": "references/focus-flip-and-wipe.md",
"size_in_bytes": 5033
},
{
"relative_path": "references/validation-by-pattern.md",
"size_in_bytes": 22169
}
],
"name": "motion-pattern-library",
"skill_md_contents": "---\nname: motion-pattern-library\ndescription: Worked scene motion patterns for entrances, exits, stagger, directional nudges, emphasis, ambient life, springs, arcs, layered beats, parenting, parallax, focus, wipes, drawn strokes, and cartoon fast motion (smears, multiples, speed lines). Use when the motion intent is known and you need supported scene properties and keyframe structures to adapt; values are starting points, not universal timing rules.\nmetadata:\n category: authoring\n version: '1.6'\n ported-from: motion-patterns 1.6 at 55.104.0\n---\n\n# Worked beats\n\nChoose a construction for the intended beat, adapt it to the scene, then check the result.\nThe snippets are fragments, not complete scenes or ready-to-run MCP calls; `…` marks omitted input.\nTimes, distances and amplitudes are starting choices, not quality guarantees. Use `picsart_scene_validate`\nfor structure, `picsart_scene_query_layout` / `picsart_scene_lint_layout` for declared geometry, and `picsart_scene_contact_sheet` with explicit `times` and `resolution` equal to the composition dimensions\nplus continuous playback to judge the motion. Fetch current preset/look parameters before applying one.\n\nBefore adapting **any pattern below**, read\n[Validation by pattern](references/validation-by-pattern.md). Select its row, declare the intended\noutcome and tolerance, and retain its measurement and visual checks in the beat's acceptance plan.\nFetch it through MCP with `picsart_scene_recipe` using `name: \"motion-pattern-library\"` and\n`reference: \"references/validation-by-pattern.md\"`. A successful render or schema check alone is\nnot motion acceptance; report measured, visually inspected, and unchecked outcomes separately.\n\nDecisions behind these — which beat, which register, how long — are\n`picsart_scene_recipe motion-intent`. The fields themselves are\n`picsart_scene_recipe scene-animation-reference`. For whole-sequence relationships, visual carriers, intentional\nresets, and seam choice, start with `picsart_scene_recipe motion-scene-continuity`. This is the middle: shapes\nthat work.\n\n## Entrance, and the exit that answers it\n\nA useful pacing trial is an exit around 65–75% of its entrance. This is a motion heuristic, not an\nscene rule. Pick the form by what happens next:\na **motion preset** when the keyframes will be edited afterwards (by the agent or in the editor), a\n**look** when the motion should stay a named, swappable entry for the editor.\n\nAs a look, both halves are one look played at either end of the layer by `role`:\n\n```json\n{ \"scene\": …, \"layerId\": \"card\", \"preset\": \"look:zoom\", \"params\": { \"role\": \"in\", \"length\": 0.5, \"scale\": 0.9 } }\n{ \"scene\": …, \"layerId\": \"card\", \"preset\": \"look:zoom\", \"params\": { \"role\": \"out\", \"length\": 0.35, \"scale\": 0.9 } }\n```\n\nEach call appends one `looks[]` entry, so the document keeps both by name and an editor can show and\nswap them. `role: in` starts at the layer's start; `role: out` ends exactly at its end, however the\nlayer is later trimmed.\n\nAs motion presets, `picsart_scene_apply_preset` with `motionPreset:<id>` (iOS `applyMotionPreset`) expands each into ordinary\nkeyframes you then own:\n\n```json\n{ \"scene\": …, \"layerId\": \"card\", \"preset\": \"motionPreset:zoom_in\", \"params\": { \"duration\": 0.5, \"from\": 0.9 } }\n{ \"scene\": …, \"layerId\": \"card\", \"preset\": \"motionPreset:zoom_out\", \"params\": { \"duration\": 0.35, \"to\": 0.9 } }\n```\n\nCheck start, midpoint and end bounds: the size should change around the intended pivot, with no\nunintended center drift. Check the exit against the layer's actual end after trimming.\n\nThe motion looks at a glance, so a substitution is an informed one (`picsart_scene_capabilities`\n`look:<id>` has every param):\n\n| Look | What it does |\n|---|---|\n| `fade` (`in` / `out`) | opacity only; nothing moves |\n| `slide` (`in` / `out`) | travels `distance` multiples of its own size along `direction`, `up` by default |\n| `zoom` (`in` / `out`) | grows from, or shrinks to, `scale` of its own size |\n| `spin` (`in` / `out`) | turns through `angle` while scaling from `scale`; `scale: 1` turns without scaling |\n| `wipe` (`in` / `out`) | a hard edge uncovers or covers it along `direction` |\n| `blur` (`in` / `out`) | focus pull: `gaussian_blur` from, or to, `amount` |\n| `flip` (`in` / `out`) | turns edge-on through `angle` about `axis` (`y`, or `x`) in perspective |\n| `pop` (`in`) | overshoots to `overshoot` and settles |\n| `float`, `sway`, `shake`, `pulse` | loops for the layer's whole length |\n| `glow_pulse` | a blurred copy screened over the layer swells and fades each `period` |\n| `ken_burns` | zooms or pans the picture inside a fixed frame; `media` / `scene_ref` only |\n\n`fade` on a motion look blends its motion toward the layer's rest: `fade: 0.5` slides half the\ndistance, `fade: 0` leaves the layer where it stands, and a keyframed fade ramps the motion in.\n\nA look plays over its whole layer unless the entry names a window — `start` (on the layer's clock)\nand `duration`: `{ \"look\": \"shake\", \"start\": 1.2, \"duration\": 0.4 }` shakes for 0.4s and rests\naround it. An entrance inside a window starts at the window's start and holds its start before it;\nan exit ends at the window's end and holds there after it.\n\nPreset behaviour at a glance (`picsart_scene_capabilities` with `sections: [\"motionPresets\"]` lists preset parameters):\n\n| Preset | Construction to inspect |\n|---|---|\n| `fade_in` / `fade_out` | opacity only; nothing moves |\n| `slide_in` | directional arrival; inspect the selected direction and travel |\n| `slide_out` | directional departure; inspect the final visible frame |\n| `zoom_in` | scales from `from` toward rest |\n| `zoom_out` | scales from rest toward `to` |\n| `scale_pop` | inspect the peak and settling; do not assume an entrance from small to large |\n| `glow_pulse` | continuous pulse, does not resolve |\n| `ken_burns` | `media` / `scene_ref` only |\n\nA one-shot beat at a chosen moment — `spring`, `tap_pulse`, `scale_pop` — is a preset only: looks\nhold entrances, exits and loops.\n\n## A settle with overshoot\n\nOne segment, no third keyframe — the curve carries it:\n\n```json\n\"scale\": { \"keyframes\": [\n { \"time\": 0.0, \"value\": [0.8, 0.8],\n \"easing\": { \"kind\": \"cubic_bezier\", \"control\": [0.175, 0.885, 0.32, 1.275] } },\n { \"time\": 0.45, \"value\": [1.0, 1.0] }\n] }\n```\n\nThe `y2` control ordinate influences overshoot but is not the rendered overshoot percentage.\nSample the track through its peak and landing; judge the peak against this element's size and role.\n\n## A real spring\n\nWhen one overshoot is not enough — a damped oscillation as a single expression:\n\n```json\n\"scale\": { \"expression\": \"return value * (1 + 0.35 * math.exp(-6*time) * math.cos(18*time))\" }\n```\n\nThe exponential damps the amplitude; the cosine controls oscillation frequency. Check extrema and\nthe settled tail, not only endpoints. Confirm the expression's clock when the layer starts late.\n\nA part that lags ANOTHER part's motion (hair behind a turning head) is not this: apply the\n`follow_through` preset to a parameter (`picsart_scene_recipe scene-animation-reference`, \"Secondary motion and characters\").\n\n## Ambient life\n\nBackground motion that keeps looping while the beat lasts:\n\n```json\n\"scale\": { \"expression\": \"return value * (1 + 0.02 * math.sin(2*math.pi*time/4))\" }\n```\n\nThe `0.02` coefficient varies the base scale by ±2%. Keeping ambient amplitude below the leader is a motion\nheuristic; leaving the background still is also valid.\nThe literal `4` is a four-second period: changing the beat's duration does not retime it. Change the\nperiod explicitly if the intended number of cycles must stay fixed, then recheck the loop and ending.\n\nFor text, inspect the available ambient text-animation presets; caption decorations and ordinary\ntext layers have different authoring entry points (`scene-animation-reference`).\n\n## Confetti, sparks and snow\n\nMany small copies of one thing, thrown and falling, are one layer with `particles`, not hand-copied\nlayers. The layer's `content` is the particle; its `transform.position` places the emitter:\n\n```json\n{ \"id\": \"confetti\", \"transform\": { \"position\": [540, 1080] },\n \"content\": { \"kind\": \"shape\", \"items\": [{ \"type\": \"rect\", \"size\": [22, 12] }, { \"type\": \"fill\", \"color\": \"#ff3b6b\" }] },\n \"particles\": { \"seed\": 1, \"emit\": { \"bursts\": [{ \"time\": 0, \"count\": 120 }] },\n \"life\": [2, 3.2], \"direction\": -90, \"spread\": 40, \"speed\": [1100, 2300], \"gravity\": [0, 1500],\n \"spin\": [-450, 450], \"opacityOverLife\": [1, 0.3] } }\n```\n\nEvery particle draws the layer's content, so several colours are several such layers, each with its\nown colour and `seed`. Each burst releases `count` particles at its `time`; a stream is\n`\"emit\": { \"rate\": 40 }`, which emits until the layer ends (or for its `\"duration\"`), and a negative\n`start` has it already running at the layer's first frame. Snow streams from a wide\n`\"origin\": { \"shape\": \"line\", \"size\": [1400, 1] }` on a layer placed above the frame, with\n`\"direction\": 90`, a small `\"spread\": 30` and little `gravity`: a directed throw needs a small spread,\nsince the default 360 throws every way. Two layers with different particle sizes, speeds and\nopacities read as depth. Change `seed` for another throw of the same effect; the same seed always\ndraws the same frames.\n\n## An arc instead of a straight line\n\nTangents bow the path; easing still shapes the timing along it:\n\n```json\n\"position\": { \"keyframes\": [\n { \"time\": 0, \"value\": [200, 540], \"easing\": \"ease_in_out\", \"outTangent\": [120, -160] },\n { \"time\": 1.6, \"value\": [880, 540], \"inTangent\": [-120, -160] }\n] }\n```\n\nInspect the swept path for collisions and unintended depth crossings. The handles bow this path;\nwithout them the same two keyframes describe a straight line.\n\n## Two motion layers on one element\n\nPrimary and ambient as separate components, so each stays re-timeable:\n\n```json\n\"transforms\": [\n { \"id\": \"entrance\", \"animations\": { \"translation\": { \"keyframes\": [\n { \"time\": 0, \"value\": [0, 200], \"easing\": \"ease_out\" }, { \"time\": 0.6, \"value\": [0, 0] } ] } } },\n { \"id\": \"breathe\", \"animations\": { \"scale\": {\n \"expression\": \"return value * (1 + 0.12 * math.sin(2*math.pi*time/1.5))\" } } }\n]\n```\n\nCheck that the entrance lands at its intended time while the ambient track continues independently.\nThe 12% amplitude here demonstrates separation, not a recommendation for subtle background motion.\n\n## A whole beat in one register\n\nBrief: *\"clean, professional quarterly review card\"*. Try a restrained timing palette, then judge it\nagainst reading time and the actual layout. Four roles, each entering when its context justifies it:\n\n| Layer | Starts | Motion |\n|---|---|---|\n| background | 0 | 2% breathe expression — least motion in the frame |\n| card | 0.2 | `position` 600 → 520 with a co-terminous opacity fade, 0.5s `ease_out` |\n| headline | 0.8 | `slide_up_lines` 0.5s — a build, after its context |\n| CTA | 2.0 | scale 0.9 → 1.0; inspect any easing overshoot instead of deriving it from a control ordinate |\n\nPreview the entrance order and readable holds. If the background competes with the headline or the\nCTA arrives before its context is understood, reduce competing motion or retime the beat.\n\n## Staggering a row\n\nPer-item delay inside a `$each` body, using the loop index:\n\n```json\n{ \"$each\": \"tiles\", \"as\": \"tile\", \"body\": {\n \"id\": \"tile\",\n \"animations\": { \"opacity\": { \"keyframes\": [\n { \"time\": { \"$eval\": \"tile.@index * 0.08\" }, \"value\": 0 },\n { \"time\": { \"$eval\": \"tile.@index * 0.08 + 0.2\" }, \"value\": 1 } ] } } } }\n```\n\nA compact stagger is a starting trial; adjust the spread to the reading order. Resolve the\ntemplate first (`picsart_scene_apply_template` with `mode='bootstrap'`) — the tools refuse a stray\n`$each` by name.\n\n## A cascading spatial entrance\n\n**Intent.** Reveal a reading order without turning every item into a separate hero. The first item\nleads; later siblings repeat the same relationship with a compact delay.\n\n**scene translation.** Give each sibling the same position-plus-opacity arrival, offsetting its\nkeyframe times. The opacity and position tracks below end together, so each sibling reads as one\narrival. These are fragments for three ordinary layers, not a named preset:\n\n```json\n{ \"id\": \"item-a\", \"animations\": {\n \"position\": { \"keyframes\": [\n { \"time\": 0.00, \"value\": [540, 680], \"easing\": \"ease_out\" },\n { \"time\": 0.50, \"value\": [540, 600] } ] },\n \"opacity\": { \"keyframes\": [\n { \"time\": 0.00, \"value\": 0, \"easing\": \"ease_out\" },\n { \"time\": 0.50, \"value\": 1 } ] } } }\n{ \"id\": \"item-b\", \"animations\": {\n \"position\": { \"keyframes\": [\n { \"time\": 0.08, \"value\": [540, 880], \"easing\": \"ease_out\" },\n { \"time\": 0.58, \"value\": [540, 800] } ] },\n \"opacity\": { \"keyframes\": [\n { \"time\": 0.08, \"value\": 0, \"easing\": \"ease_out\" },\n { \"time\": 0.58, \"value\": 1 } ] } } }\n{ \"id\": \"item-c\", \"animations\": {\n \"position\": { \"keyframes\": [\n { \"time\": 0.16, \"value\": [540, 1080], \"easing\": \"ease_out\" },\n { \"time\": 0.66, \"value\": [540, 1000] } ] },\n \"opacity\": { \"keyframes\": [\n { \"time\": 0.16, \"value\": 0, \"easing\": \"ease_out\" },\n { \"time\": 0.66, \"value\": 1 } ] } } }\n```\n\n**Heuristic, not contract.** `0.08s`, `0.5s`, and `80px` are trial values. Compress the spread for a\ndense row, lengthen it when order needs to be read, and change travel with the layout. scene only\nrequires valid ascending times and supported values; it does not define an ideal cascade.\n\n**Avoid when.** Use a single group motion when the items form one inseparable object, or when the\nlast sibling would arrive too late for the available reading time. Do not add overshoot to every\nitem merely because they are staggered.\n\n**Check.** Validate the assembled scene, query each landing, and preview the entire cascade to check\nreading order and the time left for the last item.\n\n## A three-phase directional nudge\n\n**Intent.** Emphasize a direction after the cascade reaches rest. Nudge the semantic leader only;\nsubordinates stay still so the second beat does not restart the entire row.\n\n**scene translation.** Keep the entrance and the nudge as separate motion responsibilities.\nUse an outer empty control for the leader's entrance, an inner empty control for the nudge, and\nparent the painted leader to the inner control. The inner positions are offsets in the outer empty's\nlocal space. Keep the leader's opacity track on the painted item as in the cascade example above;\nonly its spatial motion moves to the two controls:\n\n```json\n{ \"id\": \"leader-entrance-rig\",\n \"content\": { \"kind\": \"empty\" },\n \"transform\": { \"position\": [540, 600] },\n \"animations\": { \"position\": { \"keyframes\": [\n { \"time\": 0.00, \"value\": [540, 680], \"easing\": \"ease_out\" },\n { \"time\": 0.50, \"value\": [540, 600] }\n ] } } },\n{ \"id\": \"leader-nudge-rig\", \"parentId\": \"leader-entrance-rig\",\n \"content\": { \"kind\": \"empty\" },\n \"transform\": { \"position\": [0, 0] },\n \"animations\": { \"position\": { \"keyframes\": [\n { \"time\": 0.80, \"value\": [0, 0], \"easing\": \"ease_in_out\" },\n { \"time\": 0.86, \"value\": [-12, 0], \"easing\": \"ease_out\" },\n { \"time\": 1.02, \"value\": [30, 0], \"easing\": \"ease_in_out\" },\n { \"time\": 1.22, \"value\": [0, 0] }\n ] } } },\n{ \"id\": \"item-a\", \"parentId\": \"leader-nudge-rig\",\n \"transform\": { \"position\": [0, 0] },\n \"content\": { \"kind\": \"color\", \"color\": \"#61d5ffff\", \"size\": [720, 120] },\n \"animations\": { \"opacity\": { \"keyframes\": [\n { \"time\": 0.00, \"value\": 0, \"easing\": \"ease_out\" },\n { \"time\": 0.50, \"value\": 1 }\n ] } } }\n```\n\nThe small local move left is anticipation, the move through zero to the right is the directional\naction, and the final keyframe resolves at `[0, 0]`. The entrance rig lands before the nudge rig\nstarts. One motion responsibility per track also keeps the entrance and nudge independently\nretimeable. A single long spatial track is also valid; choose controls when separate editing helps.\n\n**Heuristic, not contract.** The `12px` anticipation, `30px` action, and phase durations are trials.\nScale them to the element and viewing size. A nudge can omit anticipation when speed or restraint\nmatters more than character.\n\n**Avoid when.** Do not nudge a decorative element that does not own the direction, repeat the gesture\nuntil it becomes jitter, or copy it to every sibling. Skip the nudge entirely if the cascade already\nspent the beat's attention budget.\n\n**Check.** Query the leader and siblings before, during and after the nudge: only the leader should\ndeviate from its settled position. Inspect playback to decide whether anticipation reads or flickers.\n\n## A persistent shared element\n\n**Intent.** Let the eye follow one object into a new arrangement when its identity matters.\n\n**scene translation.** Keep one layer id and one layer window alive across both states; animate\nits placement delta while subordinate layers leave or arrive around it:\n\n```json\n{ \"id\": \"shared-card\", \"start\": 0, \"duration\": 4,\n \"animations\": {\n \"position\": { \"keyframes\": [\n { \"time\": 1.7, \"value\": [540,720], \"easing\": \"ease_in_out\" },\n { \"time\": 2.3, \"value\": [320,520] } ] },\n \"scale\": { \"keyframes\": [\n { \"time\": 1.7, \"value\": [1,1], \"easing\": \"ease_in_out\" },\n { \"time\": 2.3, \"value\": [0.74,0.74] } ] } } }\n```\n\n**Heuristic, not contract.** Match the path and pace to the surrounding layout; scene requires\nvalid tracks, not a particular duration or scale delta. **Avoid when.** Use two layers when the\nobjects are not semantically identical or cannot share one lifetime. **Check.** Declare the carrier\nwith `present` across the seam, then inspect playback: geometric presence alone cannot prove that\nthe viewer recognizes the same object.\n\n## A direction-matched seam\n\n**Intent.** Continue an already-established whole-frame direction across a clip boundary.\n\n**scene translation.** Use a catalog transition on the track gap; omit the entry for a deliberate\nhard reset:\n\n```json\n\"content\": { \"kind\": \"track\", \"clips\": [\n { \"duration\": 2, \"content\": { \"kind\": \"color\", \"color\": \"#1b2d45ff\" } },\n { \"duration\": 2, \"content\": { \"kind\": \"color\", \"color\": \"#34234dff\" } }\n], \"transitions\": [\n { \"between\": 0, \"id\": \"slide\", \"duration\": 0.6,\n \"params\": { \"direction\": \"left\" } }\n] }\n```\n\n**Heuristic, not contract.** Match direction only when continuation is the message; a cut,\ncrossfade, or reversal may better express punctuation, ambiguity, or interruption. **Avoid when.** Do\nnot spend a transition to disguise an unresolved semantic relationship. **Check.** Preview both\nsides of the actual seam and its midpoint; compare a simple cut when the intended relationship is a reset.\n\n## A causal handoff\n\n**Intent.** Make an action visibly cause a response and reveal instead of reading as three unrelated\nanimations.\n\n**scene translation.** Give the action landing, response onset, and reveal onset one event time;\ntheir later settling times may differ:\n\n```json\n{ \"id\": \"action\", \"animations\": { \"position\": { \"keyframes\": [\n { \"time\": 1.35, \"value\": [230,1350], \"easing\": \"ease_in_out\" },\n { \"time\": 2.2, \"value\": [760,1220] } ] } } },\n{ \"id\": \"response\", \"animations\": { \"opacity\": { \"keyframes\": [\n { \"time\": 2.2, \"value\": 0, \"easing\": \"ease_out\" },\n { \"time\": 2.35, \"value\": 0.85 }, { \"time\": 2.6, \"value\": 0 } ] } } },\n{ \"id\": \"reveal\", \"animations\": { \"position\": { \"keyframes\": [\n { \"time\": 2.2, \"value\": [540,1660], \"easing\": \"ease_out\" },\n { \"time\": 2.7, \"value\": [540,1540] } ] } } }\n```\n\n**Heuristic, not contract.** Share the onset unless latency is an intentional story or interface\nstate; amplitude and settling remain project trials. **Avoid when.** Do not synchronize unrelated\nevents merely because they are nearby in time. **Check.** Query immediately before and after the\nevent, then watch whether action, response and reveal read as one causal sequence.\n\n## Depth from one camera\n\nParallax and an exploded stack, built from one camera move rather than per-layer offsets, are in\n[references/depth-from-one-camera.md](references/depth-from-one-camera.md). Read it before giving layers\ndifferent depths.\n\n## Moving a group without grouping it\n\n`parentId` names a SIBLING whose transform this layer rides — animate the parent, the children come\nalong, and each keeps its own timing, opacity and easing:\n\n```json\n{ \"id\": \"card\", \"content\": { \"kind\": \"color\", \"color\": \"#3355ff\", \"size\": [200, 140] },\n \"transform\": { \"position\": [200, 420] },\n \"animations\": { \"position\": { \"keyframes\": [\n { \"time\": 0, \"value\": [200, 420], \"easing\": \"ease_out\" }, { \"time\": 2, \"value\": [600, 420] } ] } } },\n{ \"id\": \"badge\", \"parentId\": \"card\", \"transform\": { \"position\": [140, 70] },\n \"content\": { \"kind\": \"color\", \"color\": \"#ffcc00\", \"size\": [40, 40] } }\n```\n\n**The child's position is in the parent's local pixel space, not the composition's.**\nWith the default centered anchor, a `[200, 140]` parent pivots at `[100, 70]`, so a child at `[140, 70]` sits 40px right\nof it — and a child at `[500, 400]` is 400px right and 330px down, which is almost never what the\nnumber looked like. Author the child near the parent's box centre and read the offset from there.\nIf the parent's anchor changes, recompute that offset and query the result.\n\nOnly the transform travels — Placement and its `transforms[]` stack, in that order. A child of a\ntransparent parent does not inherit that opacity through `parentId`. For a group\nfade or a group mask, nest the layers in an inline composition instead —\n`{ \"kind\": \"composition\", \"layers\": [...] }` — and put the fade or `mask` on that layer. It is part\nof this scene and shares its assets. A `scene_ref` is a separate document, for a body you reuse.\nBuild a card this way as one group: its backing, image, label and icon in one composition,\nkeyframed once, so its parts cannot drift apart.\n\n**A control layer is the driver you did not have to elect.** `{ \"kind\": \"empty\" }` draws nothing and\nexists to be parented to — After Effects' Null Object:\n\n```json\n{ \"id\": \"rig\", \"content\": { \"kind\": \"empty\" }, \"transform\": { \"position\": [200, 150] },\n \"animations\": { \"rotation\": { \"keyframes\": [\n { \"time\": 0, \"value\": 0, \"easing\": \"ease_in_out\" }, { \"time\": 2, \"value\": 90 } ] } } },\n{ \"id\": \"a\", \"parentId\": \"rig\", \"transform\": { \"position\": [120, 0] }, \"content\": … },\n{ \"id\": \"b\", \"parentId\": \"rig\", \"transform\": { \"position\": [0, 120] }, \"content\": … }\n```\n\nAn empty occupies no area, so it is a POINT — which changes the rule above in the way you want:\nits children's positions are measured from the empty ITSELF (a child at `[0, 0]` sits on it), and\nturning or scaling it swings them around it. It carries no `effects`, `looks`, `mask` or\n`blendMode` — there are no pixels for those, so authoring one is an error rather than a no-op.\n\nQuery the parent and child at rest and during travel; use `translation` only while their sizes and\nrotations remain fixed. A cycle, self-reference or unknown parent id is invalid.\n\n## A focus pull, and a card that turns\n\nBlur and flip are effects rather than transforms, so they compose with motion instead of competing\nwith it. The preset/look choices, checks, stacking behavior, and wipe\nconstruction live in [references/focus-flip-and-wipe.md](references/focus-flip-and-wipe.md).\n\n## A wipe\n\nNothing about a transform can hide half a layer, so a wipe is a mask. Prefer a wipe look when it\nmust stack with other masks; a layer has only one direct `mask` field. See the linked reference above\nfor role slots, directions, reveal presets, checks, and look ordering constraints.\n\n## Drawing a line on\n\nA stroke that appears to be *drawn* — a line, an underline, a checkmark, an arrow, a progress bar — is\none mechanism: a `shape` whose `trim` item is animated. `trim.end` 0 → 1 reveals the stroked path\nprogressively. Order the items `[path, trim, stroke]` — the trim modifies the geometry before it, the\nstroke paints the trimmed result:\n\n```json\n{ \"kind\": \"shape\", \"items\": [\n { \"type\": \"path\", \"closed\": false, \"vertices\": [ { \"point\": [-400, 0] }, { \"point\": [400, 0] } ] },\n { \"type\": \"trim\", \"start\": 0, \"end\": { \"keyframes\": [\n { \"time\": 0, \"value\": 0, \"easing\": \"ease_in_out\" }, { \"time\": 1.2, \"value\": 1 } ] } },\n { \"type\": \"stroke\", \"color\": \"#5b6cff\", \"width\": 18 } ] }\n```\n\nThis path authors an 800px line with a 1.2s reveal. The four\n\"variants\" are the SAME trim track — only the path geometry and stroke change: a 3-point `V` polyline\nis a checkmark, an arrow-shaped path an arrow, and a fat round-capped stroke over a dim full-length\ntwin is a progress bar (the twin is a second layer with no trim — the track, drawn first so the bright\nfill lands on top). `ease_in_out` reads hand-drawn; `linear` reads mechanical, right for a progress\nbar. This lives at the shape-`items` level, which layer presets don't reach, so it is a pattern rather\nthan a preset. Preview the start, partial stroke and completion; verify the intended path direction.\n\nAn ink line that writes on — a signature, a doodle, a character's outline — is the same trim track with a\ntapered stroke (`character-rigging`, \"Ink lines\"). The taper is laid along the drawn part, so the moving\nend keeps its point as it writes on.\n\n## Cartoon fast motion: smears, multiples and speed lines\n\nA dash, a fast wave or a zip exit reads as a cartoon when its fast frames are drawn differently. The\n`smear`, `multiple` and `speed_lines` motion presets read the layer's real motion and draw only above a\nspeed threshold, along the motion. Which layer each goes on, frame counts, the exit zip and how they\ncombine with motion blur are in [references/cartoon-fast-motion.md](references/cartoon-fast-motion.md).\n"
}SHA-256 of public snapshot: 3a3091062f8cab700fe140da13aa0014d30824209147733bc31d934e4ad518cb