Subgraphs

Group nodes into reusable units.

Subgraph editor

A subgraph is a node containing other nodes. Outside: one node with ports. Inside: full graph editor. Use them to organize, reuse, or hide implementation detail.

Make One#

Select one or more nodes, press Cmd/Ctrl + G. Magerie wraps the selection, promotes external connections to subgraph ports, reroutes the surrounding graph. New node sits at the centroid of the original selection.

Edit Inline#

Double-click to dive in. Click the breadcrumb to climb out. Nest as deep as you like.

Exposing Ports#

Mark a primitive node inside (Image, Color, Number, Boolean, Text) with the share icon to expose it as a subgraph port. The role (input or output) is inferred from how it's connected internally. Port labels default to the inner node's name and stay editable on the wrapper.

Filter Subgraphs#

A subgraph with one image output (and optionally one image input) is a filter subgraph. With no input it acts as a pure generator on the layer; with input it transforms the layer's pixels.

  • Per-layer filters: assign one to a layer for non-destructive effects
  • Brush effects: coming soon

Document as Subgraph#

The whole document is a subgraph. Drop a saved .mage into another document as a single node. Nested project structure for free.

Next#