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 (or Tab) for the Omni menu: fuzzy search over nodes and your library. 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, Markdown Renderer, and the code nodes (GLSL, JavaScript, Plot) 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#
- Subgraphs: group nodes into reusable units
- Action Bar: quick-access slots for colors, brushes, selections, and node groups
- Painting: brush, layers, canvas