Skip to Content
Starlight

How Starlight thinks

Six ideas explain almost everything in this guide. The glossary explains each word again.

Surfaces are the outputs

A surface is one output of the project, at the real pixel size of one display. For example: a 6400×1600 LED wall, a 1920×1080 video display or a 10080×84 ribbon.

  • The project lists its surfaces once, in project.yaml. The YAML key is surfaces:.
  • Older versions of Starlight said wall or board for a surface. Now wall means only a real wall, such as an LED wall.
  • Each surface exports as its own file. A scene says what plays on each surface.

Comps are shared, and the graph has levels

A comp is a named group of layers that you can place on many surfaces. Build it once and use it everywhere.

  • In the example arena, five surfaces (N, E1, E2, S and W) share the panorama comp.
  • The node graph shows one level at a time: the top level (the surfaces), or the inside of one comp.
  • A canvas click selects only at this level. At the top level, a click on a shared comp selects the whole comp on that surface.
  • A double-click on the canvas goes one level deeper: the graph steps into the comp, and the layer under the pointer is selected.
  • New layers go into the comp that you are inside (Step into a comp).

File order is draw order

A scene is a tree of layers. In each list of layers, Starlight draws the first layer first, at the back. It draws each later layer on top.

  • The timeline's layers view lists the front layer at the top. So it shows the file order upside down (Read the layers view).
  • To move a layer forward or back, press ⌘] / Ctrl+] or ⌘[ / Ctrl+[ (Change the layer order).

A transform places each layer

Text, shapes, images and video have no position of their own. A transform above each one places it. The transform holds the position, scale, rotation, skew, anchor and opacity (The transform node).

  • So in the node graph, a placed layer is two nodes: the content and its transform.
  • A canvas click selects the transform, because the transform is what a drag moves.
  • In Properties, places ▤ … opens the content's sheet. placed by ✥ … goes back to the transform (A layer's two sheets).

Time is phase, and everything loops

Every scene loops. One master clock drives all the surfaces, so they play together, as they will in the venue.

  • A keyframe is a value at one moment.
  • Each keyframe sits at a phase of its clock: a fraction of the clock's length, from 0 to 1. So every loop joins with no jump.
  • If you change a clock's length, everything on that clock gets faster or slower to fit (Time and motion).
  • If you change the scene's length in the app, the keys keep their times. You can choose to stretch them instead (Set the scene's length).
  • A layer can run later than the scene with a delay. When you move a layer in time, its keys move with it (Delay a layer).

Colours come from the brand kit

A colour can be a $token: a named colour from the project's brand kit. So one palette sets the colours of the whole project.

A project can also add its own effects and layer types, with extensions.

On this page