Skip to Content
Starlight

Pre-render a node

A heavy comp or group can be slow to draw. A pre-render draws it once into a video file. Starlight then plays the file while the node does not change.

Words on this page

Pre-render
A video file of one node's content, made on this computer. It is a cache: it saves drawing time, and it never changes how the scene looks.
Fresh
The file matches the node as it is now. Starlight plays the file.
Stale
You changed the node, or a file that it uses (a clip, an image, a .cube LUT, a font), after the file was made. Starlight draws the node live again, until you pre-render it again. If you change the code of an extension that the node uses, the file is stale too.
Not rendered
The node has no file on this computer. Starlight draws it live.

Make a pre-render

  1. Right-click a node on the canvas or in the node graph.
  2. Look at the word after pre-render: fresh, stale, rendering or not rendered.
  3. Choose pre-render. The node gets prerender: true in the scene (one undo step), and the job starts.
  4. The Generations panel shows the job, its progress and $0 · local. You can cancel it there.
  5. When the job is done, the node plays from the file.
  • The file holds one loop of the scene, at the scene's frame rate. It holds the node's content. The node's own position, opacity, effects and blend mode still work live on top of it.
  • While you edit inside the node, Starlight draws it live, so you can select and move its layers.
  • The row is grey with needs the playback update in a Starlight that cannot plan a pre-render yet.

When a pre-render is refused

A pre-render holds exactly one loop. So the node's content must repeat every loop. If it does not, Starlight refuses, and a notice says why. The node then draws live, as before.

  • A clip whose length does not fit the loop a whole number of times. Trim the clip, or change the scene length (Set the scene's length).
  • A clock that follows the audio time instead of the loop.
  • Motion driven by music (Band drivers).

Where pre-renders are kept

  • Each computer makes and keeps its own pre-renders, in its renders folder (in a local project: renders/.prerender/; in a shared project: in Starlight's folder on this computer). They are not shared, and they are not in git.
  • An undo back to an earlier state finds that state's file again, so it is fresh again.
  • Export always draws every node live, so the exported file has exact pixels. A pre-render only makes the canvas faster.

On this page