Subgraphs

Fold a cluster of nodes into one tidy, reusable node.

Inside a subgraph

As a board grows, fold a cluster of nodes into a single Subgraph node. From the outside it is one clean node with a few ports. Double-click and you are inside, editing the whole graph it holds. Use them to tidy up, to reuse a setup, or to hide the fiddly parts behind a simple front.

Make one#

Select the nodes you want to group and press Cmd/Ctrl + G. Magerie wraps them, turns the wires that crossed the boundary into ports, and drops the new node where the group was. The result is unchanged; it is just folded up.

Go inside#

Double-click a subgraph to dive in. Use the breadcrumb at the top to climb back out. Nest them as deep as you like.

Choose its ports#

Inside a subgraph, mark a primitive node (Image, Color, Number, Boolean, Text) with the share icon to turn it into a port on the outside. Magerie works out whether it is an input or an output from how you wired it. Rename ports on the wrapper any time.

Filter subgraphs#

A subgraph with a single image output (and optionally one image input) becomes a filter you can drop onto a layer, for a non-destructive effect that touches only that layer.

A document is a subgraph#

The whole board is itself a subgraph. Drop a saved .mage into another document and it lands as one node, its project tucked inside. Nested projects, for free.

Where to next#