Canvas
The canvas is the centre of the window, and it is always open. It shows every surface as it will play. You select, place and arrange layers on it.
The parts of the canvas
This table shows where each control of the canvas is.
| Where | What it is |
|---|---|
| Above each surface | The surface's caption, for example N — 6400×1600. Click it to select the surface. Drag it to move the surface (Arrange the surfaces). |
| Top right | focus shows only the surfaces of one comp (Focus on one comp). The Stage panel opens with ⇧S / Shift+S or Window › Stage (Stages). |
| Bottom left | The transport: ▶ (play and pause) and the time. With a work area set, a chip shows it, for example loop 1.00–2.00 s × (Loop a part of the scene). With the FPS HUD on (⇧I / Shift+I), the frame rate shows here too (FPS HUD). A red number such as 28 fps beside the time means that frames are dropped while the scene plays (The red frame rate). |
| Bottom centre | A short line that shows for a moment: the scene's name after you switch scenes, or the file's name after a drop. |
| Bottom right | The zoom, for example 88.3%. Click it for a list of zoom levels and a zoom slider (Zoom, pan, fit). To its right is the fit button. Its tooltip is fit all surfaces (⇧1). |
| Around a surface | A thin grey frame just outside the surface means the surface shows the viewer, not the output. |
- The shape of the pointer shows what a press will do. A pointing hand: the press selects a layer. A four-way arrow: the press moves a surface. An open hand: the press pans the view. A closed hand: you are panning the view.
Select a layer
Click a layer on the canvas to select it and show it in Properties.
- Click the layer. The click picks the smallest layer under the pointer.
- See and edit it in Properties (⇧P / Shift+P opens it).
- To deselect, click empty space, or press Esc.
- The graph level decides what a click can pick. The node graph shows one level at a time: the top level, or the inside of one comp. Inside a comp, a breadcrumb (the row of level names at the graph's top left) shows where you are.
- At the top level, a comp (a named group of layers) placed on a surface counts as one layer. A click selects the transform that places it.
- If more than one surface shows the same comp (like the panorama), a click selects the comp itself, not the transform on that surface. That transform moves only this surface's part of the picture. A comp has no handles, so the picture cannot go out of line by mistake. To move a layer, double-click to go inside the comp.
- On a surface that a comp feeds, a click on the comp's art selects that comp. A comp has no handles. A drag on it moves the surface.
- Double-click to go inside a comp. A double-click on the comp's art selects the layer under the pointer, inside the comp. It selects the layer's transform, so you can drag it at once or change it in Properties. The node graph steps into the comp too.
- Inside the comp, a click selects the comp's own layers on that surface. A comp inside this comp is again one layer. Double-click it to go one level deeper.
- To go back out, click another surface or empty canvas, or press Esc. You go back to the level where your first double-click started. Usually this is the top level. Esc also clears the selection. A right-click on a layer of another surface goes back out too.
- On the same surface, a click next to the inner comp goes back out to the level that has a layer under the pointer.
- A double-click on a path edits its points (Edit a path's points). With ⇧, ⌘, ⌃ or ⌥ (Shift, Ctrl, Alt) held, a double-click does not go inside a comp.
- You can also step into a comp in the node graph: double-click it there. Then a click on the canvas picks inside the comp.
- When you step in or out, Starlight deselects what the new level does not show.
- A layer is two nodes: the content (an image, a text, a gradient) and the transform that places it. A click selects the transform, because a drag moves the transform. See A layer's two sheets.
- A faint outline shows what a click would pick.
- An outline shows only the part of a layer that is on its surface, because nothing outside a surface is visible. If the layer goes past the surface's edge, the outline has short dashes along that edge.
- An adjustment layer has no edges of its own. Its outline is its whole surface. This is also true when you select one of its effects.
- You cannot click a hidden layer, or a layer locked in the timeline. A bypassed picture, shape, text or video is hidden, and so is everything in a bypassed
use. The layers of a bypassed transform or group still show, so you can click them. - Click a surface's caption to select the surface itself.
- A press that moves less than 6 px counts as a click, not a drag.
- To delete the selected layer, press ⌫ / Backspace or Delete. You can undo it.
Select several layers
Add layers to the selection one click at a time, or draw a box around them.
One click at a time.
- Click the first layer.
- Hold ⇧ / Shift and click each other layer.
- To take a layer out of the selection, hold ⇧ / Shift and click it again.
With a box (marquee).
- Press the right mouse button on the canvas. On a Mac trackpad, click with two fingers and keep the click pressed.
- Drag. A dashed box shows.
- Let go. The box selects every layer that it touches.
- ⌘ / Ctrl and ⌥ / Alt work the same way as ⇧ / Shift.
- On a Mac, Control-click works too, and it never opens the context menu. A right-click or a two-finger click opens the menu.
- With one of these keys held, a click on empty space keeps the selection.
- The last layer you add gets the handles, and Properties shows it.
- To move all the selected layers together, drag any one of them. They all move by the same amount. The arrow keys move them all too (Nudge with the arrow keys).
- The squares and the round knob change only the layer with the handles.
- A click on a selected layer, without a drag, selects only that layer, as before.
- Hold ⇧ / Shift during the drag to move the layers only left and right, or only up and down.
- The layers snap as one box: the box around all of them. The centre of the box snaps to the centre of the surface and to the centres of the layers beside them, never to the selected layers. Hold ⌘ / Ctrl during the drag to snap the edges of the box instead (Snap with ⌘ / Ctrl).
- A locked layer does not move. A selected surface does not move with the layers.
- If x or y of a layer is animated, the drag sets a keyframe at the playhead, as for one layer (Change an animated layer).
- Press ⌘Z / Ctrl+Z once to undo the whole drag.
- Surfaces, comps and clocks do not join a selection. With any of these keys held, a click on one selects only that one.
- The box. Without a key, the box replaces the selection. A box over no layer clears the selection. Hold ⇧ / Shift, ⌘ / Ctrl or ⌥ / Alt to add the layers to the selection.
- The box selects what a click could select. It picks at the node graph's current level: at the top level, or inside the comp that you went into with a double-click (Select a layer). If a ✥ transform places a layer, the box selects the transform.
- A layer counts when the box touches it. The box does not need to hold the whole layer. Only the part of a layer that is on its own surface counts.
- The box selects the layers that it touches, not the group around them. It selects a group only when it touches the group but none of the group's layers.
- The box skips surfaces, comps and clocks. It also skips hidden layers and layers locked in the timeline.
- The top layer that the box touches gets the handles.
- A right-click that moves less than 6 px opens the context menu, as before. A right-drag never moves a surface.
- On a Mac, a Control-click never draws a box. It adds a layer or takes it out.
- The node graph has a box too: right-drag there.
Move, scale, rotate
Drag the handles of the selected layer to move, scale or rotate it.
- Click the layer. Handles appear around it, and they turn with the layer.
- Drag one of the parts in the table below.
- To undo, press ⌘Z / Ctrl+Z.
| Drag | What it does |
|---|---|
| Inside the box | Moves the layer. Hold ⇧ / Shift to keep it horizontal or vertical: the direction you dragged most. Its centre snaps to the centre of the surface and to the centres of the layers beside it. Hold ⌘ (Mac) / Ctrl (Windows) to snap its edges instead (Snap with ⌘ / Ctrl). |
| A corner or edge square | Scales the layer. An edge square scales one direction only. Hold ⇧ / Shift to keep the proportions. Hold ⌥ / Alt to scale from the centre. |
| The round knob above the top edge | Rotates the layer around the ringed cross. The pointer becomes a round arrow. |
| The ringed cross | Moves the anchor: the point that the layer turns and scales around. The layer itself does not move. Hold ⇧ / Shift to keep it on one axis. |
- If the layer is animated, a drag sets a keyframe at the playhead. The other keyframes stay as they are. If keyframes of that property are selected in the timeline, the drag moves those keyframes instead (Change an animated layer).
- The anchor is the same point for the fixed (static) scale and rotation and for the animated ones.
- A new layer's anchor is the centre of the layer. So a new layer scales and turns around its middle. This is true for shapes, gradients, text, images, videos, cloners, the paths you draw and new comps with a frame (Comps with a frame). Drag the ringed cross to move it.
- A new layer appears where it always did. Only the anchor is in the middle now. In Properties, x and y show where the middle of the layer is.
- Sometimes Starlight cannot read the size of a picture when you add it (for example, a file that is not on this computer yet). Then the anchor is the picture's top-left corner, as in older versions.
- Layers that are already in a scene keep their anchor. Nothing in an older scene moves.
- You can press or release ⇧ / Shift during a drag. The lock changes at once.
- When you move a layer, its centre snaps to the centre of its surface and to the centres of the other layers. Hold ⌘ (Mac) / Ctrl (Windows) during the drag to turn this off. Then the edges snap instead (Snap with ⌘ / Ctrl).
- The handles take a press only on the layer's own surface, or just outside its edge. A press on another surface is for that surface. A press further out on empty canvas pans. This is true even where the layer's box reaches over there.
- If you picked the content in the graph, the canvas shows only its outline. Drag it, and Starlight selects and moves its transform.
- Some layers have no transform of their own, for example one of several layers inside one transform. They show only an outline, with no handles. A drag on them moves the surface. Move them in Properties instead.
- A bypassed layer that you select shows faded handles. You can still drag them. A bypassed transform does not place its layers, so a drag changes nothing on the surface until you switch it back on.
- A layer locked in the timeline does not move.
- To change the layer order, press ⌘] / Ctrl+] or ⌘[ / Ctrl+[ (Wire and reorder layers).
A drag that starts on a layer that is not selected moves the whole surface on your canvas (Arrange the surfaces). Click the layer first, then drag it.
Change an animated layer
On an animated layer, a drag on the canvas changes the layer only at the playhead. This is the same as typing a number into Properties. If you select keyframes in the timeline first, the drag moves those keyframes instead. This is how After Effects works.
- Move the playhead to the frame you want to change.
- Click the layer to select it.
- Drag the layer, a square or the round knob.
- Starlight sets a keyframe at the playhead for each animated property that you change. If a keyframe is already at the playhead, that keyframe changes.
To move the whole animation, or only a part of it:
- In the timeline, select the keyframes of the property. For example, right-click the x lane and choose select all keys in the lane. Do the same on the y lane.
- Drag the layer on the canvas.
- Every selected keyframe of that property moves by the same amount. No keyframe is added at the playhead.
- The other keyframes do not change. Move the playhead to check another frame.
- Selected keyframes of x, y, rotation and skew all move by the same number. Selected scale keyframes are all multiplied by the same number, so 100% and 150% both grow by a tenth.
- Select only some keyframes to move only that part of the animation. A property with no selected keyframes still gets a keyframe at the playhead.
- The lanes and the curves view show the new values while you drag.
- A property with no keyframes changes its fixed (static) value, as before. Example: only x is animated, and you drag the layer down and right. Starlight sets an x keyframe and changes the fixed y.
- When a drag sets a keyframe, playback stops. You see the frame that you change. If the playhead was between two frames, it moves to the frame of the new keyframe.
- A message tells you when a move sets a keyframe, for example: y is animated: the move sets a key at frame 160 only. On the other frames, the layer is where the animation puts it. To move the whole animation, select the keyframes first (see the steps above).
- If an audio drive controls a property (for example, y follows the bass), a drag changes the fixed value of that property. The drive still moves the layer from there. A keyframe would not show, because the drive controls the property.
- When the scale is animated, a square scales the layer around the ringed cross, not from the opposite corner. So the position at the other keyframes stays the same.
- When only
scaleis animated (notscaleXorscaleY), the layer keeps its proportions. - The arrow keys follow the same rules (Nudge with the arrow keys).
- Press ⌘Z / Ctrl+Z to undo the drag.
In older versions, ⌘ (Mac) / Ctrl (Windows) during a drag moved the whole animation. Now select the keyframes first, as in the steps above. During a drag, ⌘ (Mac) / Ctrl (Windows) only changes the snapping. For a layer, the edges snap instead of the centre (Snap with ⌘ / Ctrl).
In a scene from an older version, an animated layer can have no anchor. Its animation then turns around the middle of the layer. The ringed cross shows this point. The first time you rotate or scale the layer with the handles, or drag its cross, Starlight sets the anchor at this point. The layer does not move. In Properties, the anchor now has a value, and x and y show where the anchor is.
Nudge with the arrow keys
Move the selection in exact small steps with the arrow keys.
- Select one or more layers, or a surface.
- Point at the canvas. The arrow keys nudge only while the pointer is over the canvas.
- Press ↑ ↓ ← → to move 1 px.
- Hold ⇧ / Shift to move 10 px, or ⌥ / Alt to move 0.1 px.
- If you hold both keys, ⌥ / Alt wins: the step is 0.1 px.
- If x or y is animated, the arrow keys set a keyframe at the playhead (Change an animated layer).
- If keyframes of x or y are selected in the timeline, the arrow keys move those keyframes instead. So to move a whole animation 1 px, select all its x and y keyframes and press an arrow.
- The steps are in the surface's design pixels: the pixels of the size that you design the surface at.
- Every selected layer moves. A selected surface moves on your canvas only. To put a surface back, press ⌘Z / Ctrl+Z: arrow presses in a row are one undo step (Arrange the surfaces).
- If you picked the content in the graph, the first arrow press selects its transform and moves it.
- A layer locked in the timeline does not move.
- A selected comp or clock does not move. The arrows walk through the graph instead.
- While other keyframes are selected in the timeline (not x or y of the selected layer), ← and → move those keyframes in time, one frame.
- When the pointer is not over the canvas, the same keys move through the graph instead (Select and navigate).
- With nothing selected, ← and → step one frame, or 10 frames with ⇧ / Shift.
Snap with ⌘ / Ctrl
Hold ⌘ (Mac) / Ctrl (Windows) during a drag to change the snapping while you hold the key. If snapping is on, it is off while you hold the key. If snapping is off, it is on. This works the same way on the canvas and in the timeline. It is the After Effects habit.
- Start to drag a layer, a surface, a bar, a keyframe or a marker.
- Press and hold ⌘ (Mac) / Ctrl (Windows). You can press it at any time during the drag.
- Let go of the key to go back. Release the mouse button to drop.
| You drag | Without the key | While you hold ⌘ / Ctrl |
|---|---|---|
| A layer on the canvas (a move) | The centre of the layer snaps to the centre of its surface: to the middle line across and to the middle line up and down. It also snaps to the centres of the other layers beside it. Cyan guides show the snap. Several selected layers snap as one box, the box around all of them | The centre does not snap to the surface or to the layers. The edges of the layer snap to the edges of its surface, and to the edges and equal gaps of the other layers beside it. The surface's guides catch the edges and the centre (Rulers and guides). Cyan guides show the snap |
| A surface on the canvas | Snaps to the other surfaces | No snapping. The surface goes exactly where you drag it |
| A bar, a bar's end, a keyframe, a marker or the work area in the timeline | As the snap button says (n) | The opposite of the button. Whole frames still apply |
- A snap catches within 8 screen pixels.
- To place a layer freely near a centre, hold ⌘ (Mac) / Ctrl (Windows). To place it freely near an edge, let go of the key.
- ⇧ / Shift works as before, together with the key: it keeps a move on one axis, keeps the proportions when you scale, and starts a selection box in the timeline.
- In the timeline, ⌥ / Alt still places a drag freely, between frames, with no snapping at all.
- The scale squares, the rotate knob and the curves view do not snap to other things, so the key changes nothing there.
- On a Mac, use ⌘. ⌃ (Control) does not change snapping.
- A click is not a drag. A ⌘ (Mac) / Ctrl (Windows) click still adds a layer to the selection, or takes it out.
- The key has no other meaning during a drag. To move a whole animation, select its keyframes first (Change an animated layer). To move only a layer's in and out points, use Move In/Out Only (Move a layer in time).
Scale a layer to fit a surface
Scale to Fit makes a layer the size of its surface in one step. It also puts the layer in the middle of the surface.
- Right-click the layer on the canvas or in the node graph.
- Choose scale to fit.
- Choose a mode from the table below.
- To undo, press ⌘Z / Ctrl+Z. The whole fit is one step, for example Scale to Fit Height.
| Mode | What it does |
|---|---|
| width | The layer is as wide as the surface. The height follows the layer's shape, so the layer can be taller than the surface. |
| height | The layer is as tall as the surface. The width follows the layer's shape. |
| fill | The layer covers the whole surface. Some of the layer can be cut off at two edges. |
| inside | You see the whole layer. There can be empty space at two edges. |
You can also do this in two other places:
- In Properties: select the layer's transform. Under transform, the fit row has four buttons: width, height, fill, inside.
- In the command palette: select the layer, press / and type scale to fit (Run any command).
Which surface the layer fits:
- A layer on a surface fits that surface. Starlight uses the surface's design size: the pixels you design the surface at.
- A layer in a comp fits the surface that shows the comp.
- Some comps are shared by several surfaces, for example a panorama around the room. Each surface shows its own slice. Then the layer fits the surface that you work on: the surface you double-clicked into, or the surface you clicked or right-clicked the layer on.
- If Starlight cannot tell which surface you mean, it shows a list of the surfaces. Choose one.
- A layer in a comp with a frame fits the frame, not a surface (Comps with a frame).
- The layer keeps its shape. Starlight never stretches it.
- The layer's size is the size of its content: the pixels of an image or a video, the box of the text, the size of a shape or a gradient.
- The anchor (the ringed cross) can be anywhere. The layer still lands in the middle of the surface.
- If the layer is rotated, Starlight fits the layer as if it were not rotated. Then the rotation turns it around its anchor, so its corners can go past the surface.
- If the position or the scale is animated, Starlight sets a keyframe at the playhead. The other keyframes do not change (Change an animated layer).
- An older animated layer with no anchor first gets an anchor in its middle. The layer does not move.
- Claude can do this too, with the
fit_layertool. Ask, for example: Fit the plate on E1 to the surface height.
Make a clip loop
Most video does not loop. The last frame does not match the first frame, so the picture jumps each time the loop starts again. Make Loop fixes this in one step.
- Right-click the video layer on the canvas or in the node graph.
- Choose make loop….
- Set the options (see the table below). The sheet shows how long the loop will be.
- Click preview. Starlight makes the loop and moves the playhead to the middle of the blend, so you can see it. Press Space to play it.
- Click make loop to keep it, or cancel to take it back.
- To undo later, press ⌘Z / Ctrl+Z. The whole loop is one step.
How it works:
- Starlight cuts the clip in the middle. It plays the second half first, then the first half.
- So the loop starts on the middle frame of the clip and ends on the frame just before it. The loop point has no jump.
- The real cut, from the end of the clip back to its start, is now in the middle of the loop. There the two halves overlap.
- In the overlap, the first half comes in through moving patches of noise. This looks more natural than a plain crossfade.
- The loop is shorter than the clip by the overlap. An 8 second clip with a 1 second overlap makes a 7 second loop.
- The layer stays where it is. Its position, scale and anchor do not change.
| Option | What it does |
|---|---|
| overlap | How long the two halves blend, in seconds. The default is 1 second, or a quarter of a short clip. The clip must be at least twice as long as the overlap. |
| dissolve | noise: the first half comes in as soft patches. crossfade: a plain fade. |
| noise size | The size of the patches, in pixels. Bigger patches look calmer. |
| softness | How soft the edges of the patches are. 0 is a hard edge. |
| set the scene loop | Sets the scene's loop to the loop's length. Leave it on: the loop has no jump only when the scene loop is the same length. If you turn it off, the scene loop must be at least as long as the loop. Then the loop plays once each time the scene loops. |
Tips:
- Slow footage (clouds, smoke, water): use a long overlap, big patches and soft edges.
- Fast footage (crowds, particles): use a short overlap and small patches. Then a moving thing is not shown twice for long.
- Make Loop does not work on a video with a delay. Remove the delay first.
- A camera move (a pan or a push-in) does not loop well. The two halves are framed differently. Use a short overlap, or a crossfade.
- The loop is made of normal layers: two copies of the video with a
trim, and a matte. The matte reads a group of two rects: a black one, and a white one with thenoiseandthresholdeffects. You can change them in Properties. See the scene format docs for the fields. - Claude can do this too, with the
make_looptool. Ask, for example: Make the cloud clip loop.
Zoom, pan, fit
These controls change only your view of the canvas, never the scene.
| Scroll · pinch · ⌘ / Ctrl + scroll | Zoom in or out around the pointer |
| ⇧ / Shift + scroll · swipe sideways | Pan. With a mouse wheel, ⇧ / Shift + scroll pans sideways. |
| Drag empty space | Pan. A drag that starts on a surface moves the surface. |
| Middle-button drag | Pan, anywhere: also over a surface or a layer. Use it when a surface fills the screen. It never selects, moves or opens anything. The pointer is a closed hand while you pan. |
| ⇧1 / Shift+1 · the fit button (bottom right) | Fit every surface in view. Over the node graph, ⇧1 / Shift+1 fits the graph. Use the 1 key above the letters. On a keyboard where you need ⇧ / Shift to type a 1 (for example French AZERTY), that key is Actual Size: use the fit button or View › Fit All. (A bare f is focus. ⇧F / Shift+F goes to the first frame.) |
| 1 | Actual size: the surfaces' real pixels |
| The zoom (bottom right) | Shows the zoom as a percent, for example 88.3%. Click it for a list of zoom levels and a slider (below). |
| ⌥R / Alt+R · ⌘; / Ctrl+; | Show or hide the rulers · the guides (Rulers and guides). In the View menu: Rulers and Guides. In the command palette: rulers and guides. |
| + or - | Zoom in or out around the centre. = and _ work too. |
| View menu | Zoom In (=), Zoom Out (−), Fit All (⇧1) and Actual Size (1). In the command palette: zoom in, zoom out, fit view and zoom to 100% (or type actual size). |
To pick a zoom from the list or the slider:
- Click the zoom at the bottom right of the canvas, beside the fit button. Its tooltip is zoom: click for levels. A menu opens above it.
- Click fit all surfaces, or click a level: 10%, 25%, 33.3%, 50%, 100% (actual size), 200% or 400%. A dot (●) marks the level that you see now.
- Or drag the slider at the bottom of the menu. The canvas zooms while you drag. Near a level of the list, the slider stops on that level, so it is easy to get exactly 100%.
- To close the menu, press Esc, click the zoom again, or click anywhere else.
- 100% is actual size, the same as the 1 key.
- Below 100%, the zoom has one decimal, for example
88.3%(but50%, not50.0%). From 100% up, it is a whole number, for example250%. The zoom shows100%only at actual size. - The list and the slider zoom around the centre of the canvas, like the + and - keys. The wheel and a pinch zoom around the pointer.
- When you zoom out, the canvas draws a proxy: a smaller, lower-resolution copy. Video uses proxies too. This keeps a big room fast.
- When you zoom in, only the surfaces that you can see get sharper, and only their videos change to the full-size file. The other surfaces keep what they have. The change happens when you stop zooming. The surfaces sharpen about a fifth of a second later. The videos change about a third of a second later, or one second later while the scene plays. So a quick zoom in and out while the scene plays does not change the videos.
- The change of video is smooth while the scene plays. The surface shows the old video until the new one plays at the same frame. This takes up to one second.
- Some computers cannot play a full-size file, for example an HEVC file on a computer with no HEVC decoder. Then the surface keeps its proxy, and the log says why one time. After that, the canvas does not try that file again, unless the file changes.
- This is also true when the file plays only its sound, with no picture. And it is true when the file does not answer for 20 seconds. Other surfaces still get sharper when you zoom in on them.
- A still for Claude (
render_still) can use the proxy of such a file. Then Claude's result says so in one line. An export never uses a proxy. It stops and names the file (When a file cannot render). - At 100% and closer, every surface shows its real pixels, the true LED grid.
- Each scene remembers its own view.
- A scene with no saved view opens with every surface in view, as ⇧1 / Shift+1 does. This is true in every project, also for a scene with the same name as a scene in another project (for example
01-main). - While you draw with the pen or edit a path, Space, 1, + and - do nothing, so the view stays still. A middle-button drag still pans. The path does not change.
- The surface captions move with the surfaces when you pan or zoom.
- When you open another project or another scene, the captions show the new surfaces at once.
Arrange the surfaces
Place the surfaces on your canvas so the room is easy to work on. This changes only your view, never the output.
- Find the surface's caption above it, for example
N — 6400×1600. - Drag the caption, or the surface itself, to a new place.
- Near another surface, the dragged surface snaps to its edges, its centre or an equal gap. Cyan guides show the snap.
- Press ⌘S / Ctrl+S to keep the new arrangement.
- A snap catches within 8 screen pixels. Surfaces more than 2000 px away (centre to centre) do not catch. Surfaces that a focus hides do not catch either.
- An equal-gap guide shows the size of the gap, in pixels, as a small number.
- Hold ⌘ (Mac) / Ctrl (Windows) while you drag to turn snapping off and place the surface freely (Snap with ⌘ / Ctrl).
- Hold ⇧ / Shift to keep the surface on one axis. It still snaps along that axis.
- Click a caption to select the surface. The caption then shows light with dark text, so you can see which surface is selected. Properties then shows the surface's sheet (A surface's sheet). The caption's tooltip says select surface · drag to move it.
- With a surface selected, a press up to 8 px outside its edge still grabs it.
- The arrow keys move a selected surface too (Nudge with the arrow keys).
- When you zoom out, a caption gets shorter or moves to the surface's left, so captions never cover each other.
- The arrangement is not part of the output, Glimpse or export. In a shared project it is saved for each computer.
- Ask Claude to arrange the surfaces. In the Claude panel, say what you want, for example: Put E2 and S side by side. Keep the other surfaces stacked. The surfaces move at once. Claude saves the new arrangement at once, but not your unsaved changes to the scene. The move is one undo step: ⌘Z / Ctrl+Z puts the surfaces back. The undo message says Claude: move 2 surfaces, for example. Claude cannot move the surfaces while you drag one.
- The arrangement is saved in a file,
layout.json. When this file changes outside Starlight (Claude, another app, or a version that you restore), the surfaces move on the canvas at once. This is not an undo step, and it does not make the scene unsaved. - A surface that you moved and did not save yet stays where you put it. If the file moved that surface too, a bar asks which place you want. Click Use the file's to move the surface to the file's place, or Keep mine to keep your place. Your place goes into the file when you save.
- ⌘S / Ctrl+S saves only the surfaces that you moved. A change to another surface in the file stays. If you moved no surface, the file does not change.
- When you open another project, its surfaces take the places from its own file. Surfaces with the same names do not keep the places that they had in the other project.
- Undo a surface move: press ⌘Z / Ctrl+Z. One drag is one undo step. Arrow presses in a row are one step too. ⇧⌘Z / Ctrl+Shift+Z moves the surface again (redo). The undo message names the surface, for example undid: move surface N.
- ⌘Z / Ctrl+Z undoes what you did last. Surface moves and edits to your layers are in one list, in the order that you did them.
- A surface move belongs to the undo list of the scene that was open when you moved the surface. In another scene, ⌘Z / Ctrl+Z does not undo it. Go back to that scene to undo it there.
- In the scene file, surfaces are under
surfaces:(Surfaces & fit).
Rulers and guides
Rulers show the size of a surface in its own pixels. Guides are thin cyan lines on a surface. Layers snap to them, so you can line things up. Like the surface arrangement, guides change only your view, never the output.
Show the rulers.
- Press ⌥R (Mac) / Alt+R (Windows), or choose View › Rulers.
- A ruler shows along the top and along the left of the canvas.
- Move the pointer over a surface. The rulers count in that surface's pixels. 0 is the surface's left edge (top ruler) and its top edge (left ruler).
- Press the key again to hide the rulers.
Make a guide.
- Show the rulers.
- Press on the top ruler and drag down, for a horizontal guide. Press on the left ruler and drag right, for a vertical guide.
- A small box beside the pointer shows the surface and the position, for example
N · y 540 px. - Release on a surface. The guide belongs to that surface. If you release off the surfaces, or back on the ruler, no guide is made.
Change a guide.
- Move: drag the guide. The pointer becomes a double arrow over a guide. The guide stays on its surface, between its edges.
- Exact position: double-click the guide. Type the position in the surface's pixels, for example
540, or a part of the surface, for example50%. Press ⏎ / Enter. Esc cancels. - Delete: drag the guide back onto a ruler, or out of the canvas, and release. The box says release to delete the guide.
- Hide or show all guides: press ⌘; (Mac) / Ctrl+; (Windows), or choose View › Guides. Hidden guides do not snap. A new guide from a ruler shows the guides again.
Snap to a guide.
- Drag a layer on the surface.
- Hold ⌘ (Mac) / Ctrl (Windows). Guides catch a layer only while you hold the key, as the edges do (Snap with ⌘ / Ctrl).
- The layer's edges and its centre snap to the surface's guides. A cyan line shows the snap.
- Guides are saved with the surface arrangement, when you press ⌘S / Ctrl+S. So a surface's guides show in every scene of the project.
- ⌘Z / Ctrl+Z undoes a new, moved or deleted guide. Each one is one undo step. The message names the surface, for example undid: add guide on N.
- Guides and rulers are never in an export, Glimpse or a still image (render_still).
- A guide moves with its surface when you move the surface.
- A press on a guide moves the guide, not the layer under it. To drag that layer, hide the guides first (⌘; / Ctrl+;).
- Surfaces that a focus hides do not show their guides.
- ⌘R / Ctrl+R is still Reload.
Drop media on a surface
Drag an image or an asset onto a surface to place it there as a new layer.
- Drag an image file from Finder or File Explorer, or a tile from the Assets panel. You can drag several image files at once. You can also drag a done job from the Generations panel (Use a result).
- Drop it on the surface, at the place you want it.
The new layer appears at the drop point, on top of the other layers, inside a new transform. Where it lands:
- At the top level of the graph: in the comp that the surface uses, or else in the surface's own layers.
- With the node graph inside a comp: in that comp.
- On empty space, off the surfaces: in the centre of the scene's first comp. With the graph inside a comp, it goes into that comp. A scene with no comps gets a new comp called
dropped, shown on the first surface.
What happens next.
- The new layer is an unsaved change, like any edit: the scene gets its amber dot. Press ⌘S / Ctrl+S to save it. ⌘Z / Ctrl+Z takes the new layer away again (the notice says, for example,
undid: drop logo.png). - A file from Finder or File Explorer is copied into Assets at once. That copy is kept even if you undo the layer.
- The file name shows for a moment at the bottom of the canvas, for example
placed 3: a.png, b.png, c.png. If the drop fails, the line starts withimport failedorplace failed. - Image files you can drop: PNG, SVG, JPG, WebP and GIF. HEIC, HEIF, TIFF, EXR, AVIF, BMP, TGA and DPX work too: Starlight turns them into PNG.
- Drop several image files at once, and Starlight places every one. The first lands at the drop point. Each next one lands a little down and to the right of the one before, so none hides another. One ⌘Z / Ctrl+Z takes them all away.
- Videos, audio and fonts in the same drop are not placed or imported. The line names them:
not placed: clip.mp4 — drop videos, audio and fonts on their own. Drop them again, alone.
Other files.
- A video, audio or font file from Finder or File Explorer goes into Assets, and the panel opens. Starlight does not place it: drag its tile onto a surface.
- A folder of numbered frames goes into Assets as one video (Import files).
- A video tile adds a video layer, inside a transform, like an image.
- An audio tile adds a sound with no position.
- A
.cubefile (a colour look-up table) is not a layer. Pick it in aluteffect. - New layers from the command palette land where you work too (Add a node).
Draw a path or a mask
Use the pen to draw a mask or a plain vector path. A mask is a shape that cuts a layer, so only the part inside shows.
- Start the pen. For a mask, select the layer and press ⇧M / Shift+M. For a plain path, run pen in the command palette (⌘/ / Ctrl+/).
- Click on the surface to add a corner point, or click and drag to add a smooth point.
- Add more points the same way.
- Click the first point to close the shape. Or press ⏎ / Enter to leave it open.
| Click | Adds a corner point |
| Click and drag | Adds a smooth point. The drag pulls its handles. |
| ⇧ / Shift | The point lands level with the last one, or straight above or below it. A handle pulls horizontal or vertical. |
| Click the first point | Closes the path (three points or more) and finishes. A ring shows on the first point when a click would close it. |
| ⏎ / Enter | Finishes the path open |
| ⌫ / Backspace or Delete | Removes the last point. With no points left, the pen stops. |
| Esc | Cancels the path |
- Other ways to start a mask: click ✎ in the matte section of Properties, or pick draw mask on selected node in the command palette.
- Another way to start a plain path: right-click empty graph and pick create ▸ pen.
- With nothing selected, ⇧M / Shift+M does not start the pen. A notice says
draw mask: select the node to mask first. - While the pen is on, the pointer is a cross. For a mask, a notice says
pen: draw the mask for <layer> — close the path to finish. - The path belongs to the surface that the pointer was over when the pen started. If the pointer was not over a surface, the path belongs to the surface of your first click. A first click off the surfaces does nothing.
- If the pointer was over a surface, an empty path layer appears at once, selected. If you cancel the pen, it goes away.
- A path needs at least two points. With fewer, nothing is made.
- A plain path goes into the comp that you are inside in the node graph, the same as a drop. At the top level of the graph, it goes into that surface's comp. A surface without a comp gets a new one, named after the surface.
- A closed path is filled with the brand kit's primary colour. An open path is a 4 px line in that colour.
- A mask puts the layer inside a matte node (the node that does the cut), and Starlight selects that node.
- On a layer that already has a mask, the new shape replaces the old one.
- A closed mask fills. An open mask cuts along its line (its stroke).
- If you clicked the layer on the canvas, ⇧M / Shift+M masks the content inside it. So the mask moves with the layer.
- To use a shape you already have as a mask, see Masks (use selection as mask).
- To undo a new path, press ⌘Z / Ctrl+Z twice. The first press removes the shape. The second removes the empty path layer.
- All pen keys: Keyboard & mouse › Pen and paths.
Edit a path's points
Change the points of a path or a mask after you draw it.
- Double-click the path on the canvas. Its points and handles appear.
- Change the shape with the actions in the table below.
- To finish, press Esc or ⏎ / Enter, or click away from the path.
| Drag a point or a handle | Moves it. Hold ⇧ / Shift to keep it on one axis. |
| Drag the pill on a handle's line | Turns and scales both handles of that point together |
| Click a segment | Adds a point there. Keep the button down to drag the new point at once. Over a segment, the pointer shows a plus. |
| ⌥ / Alt + click a point | Removes it. ⌘ / Ctrl + click works too. You can also point at it and press ⌫ / Backspace or Delete. |
| Double-click a point | Switches it between corner and smooth |
| Double-click a handle | Lines the other handle up with it |
| Drag the lavender ring (masks only) | Feathers the mask: makes its edge soft. A band shows the inner and outer limits of the soft edge. |
- You can double-click only a path at the node graph's current level. For a path inside a comp, first double-click it once to go inside the comp. Then double-click the path again (Select a layer).
- A path keeps at least two points. The last two cannot be removed.
- A drag starts after the pointer moves 6 px, so a click never moves a point.
- The selected point is amber.
- A mask's shape is not drawn, but you can still double-click it on the canvas.
- The lavender ring sits beside the middle of the first segment. When the pointer is over it, a label shows the value, for example
feather 12 px. - A feather drag is one undo step. Esc during the drag puts the old value back.
Right-click on the canvas
A right-click (or a two-finger click) opens a menu for what is under the pointer.
| Right-click on | The menu |
|---|---|
| A layer | Selects the layer and opens its menu. It is the same menu as in the node graph. If the layer is part of a selection of several layers, the selection stays. The menu then acts on all of them. |
| A surface's empty area | fit surface, export that surface as a video, and scene ▸ to open another scene. The export item is grey while an export runs. |
| Empty space | fit all, zoom 100%, and toggle items that show or hide the graph, the timeline and each panel |
- On a Mac, Control-click never opens the menu. It adds the layer to the selection.
- The menu opens when you let go of the button. If you move more than 6 px first, you draw a selection box instead (Select several layers).
- All the items of these menus: Menus.
Play and pause
Start and stop playback while you work on the canvas.
- Press Space to play. You can also click ▶ at the bottom left of the canvas.
- Press Space again to pause.
- The scene always loops. With a work area set (i and o), only that part plays (Loop a part of the scene).
- Playback shows the scene's frames, at the scene's fps, as an export does.
- If your computer cannot show every frame, a red number such as
28 fpsshows beside the time. It shows only while the scene plays. What it means and what to try: The red frame rate. - Right-click ▶ or the time for the transport buttons: frame steps, keyframe and marker jumps, and the work area (Use the clock dials).
- Click the time beside ▶ to switch between seconds and frames.
- If you open a scene that moves while playback is paused, paused · space to play shows there for a few seconds.
- All playback keys: Transport.
Focus on one comp toggle f
Show only the surfaces that one comp feeds (shows on). The other surfaces hide and stop rendering (drawing frames). This saves a lot of work in a big room. For example, one 3200×1600 surface of a 24640×1600 room is about one eighth of the pixels.
- Select a comp, or anything inside it.
- Press f, or click focus at the top right of the canvas. The view fits the surfaces that are left.
- To bring every surface and your old view back, press f again.
You can also use View › Focus on Comp, or focus on comp in the command palette. Focus is the canvas partner of the graph's viewer, and the two work together.
| What you select | What focus shows |
|---|---|
| A comp | Every surface that uses it: directly, or through a use: or a clone.of at any depth |
| A layer inside a comp, an effect chip on it, or a matte input | That comp's surfaces |
| A surface, or a layer in a surface's own layers | That surface only |
| Several of these | All their surfaces together |
| A clock, an audio node, or nothing | Nothing. The hint reads "select a comp, a layer or a surface to focus". |
| A comp that feeds no surface | Nothing. The hint reads "comp <name> feeds no surface — wire it to a surface in the graph". |
- While focused: f with the same surfaces (or nothing) selected ends the focus. With a selection in another comp, it focuses there.
- ⇧1 / Shift+1 fits only the surfaces that show. A click picks only on them.
- If you select a node of a hidden surface in the graph, the focus stays. The hint reads "the selection is on a hidden surface — F to refocus".
- It follows the wiring. Wire the comp to another surface, and that surface appears. Wire it away from its last surface, and the focus ends ("focus ended: <name> no longer feeds a surface").
- The colour: the focus button and the captions of the surfaces that show turn lavender, the graph's comp colour. Nothing covers the art.
- A hint under the button says why f did nothing, when there is a reason. It goes after 6 seconds, or when you select something.
- The button's tooltip says what focus does. While focus is on, it names the comp and says that the other surfaces are hidden.
- ⇧S / Shift+S opens the Stage panel.
- For this session only: focus is never saved. Opening another scene or project ends it. A pan during focus is not remembered.
- The Glimpse panel sees every surface. While it is open, the hidden surfaces keep rendering for the 3D room. So focus saves less work then.
- Deliverables never see focus. Export, the reel,
render_still, the comp thumbnail,tiles_checkand Glimpse publish always render every surface. - The Stage panel sits beside the canvas and never holds it. Focus works as always while it is open. While the Stage panel has the keys, f frames the stage instead, and ⇧1 / Shift+1 only says the canvas’s keys: click the canvas, then f to focus or ⇧1 to fit.
- Over a generation preview, the menu and palette command say "close the preview to focus". The focus button closes the preview first.
- Claude can read and set focus with the MCP
canvas_focustool.