Skip to Content
Starlight

Curves and eases

A curve shows how a value changes over time. The timeline's curves view draws one curve for each animated property of the selected layer. Use it to see and shape the motion between keyframes. Press ⌥T / Alt+T to open it.

Open a lane's curve

Open the curves view on the layer and the lane that you want to shape.

  1. Select an animated layer.
  2. Press ⌥T / Alt+T, or click the curve icon at the left of the timeline's header.
  3. To go back to the layers view, press ⌥T / Alt+T again, or click the bars icon.
  • In the layers view, click ∿ on a lane's name. Its tooltip says edit the curve in the curves view. The curves view opens on that lane's layer. The lane is lit (highlighted) and scrolled into view. If one of its keyframes was selected, it stays selected.
  • In the layers view, double-click a keyframe, or right-click it and choose edit curve…. The curves view opens with that keyframe selected.
  • In Properties, right-click an animated row and choose edit curve…. This item shows only when a keyframe is at the playhead. The curves view opens with that keyframe selected.
  • The curves view always shows the selected layer. If the lane belongs to a layer that is not selected, Starlight selects that layer first.
  • The panel stays open on the curves view. ⇧T / Shift+T, Esc or × closes it. Then the panel goes back to your chosen view: the next ⇧T / Shift+T opens that view.
  • These links do not change your chosen view. After a reload, the panel opens in your chosen view again (Open the timeline).
  • A gate has no curve. A double-click on a gate keyframe in the layers view gives the hint a gate holds — no ease.
  • Older versions had a separate curve editor (graph editor) under the lanes of the layers view. The curves view replaces it.

Read the curves view

Each animated property has its own lane, with its own graph. In a graph, higher means a bigger value, and further right means later.

