> For the complete documentation index, see [llms.txt](https://help.intangible.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.intangible.ai/compose/animation.md).

# Animation

Keyframe animation for cameras, objects, and characters in Compose mode, authored on the shared scene timeline with smooth interpolation by default.

Animate a camera, an object or a character pose by keyframing it: set it one way at one moment in a shot, change it at a later moment, and Intangible interpolates the motion between. All keyframes live on the **scene timeline**, one shared timeline per scene. Shots do not have separate timelines. Each shot is a window into the scene timeline that covers a specific span of scene time, so when you select a shot and scrub the Scene Timeline tab, you see that shot's slice of the scene's animation data.

![Compose mode on the Car pass shot of a three-shot greybox scene, with the Scene Timeline expanded below: Wide, Arc and Car pass on the shot row, a Car pass Camera Transform track keyframed at the shot's start and end, and a Car Transform track keyframed at the scene's start and end, the playhead partway through Car pass](https://1179478100-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FSWrjIqlgVAblx6vHGJiM%2Fuploads%2Fgit-blob-a6d1638ddba21577119df7ee2ed3b418ee5a11f7%2Fcompose-keyframe-tracks-01.png?alt=media)

## What it does

The animation system supports per-scene keyframing on:

* **Camera** position, rotation, lens, and aim target.
* **Object** position, rotation, scale, and visibility (the eye icon in the Outliner).
* **Character pose** (when the character is rigged for it).

Every keyframe lives on the scene timeline. Selecting a shot in the Scene Timeline tab shows the portion of the scene timeline that falls within that shot's time range, and that portion is not a separate timeline. Two shots that overlap the same scene time show the same animation data. A duplicated shot points to the same scene time as its original, so both show identical motion.

Build mode reflects the scene's permanent (non-animated) starting state. In Compose mode, transforms on a selected shot become keyframes that override that starting state for the duration of the shot. To adjust a permanently placed object, such as a building or a set piece, switch to Build mode, where the change creates no unwanted keyframes. Moving that object in Compose mode creates them.

See [Animation and shot time](https://help.intangible.ai/learn-more/concepts/animation-and-shot-time.md).

Smooth interpolation between keyframes is on by default.

## How to use it

The timeline lives at the bottom of Compose mode in the Scene Timeline tab. The playhead is the blue vertical line with the frame number in a blue box at the top. The tracks are horizontal rows, one per animatable property of the active selection.

1. **Pick a shot.** Click a thumbnail in the storyboard. The shot becomes active and its timeline appears below.
2. **Park the playhead at frame zero.** Drag the playhead (the blue vertical line) to the leftmost position. The state of the scene at this moment is the shot's start.
3. **Set the start state.** Move the camera and any subjects to where they should be at the start.
4. **Move the playhead forward.** Drag the playhead along the timeline to where the next keyframe should land. To jump precisely, click the playhead's time label and type a time (see [Setting the playhead by time](#setting-the-playhead-by-time)). The default shot duration is approximately two seconds, and the default scene duration is five seconds. To extend a shot, open the Scene Timeline tab, find the shot's segment (the horizontal span covering the shot's time range), and drag its right edge.
5. **Move objects to the next state.** Drag, rotate, scale. Positioning the playhead alone creates no keyframe. The key appears only when you actually move the object.
6. **Scrub to confirm.** Drag the playhead back and forth. Values between keyframes interpolate. If the motion looks wrong, add an intermediate keyframe at the moment that needs adjustment.

Animation can also be authored from a prompt: from the canvas or Build, ask in the [chat panel](https://help.intangible.ai/chat-agents-intangible/in-the-modes.md#compose) to move an object or orbit the camera, and the resulting keyframes land on the scene timeline as ordinary editable keys.

![Keyframing objects on the scene timeline: move an object at a new playhead position and the keyframe is recorded](https://1179478100-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FSWrjIqlgVAblx6vHGJiM%2Fuploads%2Fgit-blob-f5f25d7ba6f320cbbeaa674ce739f9db3b1e6e24%2Fkeyframe-animation-timeline-01.gif?alt=media)

## Setting the playhead by time

The playhead's blue time label is editable. Click it without dragging, type a time, and press `Enter` to commit. Clicking away also commits, and `Esc` cancels.

![The Scene Timeline with the playhead's blue time label open for editing, a new time typed in](https://1179478100-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FSWrjIqlgVAblx6vHGJiM%2Fuploads%2Fgit-blob-2ec03ea223b0741e049853129916f4fcd614aa66%2Fplayhead-time-edit-01.png?alt=media)

The label reads minutes, seconds and frames with an `f` on the end, such as `01:23:15f` for 1 minute, 23 seconds, frame 15. Hours appear only past the one-hour mark. The ruler labels each whole second the same way (`00:00f`, `01:00f`). The frame count restarts every second, so at 30 fps it runs 0 to 29.

These formats work when you type:

* `MM:SS:FF` – minutes, seconds, frames (e.g. `00:05:12`). The trailing `f` is optional.
* `HH:MM:SS:FF` – the same with hours.
* `MM:SS` – minutes and seconds (e.g. `01:30`)
* A raw number of seconds (e.g. `5` or `1.5`)
* An absolute frame with an `f` (e.g. `34f`)

Two behaviors to know:

* **A selected keyframe moves with the seek.** If a keyframe is selected when you enter a time, the keyframe moves to that frame. If that object already has a keyframe at the destination, the selected keyframe stays put. Typing a time is the fastest way to retime a key precisely: select it, type the destination, press `Enter`.
* **The scene extends if needed.** Entering a time past the current scene duration extends the scene, up to 60 seconds beyond the current duration. Times further out than that are rejected.

Dragging still scrubs. A mousedown-and-drag on the label scrubs the timeline as before, and only a clean click opens the input.

## Interpolation modes

Each keyframe carries an interpolation choice that controls the speed and shape of motion leaving it. Six modes:

* **Easing** (the default). The motion starts slow, runs at roughly constant speed through the middle, and slows into the end. What most people expect from "smooth" animation.
* **Smooth.** Takes the surrounding keyframe positions and fits a smooth curve through them. Use when you have several linear or mismatched keyframes and want the overall path to flow instead of kink at each one.
* **Linear.** Constant speed between this keyframe and the next. Use for mechanical motion or anything where the move should feel deliberate and uninflected.
* **Ease In.** Starts slow, accelerates toward the end.
* **Ease Out.** Starts fast, decelerates into the end.
* **Step.** No interpolation – the value holds, then jumps to the next keyframe. Use for hard state changes or stop-motion looks.

Interpolation is **per keyframe**, not per track. A single track can mix modes: easing out of frame 0, linear into frame 60, step at frame 90.

{% hint style="info" %}
**Mixing modes creates small bumps at transitions.** Crossing from linear into ease-out produces a slight velocity bump at that keyframe. If smooth motion across a mixed-mode track matters, use the Smooth mode at the transition keyframe.
{% endhint %}

**Keyframes inserted mid-segment are always Easing.** When you scrub to a point between two existing keyframes and move an object, the new keyframe is created with Easing interpolation regardless of what the surrounding keyframes use. Change its mode afterward if you want a different feel.

![Six primitives in one scene, each on its own track in the Scene Timeline with a different interpolation mode, animating together when the playhead runs: the stepped object jumps to its position while the eased objects glide in at different rates](https://1179478100-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FSWrjIqlgVAblx6vHGJiM%2Fuploads%2Fgit-blob-f5a07fdecda34ca012915c610d11305092ee1a87%2Fanimation-interpolation-01.gif?alt=media)

## Editing keyframes

Three operations on an existing keyframe:

* **Insert mid-segment.** Scrub the playhead between two existing keyframes and edit the object. A new keyframe lands at the playhead, splitting the segment in two. Each half gets its own interpolation choice. Use it to correct an in-between value without re-keying the start or end of the move.
* **Retime.** Drag a keyframe along its track to shift when its value lands. Surrounding segments stretch or compress to match. Use this to slow a specific beat down or rush past one without redoing the keyframes themselves.
* **Delete.** Select a keyframe and delete it. The motion reverts to whatever the surrounding keyframes describe. If the deleted keyframe was the only one on the track between frame 0 and the end, the object holds its frame-0 state for the rest of the shot.

![Dragging a middle keyframe along its track to retime a beat, with the surrounding segments stretching to match](https://1179478100-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FSWrjIqlgVAblx6vHGJiM%2Fuploads%2Fgit-blob-3399e66787dae033ee7f38581fbe7ca4f6fdcde3%2Fanimate-05-retime-drag.gif?alt=media)

### The start keyframe: open vs filled diamond

The diamond at the start of a track tells you where the object's start state comes from:

* An **open (empty) diamond** means the object is starting from its **Build-mode position**. You haven't keyed a start state in Compose; the object begins wherever Build placed it.
* The diamond **fills solid** the moment you change the object's position at the start time. That gives the object its own Compose start keyframe, which overrides the Build position for this shot. The Build position itself is unchanged.

To repoint the start without touching Build: create a keyframe elsewhere on the track, then drag it on top of the open start diamond. The dragged keyframe overrides the start keyframe and becomes the new start state. The object's Build-mode position stays as it was, so the rest of the scene is unaffected.

## Pose animation for characters

Characters with rigs animate per-pose, not per-bone. The contextual menu on a character object exposes a **Pose** dropdown with dozens of preset poses. Pick a pose at one keyframe and another pose at a later keyframe, and the character interpolates between them.

For example, set "standing" at frame 0 and "running" at a later frame, and the character animates the transition.

## Parented animation

Parent–child relationships are honored during playback. A child follows its animated parent while keeping its own keyframed motion, and the two motions compose. Animate a car, parent a driver into it, and the driver rides along; give the driver their own keyframes and that motion plays on top of the car's.

The cases that work:

* **Only the child is animated.** A bike rides down a static mountain. Parenting doesn't change the motion.
* **Only the parent is animated.** A car drives down a street with a driver inside. The driver follows with no keyframes needed on the child.
* **Both are animated.** A ship's wheel spins while the ship banks through a turn. The wheel's spin composes against the ship's motion.
* **Parent removed mid-project.** A skydiver parented to a plane jumps: clear the parent and the skydiver's own keyframes take over in world space.
* **Parent changed.** An arrow loosed from horseback sticks into a running deer: re-parent the arrow from the archer to the deer.

A child's keyframes are stored relative to its parent. Changing or clearing a parent recomputes the child's existing keyframes so its world-space motion is preserved. The parent relationship itself is not animatable, so you can't keyframe a parent swap. To stage a handoff like the arrow example, change the parent and adjust the child's keyframes around the moment of transfer.

Set and clear parents with the [Parent tool](https://help.intangible.ai/build/working-with-objects.md#parenting) in Build mode.

## Camera-aim animation

When a camera has a target object (see [Aim Camera and Target](https://help.intangible.ai/compose/aim-camera-and-target.md)) and the target is animated, the camera follows automatically, with no manual rotation keyframes needed. An aim target is the cleanest way to do follow shots: animate the subject and let the camera track.

A camera aim target restricts certain camera moves. Because the camera must constantly point at the target, the target controls where the camera looks, and tilt and pan are no longer freely keyframeable. You can still track (move laterally), boom (move vertically), and roll the camera on its axis. If you need to break away from the target mid-shot, remove the aim constraint first.

## Authoring crane moves, dolly arcs, and complex camera trajectories

Author these moves with keyframes. Place the camera at frame 0, scrub the playhead forward, place the camera at the next keyframe, repeat for as many waypoints as the trajectory needs. The smoothing default does the curve work between keyframes for most cinematic moves.

If a move needs a precise curve, key the position more densely – four or five keyframes across a two-second move usually carry the shape cleanly.

## How the three Compose-mode tabs relate

The Compose-mode bottom panel exposes three tabs:

* **Storyboard** – every shot in the project as a card grouped by scene. Author-time view. See [Storyboard view](https://help.intangible.ai/compose/storyboard-view.md).
* **Sequence** – the assembled cut, shots end to end as time-bound segments. Edit-time view. See [Timeline](https://help.intangible.ai/compose/timeline.md).
* **Scene Timeline** – per-object animation tracks within the active scene, the most granular view. Animation-authoring view.

Think of the three as viewing filters into the same time-based scene data. Storyboard groups by scene. Sequence orders by playback time. Scene Timeline drills into per-object keyframe tracks for the **one selected shot**. It shows only the currently active shot and does not show all shots at once. To see multiple shots in time order, use the Sequence tab. The same animation data underlies all three views; switching tabs only changes which dimension you're looking at.

## Turn keyframed movement into a curve

Keyframes put an object at a position on a frame, and the route between those positions is whatever the interpolator draws. **Convert Animation to Motion Curve**, in the **…** menu with a single object selected, builds a [motion path](https://help.intangible.ai/build/motion-paths.md) through the positions the object already animates through, puts the object on it, and rewrites the timing as Progress keyframes along the curve. The motion plays back the same, and the trajectory becomes editable.

**Convert Animation to Motion Curve** needs translation keyframes that actually move the object. It is not offered for an object that is already on a path. See [Motion paths](https://help.intangible.ai/build/motion-paths.md#turn-an-animation-you-already-have-into-a-path).

## Common mistakes

{% hint style="warning" %}
**Don't author motion in Build mode and expect it to animate.** Build-mode transforms commit globally to the scene's permanent state, and only Compose-mode transforms (with a shot active) become keyframes. If your render came back static, motion authored in Build mode is the most likely cause.
{% endhint %}

* **Animating without keyframing the start state.** A keyframe at frame 30 with no keyframe at frame 0 means the start state is "whatever the scene was when you last touched it", not "at the start of this shot". Always set frame 0 first.
* **Moving permanent objects in Compose mode.** If you need to reposition a building, a backdrop, or any scene element that shouldn't animate, go back to Build mode to do it. Moving objects in Compose mode (with a shot active) creates keyframes, so that building will now move during playback.
* **Cross-shot animation is continuous, not per-shot.** Because all animation lives on the scene timeline, a character walking at frame 10 keeps walking through frames that fall under any shot covering that range. You don't need to re-set up the same motion in each shot. To review how motion reads across a cut, use the Sequence tab. The Scene Timeline only shows one shot at a time.

## Limits and known issues

* **The default shot duration may not match your edit duration.** The default shot duration is approximately two seconds; the scene timeline defaults to five seconds. To extend a shot, open the **Scene Timeline** tab (not the Sequence tab) and drag the right edge of the shot's segment.

## Where your animation lands in Visualize

The keyframes you set in Compose feed directly into video generation. Two paths to know about:

* **Default video modes.** The visualizer reads the per-frame state of the scene and passes it through to the chosen video model. Most models honor the motion within their own interpretation. See [Generate video](https://help.intangible.ai/visualize/generate-video.md).
* [**Video (from scene)**](https://help.intangible.ai/visualize/video-from-animation.md)**.** A dedicated visualizer mode that uses your keyframes as the explicit motion source. It offers motion-guided AI model options plus [Direct Render](https://help.intangible.ai/visualize/direct-render.md) (non-AI wireframe capture); see [Video (from scene)](https://help.intangible.ai/visualize/video-from-animation.md) for the current options. Use this mode when motion fidelity to your blocking matters more than the model's interpretation.

## Related

* [Animation and shot time](https://help.intangible.ai/learn-more/concepts/animation-and-shot-time.md)
* [Shots](https://help.intangible.ai/compose/shots.md)
* [Aim Camera and Target](https://help.intangible.ai/compose/aim-camera-and-target.md)
* [Timeline](https://help.intangible.ai/compose/timeline.md)
* [Storyboard view](https://help.intangible.ai/compose/storyboard-view.md)
* [Motion paths](https://help.intangible.ai/build/motion-paths.md) – drawing the route instead of keyframing every position, and converting an animation you already have into one
* [Video (from scene)](https://help.intangible.ai/visualize/video-from-animation.md) – how your keyframes drive video gen.
* [Direct Render](https://help.intangible.ai/visualize/direct-render.md) – capture the animated scene as wireframe video, no AI.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://help.intangible.ai/compose/animation.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
