Properties
Properties is the sheet for what you selected. Use it to edit and animate values, and to add masks, blend modes and effects. Press ⇧P / Shift+P to show or hide it.
Read the sheet
The sheet shows what is set, plus the main fields of each kind of layer.
- Select a layer on the canvas, in the node graph or in the timeline.
- If Properties is not open, press ⇧P / Shift+P.
- To see a section's other fields, click N more at the top right of the section. Click less to hide them again.
- To fold or open a section, click its title.
- The panel's subtitle names what you selected. Examples are
transform › gradient,text "Hello",effect · blur,surface · Nandclock · scene. - Properties remembers which sections you opened with N more. It remembers this for each kind of layer, on this computer. Effect cards remember it for each effect name.
- Related fields share a row: position
x | y, sizew × h, and scalexandy. - Between the two scale fields is a link button. With the link on, one value drives both. The link is on at the start when x and y are the same.
- When one axis is animated, it gets a row of its own.
- A file path (src, a clone's of, a LUT file) uses all the width after its label. When it is too long, the folders at the start are cut first, for example
…/video/pr-listening-room.mp4. The file name stays whole. Only a very long file name is cut in the middle, and it keeps its extension. Point at the path to see all of it. Make the panel wider to see more of it. - An empty section shows only its title and its buttons. matte has ✎ and +, and effects has +.
- A group's sheet has only the top strip, matte and effects. An audio layer has no blend and no matte.
- With nothing selected, the sheet reads select a node.
- Float or dock the panel like any other panel: Float, dock and pin.
The top strip
The strip at the top of a layer's sheet names the layer and holds three buttons.
| The id | The layer's name in the scene. Point at it to see its kind and its id. The panel's subtitle shows its kind too. |
| ◇ (gate) | Adds a gate: a timed in and out, so the layer shows only inside its bars. A new gate shows the layer for the first half of the loop, and the timeline opens on it. Edit the bars in the timeline. Click the lit ◇ to remove the gate (Gates). |
| ⊘ (bypass) | Switches off what the node adds, like b. A picture, shape, text or video hides. A transform or group keeps showing its layers, without its own position, animation and effects (Turn a node off). Click it again to switch the node back on. |
| ⋯ | Shows the blend row (Set a blend mode) and the delay row (Delay a layer). It is there only while they are unset. A blend that is not normal, or a delay that is not 0, always shows its row. A comp instance (use:) always shows its delay. An audio layer has no ⋯. |
| placed by ✥ … · places ▤ … | Links between the two halves of a layer (A layer's two sheets) |
Sections of a layer's sheet
Each kind of layer has its own sections. This table lists every section and what it holds.
| Section | What it holds |
|---|---|
| keyframe | Shows at the top when you select a keyframe tick on a clock dial in the node graph. It holds the keyframe's property, time (ms and frames) and value. × deselects it (Edit a keyframe from a dial). |
| transform | Position, scale and opacity. Under N more: rotate, skew and anchor (the point the layer turns around). |
| text | content, font, size, weight (100 to 900) and fill. Under N more: letterSpacing and align (left, center or right), and letters by, order and stagger ms (Letters one after another). fill has a ◇ to animate the colour (Keyframe a property). |
| shape | shape (rect, ellipse or line), size and fill. Under N more: stroke, strokeWidth, trimStart, trimEnd, trimOffset (Trim paths) and radius. fill, stroke and the three trim values each have a ◇ to animate them (Keyframe a property). |
| path | fill. Under N more: stroke, strokeWidth and the trim values (Trim paths). The colours and the trim can be animated, as on a shape. A note counts the subpaths. Double-click the path on the canvas to edit its points (Edit a path's points). |
| gradient | Kind (linear or radial), its angle or its centre and radius, size, and the stops bar (Edit gradient stops) |
| image | Its file (src, read-only). With a cutout effect, a preview of the cut-out subject. |
| cutout | Its file and a preview of the subject that Starlight cuts out of the photo. The preview reads extracting… while Starlight works. A Mac makes the cut-out (Apple Vision) and saves it in the project, so other computers show it too. When there is no cut-out, the preview says why, for example cutout not made yet – open on a Mac to make it, and the layer shows the whole photo (Cut a subject out of a photo). |
| video | Its file, and loop and muted on the playback row. Both are on for a new video. |
| audio | Its file, volume, and muted, loop and export on the play row. Under N more: offset ms (An audio layer's sheet). |
| audio (notes) | The length, the tempo (bpm), the key, and the song's sections, drops and climax. + beat clocks from N bpm makes named clocks on the beat (Music). |
| clone | of (read-only), count and gap, and direction (x, y, grid or radial). For a grid: rows × cols and gapY. For a ring (radial): radius in px. Under N more: drift px/s (drift °/s on a ring) and stagger ms (Cloners). |
| particles | of (read-only; soft dot when there is none), rate and life, the emitter (point, line, rect or ellipse) with its size or length and from (area or edge), angle and spread, outward, speed and size, and color. Under N more: seed, the ± randoms, gravity, drag, spin, turbulence, trail and max. A note says how many particles it draws (Particles). |
| reference | use: the comp that this layer places, read-only (use) |
| adjustment | Opacity, what it adjusts and its cost (Use an adjustment layer) |
| animation | The layer's timing, once something is animated: length and mode, or the shared clock it uses, and one line per lane (The animation section) |
| drives | Each drive: a property that follows a band of the music, for example scale ← kick [1‥1.2]. ⧉ bakes it into keyframes that you can edit, and × removes it. To add a drive, write it in the scene's YAML (Drives). |
| matte | The layer's mask (Mask a layer) |
| effects | One card for each effect, with the colour ops in a color group at the top (Add effects) |
A layer's two sheets
A placed layer is two nodes, and each node has its own sheet.
- Click the layer on the canvas. This selects its transform: the node that places it, with position, scale, rotation, opacity and the animation.
- To open the content (the image, text or gradient itself), click places ▤ … in the top strip.
- To go back to the transform, click placed by ✥ … on the content's sheet.
- The content's sheet has what makes it, for example a text's font or a gradient's stops. Its own matte and effects are there too.
- Beside placed by, a link like ↻ 10s loop opens the transform's animation in the timeline.
Change a value
Change a number by typing, with the keys, or by dragging.
- Click in the field and type a number. The value changes as you type.
- Press ⏎ / Enter, or click away, to finish.
| ↑ or ↓ in the field | Steps the value. Hold ⇧ / Shift for 10 steps. |
| Drag the row's label | Scrubs the value: drag left or right. Hold ⇧ / Shift for steps 10 times finer. On a paired row, drag the axis letter (x, w). |
| Middle-drag the row | Opens the value ladder (below) |
The value ladder. Hold the middle mouse button on a number. Move up or down to pick the step: 100, 10, 1, 0.1 or 0.01. Move sideways to change the value by that step.
- Move 12 pixels sideways to change the value by one step.
- The ladder opens on the field's own step. Changing the step never makes the value jump.
- Whole-number fields stop at a step of 1.
- The pointer locks while you hold the button, so you can drag past the edge of the screen. A ring shows where the hidden pointer is.
- Release the button to keep the value, as one undo step. Press Esc to put the old value back.
- Every number field in the app has the ladder.
- A value always stays inside its field's limits. For example, opacity stays between 0 and 1.
- On an animated row, each of these ways sets a keyframe at the playhead (Live values).
Find a property
Filter the sheet so it shows only the rows you want.
- Click the magnifier in the Properties title row. Or point at Properties and press ⌘F / Ctrl+F.
- Type part of a name in filter parameters, for example
opacity. - Press ⏎ / Enter to keep the filter and close the field.
- To clear the filter, press Esc in the field, or click its ×.
- Initials work:
srfinds shadowRed. Word starts work too:hi blfinds highlightBlue. - The filter also finds rows behind N more, and opens folded sections.
- A section's name shows all its rows, for example
transform. An effect's name shows its whole card, for exampleblur. - Notes and buttons hide while you filter.
- The filter stays while you click through layers. While a filter is set, the magnifier stays lit. Point at it to see the filter text, and click it to edit the text.
- With the pointer anywhere else, ⌘F / Ctrl+F finds a node in the graph instead.
Pick from a list
Every dropdown in Starlight is the same picker, and you can search the long ones.
- Click the dropdown. With the keyboard, press ⏎ / Enter, ↓ or ↑ on it.
- Type to search a long list. In a short list, typing jumps to a match.
- Press ⏎ / Enter, or click the entry, to pick it. In a short list, Space picks it too.
- A list of more than 20 entries has a search field. Examples are the blend modes, a big font list and the generation models.
- Search by word starts:
nbpfinds Nano Banana Pro. Any word of the name works too. - ↑ ↓, Page Up, Page Down, Home and End move through the list.
- Esc or a click outside closes the list. Tab closes it and moves to the next field.
- A ✓ marks the current value.
- Space does not open a picker. Space stays play and pause.
- A grey entry cannot be picked. The reason shows beside it.
Pick a colour
Set a colour from your brand colours, or type a hex code.
- Click the colour's swatch.
- Click a colour under brand tokens. Or type a hex code under custom hex.
- For a hex code, press ⏎ / Enter or click set.
- A brand token is a named brand colour. It keeps its name (
$primary), so it follows the brand kit. - The field shows the token's name, or the hex code.
- Write
#rrggbb, or#rrggbbaafor a colour with alpha (transparency). You can leave out the#. - With no brand colours, the list reads no colour tokens.
- A click outside the box closes it. Esc closes it too, and the layer stays selected. The Properties panel stays open.
- To grade colour (curves, levels, hue, exposure), add a colour op (Add effects).
Edit gradient stops
A gradient's stops are markers on one bar. Each stop is one colour at one place along the gradient.
| Drag a marker | Moves the stop. If it passes another stop, the two swap. |
| Drag a marker off the bar | Removes the stop. A gradient keeps at least two stops. |
| Click a marker | Selects the stop and opens its colour |
| Click the empty bar | Adds a stop there, with the colour already at that place |
| ← or → (bar focused) | Nudges the selected stop by 0.01. Hold ⇧ / Shift for 0.1. |
| ⌫ / Backspace or Delete (bar focused) | Removes the selected stop |
- Under the bar, the stop N row edits the selected stop: its offset (0 to 1) and its colour. Its × removes the stop.
- Point at the bar for a short list of these actions.
- Each drag is one undo step. Esc during a drag puts the stop back.
- The selected stop's offset and colour each have a ◇ to animate them (Keyframe a property).
- While the gradient is animated, the bar shows it at the playhead. A small gold diamond marks a stop that moves or changes colour.
- On an animated colour, a brand token you pick stays a token on its keyframe. If the brand colour changes, the animation changes too.
Keyframe a property
Animate a property from its row. A keyframe saves a value at one moment in time.
- Click the faint ◇ at the start of the row. The property is now animated, and the timeline opens on its lane (its row of keyframes).
- Move the playhead to another time.
- Change the value. This adds a keyframe at the playhead.
- Repeat steps 2 and 3 for more keyframes, then press Space to play.
| The chip | What a click does |
|---|---|
| Faint ◇ | Starts the animation. A transform row starts with keyframes that change nothing, so the layer does not jump. An effect setting (a param), a gradient setting, or a shape's or a text's colour starts with one keyframe at the playhead. |
| Gold ◇ | The property is animated. A click adds a keyframe at the playhead. |
| Gold ◆ | The playhead is on a keyframe. A click removes it. |
| Drag the ◇ | Drop it on a clock dial in the node graph. The property then uses that clock's timing. |
- Point at a chip to read what a click and a drag will do.
- A transform row always keeps its last keyframe. When you remove an effect param's last keyframe, the param goes back to one fixed value.
- Beside an animated row, ▸ opens its keyframe list. Point at ▸ to see how many keyframes the row has.
- The list has one line per keyframe: time ms, the value, and × to remove it. × is grey on the last keyframe.
- Sometimes a transform row's fixed value is not 0 (or 1, for scale and opacity). Then the value column reads offset (or × factor). The keyframes add to (or multiply) the fixed value, and the row above shows the result.
- The list also has + key at playhead and open in timeline ↗.
- Beside the row, ↻ 10s loop names the clock that sets its timing (⟲ beat for a shared clock).
- Click ↻ or ⟲ to jump to the layer's animation section. For an effect with its own timing, or one on the scene loop, the click opens the timeline instead.
- The animation section shows the length, the mode and one line per lane (The animation section).
- Click a keyframe tick on a clock dial to edit that keyframe. The keyframe section at the top shows its time and value (Edit a keyframe from a dial).
- To set an ease (the shape of the motion between two keyframes), right-click the row (Right-click a property). Or use the timeline's curves view.
- Timing, clocks and the lanes: Timeline and Clocks.
Animate a shape's colour. A shape's or a path's fill and stroke can change colour over time. Use this for a focus colour that comes and goes.
- Select the shape. Move the playhead to where the change starts.
- Click the ◇ beside fill. This keeps the colour it has now.
- Move the playhead. Click the colour's swatch and pick the new colour. This adds a keyframe.
- Press Space to play.
- While the colour is animated, its row shows the colour at the playhead in gold.
- Between two keyframes the colour changes smoothly. Starlight mixes the colours in OKLab, so a blue to pink change stays bright in the middle.
- To fade a colour in or out, use a colour with alpha:
#rrggbbaa. For example#ffffff00is clear white. - A brand token can be a keyframe. It follows the brand kit.
- In a scene file, write a list of colours in place of one colour:
- shape: rect
size: 400x120
fill: ["#1E3A8A", $team.gold, "#1E3A8A"] # blue, gold, blue
clock: { period: 2s } # one cycle every 2 seconds
Animate a text's colour. A text's fill animates in the same way. Use this for a word that flashes gold when a team scores.
- Select the text. Move the playhead to where the change starts.
- Click the ◇ beside fill.
- Move the playhead. Pick the new colour. This adds a keyframe.
- Press Space to play.
- All of the text changes colour together. This includes italic and bold words in a markup text.
- A text's stroke (its outline) animates in the same way. It changes apart from the fill.
- The animation is fast. Starlight draws the letters one time and then only changes their colour.
- In a scene file:
- text: GOAL
size: 160
fill: ["#FFFFFF", $team.gold, "#FFFFFF"] # white, gold, white
clock: { period: 2s }
The animation section
The animation section shows a layer's timing. It appears once something on the layer is animated.
- length is how long the animation is, in seconds (s) or frames (f). It follows your choice of units (Show seconds or frames).
- Beside the length, mode is once, loop or pingpong (Play modes).
- A layer that uses a shared clock shows timing from ⟲ beat · 2s loop instead. Click ⟲ beat to select that clock's dial.
- The length should fit a whole number of times into the scene loop. If it does not, a note says seam at export (The period rule).
- Each lane has one line: the property, and a summary of its keyframes. Click the summary to open that lane in the timeline.
- A transform's lanes keep their ▸ keyframe list on the rows above. Other layers show the ▸ on each lane.
- ↗ in the section's title opens the layer in the timeline.
- A note names other things the timing drives: a gate, effect params, a gradient's settings, or a shape's or a text's colours.
Edit a keyframe from a dial
Edit one keyframe's time and value without the timeline.
- In the node graph, click a keyframe tick on a clock dial's ring (Use the clock dials).
- At the top of Properties, the keyframe section opens. Its first row names the property and the node.
- Type a new time in ms, or in frames (f).
- Type a new value.
- Click × in the section's title to deselect the keyframe.
- The ms and f fields are two ways to write the same time.
- A new time never moves a keyframe past its neighbour. It stops at the next keyframe.
- The section shows on top of any sheet, also a clock's, a surface's or a comp's.
Live values
An animated property shows its value at the playhead, not one fixed number.
- The value shows in gold and changes as the scene plays. When playback is paused, it shows the value at the playhead.
- Live values work on transform rows, effect params and a gradient's settings and stops. The timeline's lane values work the same way (Lane values).
- When you type, scrub or use the ladder on a gold value, you set a keyframe at the playhead. If the playhead is on a keyframe, that keyframe changes. If not, Starlight adds a new one.
- A gold row never changes the fixed (static) value behind it.
- On a transform row, the keyframes add to the static value for x, y, rotate and skew. For scale and opacity, they multiply it.
- Point at a gold row. Its tooltip shows the value, the clock and what typing does.
- When the static value is not 0 (or 1), the tooltip also shows how the two combine. Examples: base 100 + offset 240, or base 2 × 1.5.
- While you edit a field, the live value does not overwrite it.
Right-click a property
Right-click a property row for a menu of actions on that property.
- Right-click the row, or click it with two fingers. Its label and its value both work.
- Pick an action from the table below. The full menu table is in Menus › Property menu.
| Menu item | What it does |
|---|---|
| reveal in timeline | Opens the timeline's layers view on this property's lane, selected and flashed. A property with no lane yet opens on its layer. |
| select owning node | Selects the node that holds the value, when it is not the selected one. The item shows that node's id. Examples are an effect's layer, or a matte seen from the layer it cuts. |
| add key at playhead · remove key at playhead | On an animated row: the same as a click on its chip. remove key at playhead is grey on a transform's last keyframe (last key). On an effect param or a gradient setting it says ends animation. |
| animate this property | On a row that is not animated yet: the same as a click on its faint ◇ |
| ease ▸ | Only when the playhead is on a keyframe. Sets the ease that leaves that keyframe: 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, elastic, bounce or spring. A ● marks the current one. |
| edit curve… | Only when the playhead is on a keyframe. Opens the timeline's curves view on this lane, with that keyframe selected. |
| copy value · paste value | Copies the value, also to the system clipboard. paste value shows the copied value. It writes the value like an edit, inside the row's limits. On an animated row it sets a keyframe at the playhead. |
| copy animation · paste animation | Only on a row that can animate. Copies all the lane's keyframes. paste animation shows where they came from. It replaces the target's keyframes, or starts a lane on a row that is not animated. The shape stretches to the target's clock. |
| reset to default | Only when the property has a default. Writes the default value. On an animated row it sets a keyframe at the playhead. |
| import tracking… | Only on the rows of a transform section. Opens Import tracking data for the layer. |
- The menu's title names the property and its node, for example
rotate · transform-y79uxo. - On a layer's sheet, number rows have the menu, also each half of a paired row. Gradient settings, effect params (numbers, choices and colours), matte fields and the animation lanes have it too.
- A layer's text, font and colour fields, its dropdowns (such as shape or align) and its checkboxes have no menu. The keyframe, clock, surface and comp sheets have no menu either.
- In a field where you are typing, a right-click opens the normal text menu.
- paste value is grey when the value does not fit, for example a word on a number.
- copy animation is grey on a row with no keyframes.
- The clipboard holds one value and one animation, for this session.
- An action that changes nothing does not go into undo.
Import tracking data
Make a layer follow a point in a video. The motion of the point comes from tracking data: from After Effects, from Mocha, or from a CSV or JSON file.
- Select the layer that must move. Its sheet has a transform section.
- Right-click the title of the transform section, or its position, scale or rotate row. Choose import tracking….
- Click choose file… and pick the file (
.txt,.csvor.json). Or, in After Effects, select the keyframes and choose Edit › Copy. Then click paste, or press ⌘V / Ctrl+V. - Read the grey line under it. It says what Starlight found: the format, the frames, the frame rate, what can move, and the confidence. A red line says what is wrong in the data, and where.
- Check the options in the table below. The first choices are right for most shots.
- Click import, or press Enter. A message names the layer and the frames.
- Press Space to play it. To take it back, press ⌘Z / Ctrl+Z. The whole import is one step.
| Option | What it does |
|---|---|
| plate | The video layer that shows the footage the data was made on. It must be in the same comp or surface as the layer. Starlight uses its place and size to find the right pixels, and its frame rate when the data has none. The first choice is the only video there, or the video just under the layer. Choose none when the footage fills the comp at its own size, from the top-left corner. |
| mode | follow (the first choice): the layer stays where it is now, and moves with the point. pin: the anchor of the layer goes onto the point, and moves with it. This is "apply to layer" in After Effects. |
| apply | What moves: position, and also scale and rotation when the data has them (two tracked points, a corner pin, or the Scale and Rotation of After Effects). anchor point shows only for After Effects data with an Anchor Point that does not move. pin always moves the position. |
| fps | Shows only when the data does not say its frame rate (most CSV files). Type the frames per second of the footage. Leave it empty to use the frame rate of the plate's clip. |
| confidence | Shows only when the data has a confidence: how sure the tracker was, from 0 to 1. Frames under this number get no value, and the layer moves in a straight line across them. Leave it empty to use every frame. |
Good to know:
- The import writes one value on each frame. On the timeline, its lanes read · per frame. It keeps the frame rate of the data: a 23.976 fps track plays in time in a 30 fps scene.
- Frame 0 of the data lands on frame 0 of the scene. With a plate, the offset or the trim of its clip moves it. The delay of the layer moves it too.
- When the frames go past the end of the scene, nothing is imported. The message says which frames fit. Make the scene longer, or ask Claude to import only that part.
- A corner pin moves, scales and turns the layer. Starlight has no perspective, so the layer does not tilt.
- Scale and rotation turn around the anchor of the layer. New layers have their anchor in the centre.
- A new import replaces the layer's old position, scale or rotation tracks.
- The import is saved when you save (⌘S / Ctrl+S).
- Claude can do this too, and can also track a rectangle in a clip. Ask, for example: Track the phone screen in shot1 from frame 40, and pin the UI card to it.
Add effects and colour ops
Add an effect, or a colour op (a colour correction), to the selected layer.
- Select the layer.
- Click + on the effects section's title row.
- Type in filter effects… to filter the list, or move with the arrow keys. The line at the bottom says what the entry does.
- Press ⏎ / Enter, or click the entry, to add it. Esc closes the picker.
- The picker lists the colour ops on the left (color) and the effects on the right (effects). An extension's effects come below, under extensions.
- ← and → move between the two columns. Home and End go to the first and last entry.
- cutout is in the list only on an image, and only once. It always runs first, so its ↑ and ↓ are grey.
- Each effect card has its own N more and four buttons. ⊘ bypasses the effect (like b), so you can compare with and without it. ↑ and ↓ move it, and × removes it.
- Colour ops (exposure, curves, levels, hue/saturation, LUT and more) sit together in a color group at the top. Its title counts them, for example 2 ops → 1 LUT · first.
- The colour ops join, in their order, into one look-up table (LUT). It runs before the other effects. ↑ and ↓ move a colour op only among the colour ops.
- When a param is animated, a note under the card says what times it, for example keys ride the scene loop · 4s loop.
- A param with keyframes that the effect cannot animate here shows animated ↗. Click it to edit the keyframes in the timeline.
- In curves, drag a point, or click to add one. To remove a point, ⌥ / Alt + click it, or drag it off the box.
- curves and levels have rgb, r, g and b tabs. In curves, ↺ resets the channel, and the other changed channels show faintly.
- color-balance has a group for shadows, midtones and highlights, each with red, green and blue. It also has preserve luma.
- Click an effect chip in the node graph to open its layer's sheet with that card outlined.
- With nothing selected, an effect picked in the command palette makes a new adjustment layer.
- Every effect and its params: Effects.
Mask a layer
Cut a layer with a shape or with another layer, so only part of it shows.
- Select the layer.
- To draw the mask, click ✎ on the matte section, or press ⇧M / Shift+M. Then draw on the canvas (Draw a path or a mask).
- To cut by another layer instead, click + on the matte section and pick the layer under cut by.
- Starlight puts the layer in a matte node (the node that does the cut) and selects it. Set mode, invert and feather px there.
- mode is alpha (cut by the shape) or luma (cut by brightness). feather px softens the edge, in the content's pixels.
- The cut by list names each layer with a hint, for example
path 8pt · cutorshape ellipse · spot. While the list is open, + reads −. - The matte node's sheet links its two inputs, content and matte. Its opacity (how strong the cut is) is under N more.
- Opacity 0, or a bypass on the matte node, shows the layer without the cut.
- range from and range to remap the matte: below from is cut, above to is kept. They show on a depth matte, and under N more on any other.
- ✎ on the matte node redraws the shape. ⤺ removes the cut, and both inputs become normal layers again.
- The layer that is cut shows cut by … with the same fields.
- The matte layer itself shows matte input of … with the same fields. It is never drawn, and its own effects do nothing. Soften it with feather px.
- On an adjustment layer, a matte limits where the adjustment applies.
- With two layers selected, use selection as mask in the command palette cuts the second layer by the first.
- In the graph, hold ⌥ / Alt and drag a layer onto the matte node's content or matte half to plug it in.
- Press b on the matte node to show the layer without the cut.
Set a blend mode
A blend mode sets how a layer mixes with the layers below it.
- Select the layer.
- Click ⋯ in the top strip. The blend row appears.
- Open blend and pick a mode. Type to search the list.
- The modes are in groups, as in Photoshop: darken, lighten, contrast, inversion, cancellation and component.
- add shows in the list as add (linear dodge).
- When the blend is not normal, the row always shows. Pick normal to remove the blend.
- normal, multiply, screen and add cost nothing extra. The other modes copy what is under the layer, which costs a little GPU time.
- Point at the blend row to read what the mode costs.
- If the scene has enough of those modes to slow a zoomed-in canvas, the row says so. At room zoom they are fine.
- A node with a blend mode shows ◑ in the graph.
- On an adjustment layer, the blend mixes the adjusted result over the layers below. It costs no extra copy.
Use an adjustment layer
An adjustment layer changes everything below it in its comp or surface, as in After Effects.
- Open the command palette (⌘/ / Ctrl+/) and run adjustment layer. It lands on top of the list you are working in.
- Add effects to it with + on its effects section.
- To choose what it covers, move it down with ⌘[ / Ctrl+[ or up with ⌘] / Ctrl+].
- With nothing selected, an effect picked in the command palette makes a new adjustment layer with that effect.
- Its adjustment section shows its opacity and its GPU cost.
- It also lists the layers it adjusts. Click one to select it.
- With nothing below it, the note says nothing below it. Move it above the layers it should adjust.
- The cost line counts the passes and the textures it uses. With no active effect and a normal blend, it says that it changes nothing and costs nothing.
- Effects, a matte (to limit where it applies) and a blend mode work as on any layer.
- A click on the canvas usually picks a layer under it. Select the adjustment layer in the graph instead.
Fonts, media and LUT files
Some fields pick a file: a font, a picture, a video or a LUT.
Set a text's font:
- Select the text layer.
- In Properties, click the font field. A list opens.
- Pick a font. project fonts are the brand fonts: the font files that
project.yamllists, in thefonts/folder. A file that you copied there yourself shows after you click ↻. this computer lists the fonts that are installed on this computer. - Is your font not in the list? Type its name in the search field at the top, for example
Helvetica NeueorSegoe UI. Then click use “…”, or press Enter.
- A font name can end in a weight or a style:
Segoe UI Semibold,Helvetica Neue Bold Italic. The text then uses that weight and style. The weight field, when it is set, wins over the name. - When this computer does not have the font, the text uses the fallback fonts (Fonts). A note under the field then says so, for example “Gotham Bold” is not on this computer.
- A font from this computer must also be installed on every computer that plays or exports the project. To be safe, drag the font file into the Starlight window. Starlight copies it into the project's
fonts/folder, and the font then goes everywhere with the project. - ↻ beside the field looks in the project's
fonts/folder for new files (Fonts). - An image's or a video's src is read-only. To change the file, swap it in Assets.
- A video has loop and muted. muted is on for a new video, so it plays without sound. Untick muted to hear the clip's own sound, through the 🔊 monitor. Exports then mix it in too, when the file has sound (Audio in the file).
- A
luteffect's file picks a.cubefile from your assets. + beside it imports a new one intoassets/(LUTs). - The file list starts with — none —. A file that is not in the assets any more shows (missing).
- Under the file row, a note shows the LUT's title and size, or the error when the file does not load.
An audio layer's sheet
Select an audio layer to set its sound and to see what Starlight found in the music.
- volume goes from 0 to 1.
- The play row has muted, loop and export. export is on for a new layer: it mixes the sound into exports.
- With loop off, the song plays once, then there is silence. With loop on, the song starts again at its end.
- offset ms (under N more) starts the song that many ms in.
- A note shows the song's length, its tempo and its key, for example 183.2s · 128 bpm (beat grid cached). The key shows only when Starlight is fairly sure of it.
- While Starlight reads the file, the note says decoding… and then analyzing…. If it finds no beat, it says tempo not detected.
- The next line is the musical map: the song's sections (
A@0:00 B@0:32), its drops and its climax. - + beat clocks from 128 bpm ↗ makes named beat and bar clocks on the song's beat (Music).
- The 🔊 button at the top right changes only what you hear, never the layer or an export (The top-right buttons).
A surface's sheet
Click a surface's caption on the canvas to see the surface's own settings.
- Click the caption above the surface, for example
N — 6400×1600. Or click the surface's node in the node graph. - Edit the rows of the surface section in Properties.
- comp shows the comp that feeds the surface, when one does. It is read-only.
- delay runs that comp later on this surface, in seconds. Give each surface a little more delay, and one comp chases around the room (Delay a layer). The surface's own layers keep their time.
- output resolution is the pixels Starlight renders for the surface: on an LED wall, its pixel map. It is at least 8 pixels each way.
- A note under it says where the size comes from, for example overridden in this scene · project 6400×1600. Click reset to remove this scene's size.
- fit sets how the content's design size scales into the output resolution. The first entry keeps the fit from the project (or the default), for example cover (project).
- artboard is the design size: the size that you design the surface's content at.
- When the artboard is the same as the output, the row reads same as output ▸. Click it to edit the artboard. Under a changed artboard, reset puts back the scene's artboard.
- An edit here changes this scene only. What each size means: Sizes.
A comp's sheet
Select a comp to see its layers and the surfaces that use it.
- Select the comp's node in the graph. Or click its art on a surface that the comp feeds.
- Read and edit the sections in Properties.
- comp shows its name, its number of nodes and its number of instances (the places it is used). Double-click the comp in the graph, or its art on the canvas, to step into it.
- layers lists its layers from top to bottom. Number 1 is the front layer.
- Click a layer's name to select it. Its dropdown sets how it blends over the layers below.
- ↑ brings a layer forward, and ↓ sends it backward.
- network is a small map of its nodes. An empty comp has no map.
- used by N surfaces lists the surfaces that show the comp. Click one to select it.
- Each surface, and each
use:layer of the comp, can run it later with its own delay (Delay a layer).
A clock's sheet
Select a clock dial in the node graph to see and edit its timing.
- Click the ring of the clock dial in the graph, or its name. A click in the centre only plays or pauses.
- Edit its fields in Properties.
- scene clock (the main dial): the scene's duration in seconds and in frames, and its fps (frames per second). A new duration keeps the key times; turn on stretch to scale the animation instead (Set the scene's length).
- A note under it says if every named clock fits the loop. If one does not, it says seam at export and names it.
- named clock: its name, its period, and its mode (once, loop or pingpong).
- To rename the clock, type a new name and press ⏎ / Enter. Esc keeps the old name.
- Write the period in ms, or as a part of the scene loop in scene ÷. For example, scene ÷ 4 is a quarter of the loop. It changes when the loop length changes.
- A named clock's used by N lists the nodes that use it. Click one to select it.
- What clocks do: Clocks.
Node graph
The node graph shows the scene as a diagram: what feeds each surface, in what order, and on which clock. Press g , or pick Window › Graph , to show or hide it.
Transport & playback
The transport is the row at the bottom left of the canvas. It plays and pauses the scene, and it shows the current time.