Subgraph
Group nodes into a reusable subgraph.
What it does
Subgraph packages a group of nodes into one reusable unit with its own named inputs and outputs. The interior is built once: an In node wherever an external input enters, an Out node wherever a result leaves. The Subgraph node then presents that interface on the outside, with the internal wiring hidden.
With a Canvas node in the interior, the Subgraph behaves as a placed layer. Position, Rotation, and Scale appear on the outside, and move, turn, and resize the whole packaged result as one object in the parent canvas.
When to use it
Reusing the same group of nodes in several places, or saving it as a building block for later graphs.
Collapsing a busy tangle of nodes into one box with a few named controls.
Exposing a handful of parameters (radius, colour, count) while the rest of the setup stays inside.
Treating the packaged result as a single placed layer, movable, rotatable and scalable from the outside, by including a Canvas node inside.
| Parameter | Type | Default |
|---|---|---|
position | Vec3 | (0, 0, 0) |
rotation | Vec3 | (0, 0, 0) |
scale | Vec3 | (1, 1, 1) |
strength | Number | 1 |
Gotchas
An In node's outside name is either typed explicitly or derived from whatever it is connected to. If an input's label looks wrong after a rename or rewire upstream, check the In node's own name field first.
Only nodes wired to an Out node inside the subgraph contribute to its output. A node left dangling with no Out attached is treated as scratch work, not a result.
Position, Rotation, and Scale appear on the outside only once the interior contains a Canvas node. Without one the subgraph has no frame of its own to place, so those three controls stay hidden.
Worked example
Select the nodes to package, and group them into a Subgraph.
Inside the subgraph, wire an In node in front of any value to control from the outside, and give it a clear name.
Wire an Out node after the final result to expose.
Back on the outside, the Subgraph node shows exactly those named inputs and outputs. Connect and adjust them like any other node.
Add a Canvas node inside to move, rotate, or scale the whole packaged result as one layer from the outside.
See also
In · Out · Annotation · Rasters (images)