Skip to content

The node graph

Last updated

The Node graph draws the selected layer’s effect stack as boxes joined left to right by wires. It is the same stack the Effect Controls panel lists, with the ability to wire a driver into parameters.

The Node graph: a layer's image chain wired left to right, with a driver feeding one of its parameters.
The Node graph: a layer's image chain wired left to right, with a driver feeding one of its parameters.

Open it from Window ▸ Node graph, or switch to the Nodes workspace. The panel follows the layer selected in the Timeline.

Every graph starts with Source, one box per effect in order, and Layer out.

GestureWhat it does
Drop a node onto a wireInserts it at that point in the stack.
Drag a box’s bodyMoves it. A drag that starts inside the selection moves the whole selection.
Drag from a socketPulls out a wire; drop it on a socket that takes the same kind of value.
Drag a wire off an effect’s inputBypasses that effect. The picture goes past it and it keeps its place in the stack.
Drop a wire back on itSwitches it back on, and moves it to where the wire says.
Drag the wire off Layer outThe layer draws nothing until something is plugged back in.
DeleteRemoves the picked boxes.

Two switches sit in the panel’s toolbar. Auto-wire joins a dropped node to the wire in hand as it lands. Heal reconnects the neighbours of a deleted box.

  • Middle-drag pans. The wheel zooms about the pointer.
  • Frame all fits every box on screen.
  • A primary drag on empty canvas sweeps a selection box. Click replaces the selection, Ctrl-click toggles one, Shift-click adds, and Ctrl+A selects everything.
  • Dragging an effect from Effects & presets onto the canvas adds it: an effect joins the stack, a driver lands where it is let go.
  • A right-click on empty canvas, or Tab or Shift+A with the canvas focused, opens the node search at the pointer, as ctrl+space does. Each of the three can be turned off in Settings ▸ Timeline.
  • ctrl+space opens the node search. With a wire in hand the results are filtered to the kinds that wire can join, and picking one connects it.

Each box carries two small badges. The checkbox enables or disables a specific node and the picture passes through untouched. The twirl opens the node, displaying a socket for every parameter. In a node graph an open node also carries the parameters’ controls.

The checkbox and the wires say the same thing. A bypassed effect is drawn unwired — hollow sockets, and the chain running from the box before it to the box after — so switching one off in Effect controls unplugs it here, and unplugging it here switches it off there.

A driver makes a value rather than a picture, and a wire from a driver into a parameter’s socket makes that parameter follow the value.

DriverHands out
WiggleA random continuous number changing by an Amount at a Frequency.
Audio levelThe loudness of a named layer’s sound at this moment.
Colour cycleA colour whose hue turns at a Rate.
MathTwo numbers and an operation.
RemapMaps a number from one range onto another, with a clamp.
SmoothIts input, softened over Time.
Points sampleReads a points stream: how many points are alive, and how far the nearest one is from a position.
Layer pointsAnother layer’s points, brought into this graph.

Add one from the effect console “ctrl+space”, they are grouped under Drivers — and wire its output to a parameter’s socket.

Wires don’t cross between layers. The two drivers that read another layer name it instead: Audio level has an Audio row and Layer points a Points layer row, both ordinary layer pickers.

A driven parameter’s row in Effect Controls names the driver in place of a value. Its keyframes are overridden while the wire is there, and come back when it is pulled.

A wire’s colour is the type of value it carries:

  • image · matte
  • number
  • colour
  • shape · points
  • audio

A wire dropped on a socket of another kind is refused.

An effect’s Matte socket takes a wire as well as the layer picker on its row.

Particulate and the rest of the points family have a socket of their own, for another box to read the point stream.

Selecting exactly one effect — a box here, or a heading in Effect Controls — puts an at <effect> chip over the Viewer’s picture. Turn it on and the Viewer renders the composition with that layer’s stack stopping there.

The Nodes workspace: the graph across most of the window, a small Viewer and the Node panel down the right.
The Nodes workspace: the graph across most of the window, a small Viewer and the Node panel down the right.

The Nodes workspace puts the node graph in the centre of your view, to allow for work dedicated to nodes. It also keeps the timeline visible to change the selected layer or the current frame. As well as the viewer to the right and the Node panel, which lists the picked box’s parameter rows.