PartWhat it shows
Left of the headerThe two view icons (Open the timeline), the layer's name, and its clock's length and mode, for example 2s · loop.
Middle of the headerThe hint: a short message about what you did (Read the hint).
Right of the headerThe tools: the t and v fields, the ease buttons and the steps field, unified / broken, frame with all and sel, and × (close).
RulerOne cycle of the clock, in the app's units (seconds or frames). Drag it to move the playhead within the cycle.
Gate rowFirst, if the layer has a gate. Bars show when the layer is on (Edit in the curves view).
Lane nameAt the left of each lane, with a thin bar in the colour of its curve. There are six colours. After six lanes they repeat.
CurveThe coloured line in the lane's graph. It is exactly what plays and what an export renders.
DiamondsThe keyframes.
Numbers at the left of the graphThe lane's values.
GridVertical lines at the times that have a label on the ruler. Horizontal lines at round values, with a stronger line at 0.
Named linesCues. Timeline markers show too, but you cannot edit them here.
  • Each lane has its own value range. So a position in pixels and an opacity from 0 to 1 both fill their lane.
  • The numbers are the layer's values, the same numbers as in Properties. Example: a layer at y 600 with a keyframe that moves it up 30 px shows 570.
  • A colour lane (a gradient stop's colour, a shape's fill or stroke, or a text's fill) has no numbers. Its keyframes show as steps 0, 1, 2 and more, filled with their colour. A thin band of its colours runs along the bottom of the lane. You can edit their timing and eases here. Set the colours in Properties.
  • On a pingpong clock, the view shows the forward half of the cycle. The backward half is its mirror. Each keyframe shows once.
  • An effect can have its own clock. Its lanes are drawn across the same width as the other lanes.
  • Lanes are 96 px tall at first. Drag the bottom edge of any lane to make all lanes taller or shorter, from 48 to 480 px. Starlight remembers the height for each scene.
  • Drag the top edge of the panel to make the whole panel taller or shorter.
  • With many lanes, scroll over the lane names to see the others.

Select and move keyframes

Select keyframes, then drag them to change their time and value.

  1. Click a keyframe to select it. To add or remove one, hold ⇧ / Shift and click it.
  2. Or drag on an empty part of a lane's graph to select that lane's keyframes with a box. Hold ⇧ / Shift to add to the selection.
  3. Drag a selected keyframe. Left and right change its time. Up and down change its value.
  • Keyframes selected in several lanes move together.
  • Hold ⇧ / Shift while you drag to move in one direction only: the way you moved most.
  • The time lands on whole frames. Hold ⌥ / Alt to place it between frames. The curves view does not snap to markers or other targets.
  • A keyframe cannot pass its neighbours.
  • Gradient values stay in their range: an offset from 0 to 1, a radius of 0 or more, and a size above 0.
  • A colour keyframe moves only in time.
  • Click an empty part of a graph to clear the selection.
  • To add a keyframe, double-click an empty part of a lane's graph. It takes the value the curve has there.
  • To delete the selected keyframes, press ⌫ / Backspace or Delete. A lane keeps its last keyframe (a lane keeps its last keyframe).
  • To nudge the selected keyframes, press ← or →. They move by 1% of the cycle. With ⇧ / Shift, they move by 5%. These keys work wherever the pointer is.
  • Right-click a keyframe for ease ▸ and delete keyframe.
  • Keyframes on a locked layer do not move (layer locked).
  • Every drag is one undo step. Press Esc during a drag to cancel it.

Type a keyframe's time or value

Type an exact time or value for the selected keyframe.

  1. Select a keyframe.
  2. Click the t field and type a time, or click the v field and type a value.
  3. Press ⏎ / Enter.
  • The fields show the keyframe you clicked last, while it is still selected. Otherwise they show the first selected keyframe.
  • v is the layer's value at that keyframe, as in Properties. Type the value you want the layer to have. Point at the field to see the fixed (static) value and the keyframe's own offset.
  • t is the time within the cycle, as the ruler shows it. It uses the app's units, seconds or frames. You can also type a unit: 1.5s, 45f or 250ms.
  • The keyframe moves to that time. It cannot pass its neighbours.
  • A click outside the field also uses what you typed. Press Esc to leave the field without a change.
  • If the text is not a time or a number, nothing changes. The hint says what to type, for example a time in seconds (1.5) or frames (45f) or a number.
  • A colour keyframe has no v: set its colour in Properties.

Shape a curve with handles

Drag a keyframe's handles to change the shape of the curve next to it.

  1. Select a keyframe in the curves view. Its handles appear: small dots at the ends of thin lines.
  2. Drag a handle. The curve follows.
  3. Release.
  • One handle shapes the curve before the keyframe. The other shapes the curve after it.
  • A handle stays within the time between the two keyframes. Its value is free, so the curve can go past the next value (overshoot).
  • unified (the default) keeps a keyframe's two handles on one straight line. Click it in the header to change it to broken: then each handle moves alone.
  • Hold ⌥ / Alt while you drag a handle to switch between unified and broken for that drag.
  • A handle that sits on its keyframe shows as a short dashed line, for example on linear. Drag it out.
  • When you drag a handle, the segment gets its own custom curve (Make your own curve).
  • On a pingpong clock, the view shows only the forward half, with its handles. The backward half is a mirror of it.
  • Each handle drag is one undo step. Press Esc during the drag to cancel it.
No handles?

Only curve eases have handles. A hold, steps, elastic, bounce or spring part has none. Pick a curve ease first (for example linear), then shape it. Between two keyframes with the same value, the curve stays flat, and the handles move only in time.

Set an ease

An ease is the shape of the motion from one keyframe to the next. Set it for one or many keyframes.

  1. Select the keyframes in the curves view.
  2. Click an ease button in the row of small curve pictures in the header. Point at a button to see its name.
  3. For steps, first type the number of steps in the field after the buttons.
  • The buttons are, in order: linear, ease, ease-in, ease-out, ease-in-out, smooth, snap, overshoot, expo-in, expo-out, expo-in-out, back-in, back-in-out, hold, steps, elastic, bounce and spring.
  • The ease changes the part after each selected keyframe, up to the next keyframe. A lane's last keyframe has no ease.
  • The hint says what changed, for example smooth · 2 segments. With no keyframe selected, it says select keys to ease. With only last keyframes selected, it says the last key has no outgoing segment.
  • When all selected keyframes have the same ease, its button is highlighted. With a custom curve, or a mix of eases, no button is highlighted.
  • Keyframes on a locked layer keep their ease.
  • In either timeline view, right-click a keyframe and choose ease ▸. It lists every named ease, and a dot (●) marks the ease now. steps(n) is only in the curves view's buttons.
  • In Properties, right-click an animated row and choose ease ▸. It sets the ease of the keyframe at the playhead, and it shows only when a keyframe is there.
  • In the YAML, write ease: on a keyframe (Write an ease in YAML).
  • A new keyframe gets smooth.

Eases

Every ease, what it does, and its settings.

EaseWhat it doesSettings
linearThe same speed all the way: a straight line.0, 0, 1, 1
easeThe standard web ease (from CSS)..25, .1, .25, 1
ease-inStarts slow, then speeds up..42, 0, 1, 1
ease-outStarts fast, then slows to a stop.0, 0, .58, 1
ease-in-outSlow at the start and at the end..42, 0, .58, 1
smoothA gentle start and end. The default ease. Good for soft moves, not for hits..4, 0, .2, 1
snapA sharp start and a quick stop. Good for hits..85, 0, .15, 1
overshootGoes past the target, then comes back to it. Good for a pop..34, 1.56, .64, 1
expo-inBarely moves, then leaves at full speed. Good for a launch out of frame..7, 0, .84, 0
expo-outDoes most of the move at once, then slows for a long time. Good for a settle with no bounce..16, 1, .3, 1
expo-in-outStill, a very fast middle, still again. Good for a whip between two holds..87, 0, .13, 1
back-inPulls back the wrong way first, then leaves. A wind-up..36, 0, .66, -.56
back-in-outPulls back first, then goes past the target and returns..68, -.6, .32, 1.6
holdKeeps the value still, then jumps at the next keyframe (hold).none
steps(n)Moves in n equal jumps (steps).n, and start or end
elasticSwings past the target a few times, then settles onto it (elastic).in the scene file: elastic(amplitude, period)
bounceLands with three smaller and smaller bounces (bounce).none (fixed)
springMoves like a spring: a soft overshoot, a small wobble, then rest (spring).in the scene file: spring(bounce)
  • The first eight are curve eases (bezier curves). Their settings are the positions of the two handles: x1, y1, x2, y2. You can shape them with handles.
  • The curves view draws exactly what plays and what an export renders.
  • To make a motion faster or slower, move its keyframes closer together or further apart.

hold

hold keeps the value still until the next keyframe, then jumps to the next value.

  • Use it for a cut, a counter, or a sign that changes from one word to the next.
  • It has no settings. It is the same as steps(1).
  • If the next keyframe is at the end of the loop, the jump comes there, as the loop starts again.
  • A gate always works like a hold, and it takes no ease (gate).

steps(n)

steps(n) moves from one keyframe to the next in n equal jumps.

  1. Select the keyframes in the curves view.
  2. Type the number of jumps in the field after the ease buttons. It starts at 4.
  3. Click the steps button. Its tooltip says steps(4), with your number.
  • Use it for a ticking clock or a stop-motion look.
  • n is a whole number, 1 or more. The field rounds what you type.
  • Each jump comes at the end of its step. With steps(n, start), written in the YAML, each jump comes at the start. steps(n, end) is the same as steps(n).
  • The right-click ease ▸ menus do not list steps.

elastic

elastic goes past the next value, swings back and forth, and settles onto it, like a rubber band.

  • Use it for a lively pop of a logo or a word.
  • The button gives the stock elastic. It always lands exactly on the next keyframe, so a loop never jumps.
  • In the scene file you can set it: elastic(amplitude, period). Amplitude is how high the first swing goes (1 or more), and period is how long one swing takes, as a part of the segment (above 0, up to 1). The stock elastic is elastic(1, 0.3).

bounce

bounce falls onto the next value and bounces three times, each bounce smaller than the last.

  • Use it for something that drops and lands, like a ball.
  • It has no settings: its shape is fixed. It always lands exactly on the next keyframe.

spring

spring moves like a spring: it goes a little past the next value, wobbles once, and comes to rest.

  • Use it for a soft, natural settle. It is calmer than elastic.
  • The button gives the stock spring. It always lands exactly on the next keyframe, so a loop never jumps.
  • In the scene file you can set how far it swings: spring(bounce). spring(0) never passes the target, spring(0.5) is the stock spring, and the most is spring(0.95).

Make your own curve

Make a curve ease of your own when no preset fits.

  1. Select the keyframe at the start of the part you want to shape.
  2. If the part has no handles, click a curve ease, for example linear.
  3. Drag the handles until the curve has the shape you want (Shape a curve with handles).
  • The YAML saves a custom curve as four numbers: [x1, y1, x2, y2].
  • You can also type the four numbers in the YAML (Write an ease in YAML).
  • With a custom curve, no ease button is highlighted. In the right-click ease ▸ menu, no ease has the dot.

Write an ease in YAML

Write ease: on a keyframe in the scene's YAML. These forms work:

ease: overshoot              # a name: a preset, hold, elastic, bounce, spring
ease: steps(4)               # or steps(4, start)
ease: cubic-bezier(.2, 0, .8, 1)
ease: [.2, 0, .8, 1]       # x1, y1, x2, y2 (or { x1: .2, y1: 0, x2: .8, y2: 1 })
  • A keyframe with no ease plays smooth. The last keyframe of a lane needs none.
  • An unknown name is an error.
  • x1 and x2 must be between 0 and 1. y1 and y2 can be outside (overshoot).
  • A gate takes no ease.
  • Eases work the same on transform lanes, effect settings and gradient keyframes.
  • The keyframe format itself is in Clocks & animation.

Zoom and fit

Zoom the curves view in time and in value, or fit it to the curves.

  1. Scroll over a lane's graph, or pinch on a trackpad, to zoom time around the pointer. All lanes follow, as in the layers view.
  2. Hold ⌥ / Alt and scroll over a lane's graph to zoom that lane's values around the pointer.
  3. To move in time, scroll sideways. With a mouse, hold ⇧ / Shift and scroll.
  4. To move a lane's values up or down, hold ⇧ / Shift and scroll up or down on a trackpad.
  5. Click all (beside frame) to fit the whole cycle and every curve. Click sel to fit the time and the values to the selected keyframes.
  • Over the lane names, the wheel scrolls the list of lanes.
  • You cannot zoom out past the whole cycle. all resets the zoom.
  • Each lane has its own value zoom.
  • A lane fits its curve the first time it shows. Then it stays still while you work.
  • sel with no keyframe selected gives the hint select keys to frame. With one keyframe, it shows about ten frames around it.

On this page