Skip to content

Guides / Using Lumit / Effects

Updated

The node graph

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, with hollow sockets and the chain running from the box before it to the box after. Switching one off in Effect controls unplugs it here, and unplugging it here switches it off there.

A group is a named, coloured frame behind some boxes. It follows them as they move, and a group can sit inside another.

GestureWhat it does
Ctrl+G, or Group in the toolbarFrames the picked boxes and starts typing the group’s name. Boxes picked inside a group are framed inside it, and whole groups picked together are framed as one.
Click a group’s barPicks every box in it.
Drag the barMoves the group.
Double-click the bar, or F2 or Enter with it pickedRenames it.
Right-click the barOpens its menu: Rename, Colour…, Save group… and Ungroup.
Drop boxes on a frameMoves them into that group.
Ctrl+Shift+GTakes the picked boxes out of the innermost group they are in. With a group’s bar picked, removes that frame and leaves its boxes.

The two shortcuts are the ones set for grouping layers in the Timeline. Zoomed out, a group’s name keeps its size on screen.

Save group… asks for a name, a description, a colour and whether to show the group on the shelf, and writes it to the preset library as a .lumgrp file: its effects and drivers, the wires among them and their layout. Source and Layer out are never saved, and the groups inside it are. Picked boxes that are not a group become one under that name. A name already in the library asks whether to replace that group, and Replace writes over it. A saved group is listed in the node search under Group. Inserting one adds its effects to the end of the layer’s stack and puts its drivers where the search was opened.

A group shown on the shelf sits in a strip above the canvas, and a click there inserts it.

The folder button beside Save group… opens Saved groups. Click a group there to insert it. Each row shows how many boxes it holds and has three marks:

MarkWhat it does
Show on shelfPins the group to the shelf, or takes it off.
Edit groupChanges its name, description, colour and shelf tick.
DeleteAsks, then deletes the group’s file. Groups already on a canvas are not touched.

Show folder opens the library in the file manager, and Close shuts the window. With nothing saved it reads No saved groups.

A note is a few words left on the canvas. It is not a box and is wired to nothing.

  • Add note in the toolbar starts one in the middle of the canvas. Clicking away keeps it, and one left empty is not kept.
  • Drag a note to move it.
  • Double-click it to change its words.
  • The twirl folds it down to its first line.
  • Right-click it for Edit, Collapse, Colour and Delete.

A tie gathers wires at one spot, and they run side by side through it.

  • Drag with the right button across wires to tie them.
  • Drag a tie to move it.
  • Right-click a tie, or drag across it with the right button, to let its wires go.

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 the composition, a layer or a clip 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.
SplitA colour taken apart into its four numbers.
CombineFour numbers put together as a colour.
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.
ExpressionWhatever an expression returns: a number, a point or a colour.
Clone indexWhich copy Clone to points is stamping a layer as.
MeasureThe size and edges of a layer’s content.
Beat triggerEvents from beats and loud moments.

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

Wires don’t cross between layers. The drivers that read another layer name it instead, with an ordinary layer picker: Audio level’s and Beat trigger’s Audio row, Layer points’ Points layer row and Measure’s Layer row.

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. An effect’s Output wired into the Matte of an effect below it mattes that effect by its picture. The wire is taken off if the two swap places.

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

A points effect added below a producer is wired to the nearest one above it. The Points row at the top of its card in Effect controls shows the same wire and changes it.

Some points effects, such as Vary points and Pick points, take a stream and hand a changed one on. Merge points has four Points sockets, and takes a different producer above it on each.

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.

The Node panel’s header shows the picked box’s name and, when wires drive any of its rows, how many: 2 driven. With no box picked it reads Pick a node on the graph., and on a box with no rows This box has nothing to set.