The Node Graph

Build pipelines by connecting nodes.

Nodes and Ports#

Inputs left, outputs right. Data flows left to right; downstream nodes re-evaluate automatically. Disconnected branches skipped.

Connecting#

Drag output to input.

  • Inputs accept one connection (new wire replaces old).
  • Outputs accept many.
  • Ports typed. Invalid targets and cycles rejected.

Port Types#

Family Color Types
Image Blue Raster image data
Numeric Green Number, Vector2/3/4, Color
Video Purple Video streams (coming soon)
Text Orange Strings
Any Gray Untyped

Numeric family fully interconvertible. Upcasts pad with zeros, downcasts trim, color <-> vector4 maps r=x, g=y, b=z, a=w.

Adding Nodes#

Cmd/Ctrl + P for Omni menu (fuzzy search over nodes, commands, assets). Drag image files onto the graph to embed them as Image nodes.

Selection & Navigation#

  • Click to select, Cmd/Ctrl + Click for multi
  • Drag background to box-select; Cmd/Ctrl + A for all
  • F frames selection; X toggles minimal mode
  • Delete removes nodes
  • Pan with Space + drag, middle-mouse, or two-finger scroll. Zoom with pinch (trackpad). Range 0.05x to 20x.

Cmd/Ctrl + C/X/V preserves connections inside copied set.

Subgraphs#

Select nodes, press Cmd/Ctrl + G to collapse into a Subgraph node. Double-click to dive in. See Subgraphs.

Parameters#

Each node renders its own parameter controls inline. Image, Text, and Markdown nodes use embedded editors instead of standard control rows.

Rename inline with F2 or double-click the title pill. Undo (Cmd/Ctrl + Z) covers parameters, connections, nodes, and paint strokes through a single dispatcher.

Next#