Skip to main content

Animation Curve Editor

The Animation Curve Editor provides an interface to author and edit animation curves, including transform animations on scene objects with transport controls, keyframe recording, and Bezier tangent handles.

  • Available on all platforms
Platform details: Snapchat, SPECS, Camera Kit Web, Camera Kit Mobile fully supported.

Platform details

  • Snapchat — Fully supported.

  • SPECS — Fully supported.

  • Camera Kit Web — Fully supported.

  • Camera Kit Mobile — Fully supported.

The Animation Curve Editor lets you edit animation curves. Use it for two workflows:

  • Script-driven curve assets—float/vec3 curves sampled at runtime via script. Useful for VFX, UI, or any property animation.
  • Transform animation—add keyframes to position, rotation, and scale on scene objects via an AnimationPlayer component.

For a step-by-step guide to transform animations, see Animating Scene Objects.

For curves in materials and VFX, see Curves in Materials and VFX.

Opening the Editor

  • From the Window menu—Window → Editors → Curve Editor.
  • Double-click an AnimationAsset in the Assets panel.
  • Via the Animate action—right-click a scene object and choose Animate. The editor opens with the new curves loaded. See Animating Scene Objects.

Selection-driven loading

Select a scene object with an AnimationPlayer component and the editor loads the first clip's curves. No manual asset selection needed.

Adding a Script-Driven Curve Asset

To create a standalone curve asset:

  1. In the Assets panel, click the + button.
  2. Select Animation Curve Track.

Add curve tracks via the asset's Inspector panel.

Clips Bar

Select a scene object with an AnimationPlayer to show the Clips Bar in the toolbar area. Each animation clip appears as a pill button.

Animation Curve Editor showing the Clips Bar with a selected clip pill, transport controls, frame counter, zoom readout, and the scrubber playhead while dragging
  • Click a clip pill to load that clip's AnimationAsset.
  • The active clip appears highlighted.

The clips bar appears only when your selection includes an AnimationPlayer, and the Record button is disabled without one. Step Back, Play / Stop, Step Forward, and the frame counter appear only while Record is on. For standalone curve assets, the clips bar is hidden and Record is disabled, so none of these controls are available.

Transport Controls

Use these transport controls in the toolbar to preview animations:

Animation Curve Editor toolbar showing the Record button as a red dot, Step Back, Play, Step Forward, frame counter, and zoom readout
ControlAction
RecordStarts or stops keyframe recording. The button turns red when on. The editor captures transform changes as keyframes. See Keyframe Recording.
Step BackMoves the playhead back one frame.
Play / StopToggles AnimationPlayer autoplay. The icon switches between a triangle for play and a square for stop.
Step ForwardAdvances the playhead one frame.
Frame counterShows the current frame and total frames—for example, 12 / 60.
Zoom labelShows the canvas zoom level on both axes.

Scrubbing

With Record on, click and drag the time ruler to scrub through the animation. The playhead and frame counter update as you drag. The scene updates on release, creating one undo entry per scrub.

Playhead

While Record is on, a vertical playhead line—with a triangle handle at the top of the ruler—marks the current time. It moves as you scrub, step, or play.

Scrubber playhead dragged to frame 11, with transform curves visible in the canvas

Keyframe Recording

With the Record button on, moving or scaling an object in the Scene Editor viewport adds keyframes at the scrubber time.

Recording workflow

  1. Enable the Record button—it turns red when on.
  2. Move the scrubber to the desired time.
  3. Drag, rotate, or scale the object in the viewport.
  4. The editor writes a position, rotation, and scale keyframe on release.

The editor overwrites existing keyframes at the same time. Recording turns off whenever the editor loads a different animation asset, for example when you click another clip pill or select an object with a different animation. Turn Record back on to keep recording.

For a complete recording walkthrough, see Recording Keyframes.

ActionMacWindows
Pan ViewShift+Left-click+DragShift+Left-click+Drag
ZoomScroll WheelScroll Wheel

Selecting and Editing Curves

Click a curve in the list on the left, or click a keyframe control point on the canvas, to select it.

ActionMacWindows
Drag Control PointLeft-click + DragLeft-click + Drag

Adding a keyframe

Right-click an active curve in the canvas and choose Add Key to insert a new keyframe at that position.

Mid-curve inserts use Bezier subdivision, so the curve keeps roughly its original shape around the new keyframe. The neighboring keyframes keep their times and values, but their handles facing the new keyframe are shortened to fit the split.

Editing a keyframe

Right-click a control point to open the options menu:

OptionEffect
Edit KeyOpens a dialog where you type a new time and value for the keyframe.
Remove KeyDeletes the keyframe.
Right Tangent / Left TangentSets the tangent type for the outgoing or incoming handle.
Presets → LinearSwitches the segment to linear. No handle appears.
Presets → EaseInBezier ease-in.
Presets → EaseOutBezier ease-out.
Presets → EaseInOutSmooth ease on both sides.

Tangent Types and Bezier Handles

Tangent types

Each side of a keyframe (left/incoming and right/outgoing) has its own tangent type, set from the Left Tangent and Right Tangent submenus:

TypeBehavior
FreeDrag each Bezier handle to shape the curve. When the other side is also Free or Clamped, the handles stay in line and each keeps its own length. Keyframes added with Add Key or by recording use this type.
LinearStraight line between keyframes. No handles appear.
ConstantHolds the value until the next keyframe—a step function.
BrokenBezier handles that move independently of each other.
ClampedBezier handles that stay in line; dragging one gives the other the same length.

Per-segment tangent visibility

Handles appear based on each segment's tangent type. A curve can mix linear and Bezier segments. For example, a position track can snap to a key and then ease out.

Curve canvas showing recorded keyframes—the yellow Z-axis track has a smooth Bezier arc from a transform drag, while the green and orange tracks remain flat
  • The out-tangent handle on keyframe N shapes the curve leaving that key.
  • The in-tangent handle on keyframe N+1 shapes the curve arriving at the next key.

Runtime fidelity

When Lens Studio converts the animation for the Lens, it samples non-linear Bezier tracks at the asset's frame rate, so the runtime result matches the editor curve. Properties whose tracks are all linear are exported as their keyframes, without resampling.