Node Graph Basics

ArcBrush uses a node graph to represent image processing workflows. Instead of applying effects destructively to a single image, you wire together nodes that describe your entire pipeline.

What is a Node Graph?

A node graph is a visual programming environment where:

• Each node represents a single operation (load image, blur, color adjust, export).
• Wires connect node outputs to inputs, defining data flow.
• The graph evaluates automatically when any parameter changes.
• Nothing is destructive. Every parameter stays editable forever.

Adding Nodes

There are several ways to add nodes to the canvas:

• Right-click the canvas to open the Add Node menu. A search field at the top lets you filter by name, so just start typing.
• Press Tab for instant access to the same menu, centered at your cursor.
• Drag from a pin by dragging a wire from any node’s output or input pin and releasing on empty canvas. The Add Node menu opens filtered to compatible node types, and the new node is automatically connected.
• Drag from the Node Library panel on the left side of the editor.
• Drag and drop files from your file manager onto the canvas. Image and SVG files automatically create the appropriate input node.
• Paste images from your clipboard with Ctrl+V to create an input node from the pasted image.

Graph Evaluation

ArcBrush uses smart evaluation:

• Only nodes downstream of a change re-evaluate.
• Adaptive debounce waits for you to stop dragging before processing heavy nodes.
• Nodes with no changes are cached and skipped.

Graph Files

Workflows are saved as .arcb files:

• Human-readable JSON format.
• Use Collect Files to copy all referenced assets alongside the project for portability.
• Version-migrated automatically when opened in newer versions.
• Cross-platform: open on Windows, macOS, or Linux.
• Auto-save periodically writes a backup while you work (configurable interval). If the app closes unexpectedly, crash recovery restores your last auto-saved state on next launch.

Graph Organization

• Node Groups are backdrop boxes to visually organize sections of your graph.
• Sticky Notes are freeform text annotations on the canvas.
• Minimap provides bird’s-eye navigation for large graphs (toggle with M).
• Graph Search lets you find any node by name with Ctrl+F.
• Wire Styles include curved, straight, rounded, or right-angle wires (cycle with W). Curved is the default.
• Snapping aligns dragged nodes to their neighbors. The Snap Mode selector in Settings → Interface chooses Snap to Nodes (the default, aligning edges to nearby nodes with dashed guide lines), Snap to Grid (a fixed grid), or None. Hold Ctrl while dragging to move freely.

Node Groups

Select one or more nodes and press Ctrl+G to create a group. Groups are visual backdrop boxes that help you organize sections of your graph. They do not affect evaluation or data flow.

• Move a group by dragging it. All nodes inside move with it.
• Resize a group by dragging its edges.
• Rename a group by double-clicking its title.
• Select the group and all contained nodes by double-clicking the titlebar outside the title.
• Nodes that fall inside the group boundary automatically belong to it.
• Deleting a group removes only the backdrop; the nodes inside are kept.
• Right-click a group for a context menu with 6 color presets, a Delete option, Select All Nodes (selects the group plus every contained node), and Bypass Group / Enable Group (toggles bypass on every contained node at once).

Sticky Notes

Right-click the canvas and select Add Sticky Note to create one. Click the note to edit its text content, and drag to reposition it anywhere on the canvas. Right-click a sticky note to change the text size (Small or Large) or pick a color.

Sticky notes are useful for documenting complex sections of your graph, leaving TODOs, or explaining pipeline logic to collaborators who open your .arcb file.

Graph Search

Press Ctrl+F to open the search dialog. Type a node name to find it, then press Enter to navigate to the result and center it on screen. This is especially helpful in large graphs where scrolling to find a specific node would be tedious.

Copy & Paste

Select one or more nodes and press Ctrl+C to copy them. Press Ctrl+V to paste at the current cursor position.

• Connections between copied nodes are preserved in the paste.
• Pasted nodes receive fresh unique IDs, so there are no conflicts with the originals.
• Copy and paste works across ArcBrush windows, so you can copy nodes in one project and paste them into another.

Right-Click a Node

Right-clicking a node opens a context menu with quick actions:

• Copy to Clipboard as PNG (nodes with an image output) — copies the node’s current output to the system clipboard with intact transparency. Paste into image editors, office and chat apps, or browsers.
• Reveal in Explorer / Finder (file-referencing nodes: Image In, SVG Import, Export Image, Export Batch) — opens your OS file manager with the referenced file selected.
• Delete Node (or Delete Nodes when multiple are selected) — removes the selected nodes with the same auto-reconnect behavior as the Delete key.

Deleting Nodes

Select one or more nodes and press Delete or Backspace to remove them, or right-click and choose Delete Node. When you delete a node, ArcBrush automatically reconnects compatible upstream and downstream connections, preserving the signal chain. This means you can remove a node from the middle of a pipeline without manually rewiring.

Copying Nodes

Hold Alt and drag any node to duplicate it. Alt+drag also works with sticky notes, groups, and mixed selections.

Node Bypass

Select one or more nodes and press D to bypass them. A bypassed node passes its primary input straight through to its output without processing. This is useful for quickly comparing before/after results or temporarily disabling part of your pipeline without rewiring.

Node Help

Click the ? button in the Properties panel header to open the selected node’s documentation page on arcbrush.com. This gives you quick access to parameter details, usage tips, and related nodes without leaving the app.

Wire Cutting

Hold Y and drag across wires to cut them. This is a fast way to disconnect nodes without clicking on individual pins; just slice through any wires you want to remove.

Reroute Nodes

Double-click any wire to insert a reroute dot at the click point. Reroute dots are compact pass-through nodes that let you guide wires along clean paths without affecting the signal. Chain multiple dots to route around obstacles, and fan out from one reroute output to several downstream nodes at once. They carry no parameters and add zero evaluation overhead.

Drop on Wire to Splice

Drag a node from the Library panel (or drag an existing node) over a connection. The wire under the cursor lights up. Releasing inserts the node between the wire’s source and target with both halves rewired automatically, all as a single undo step. The highlight follows the wire’s actual shape: straight, curved, right-angle, or rounded. If the node has no compatible pin for the splice, the operation is refused with a toast and the node falls back to a normal placement.

Multi-Node Connect

With several nodes selected, drag from one of their output pins onto an array input (such as a Layer or Collect pin). Every selected node fans out into consecutive pins in one drop, saving the manual work of wiring each node individually. This is especially useful when building layer stacks or batch collections from many sources at once.

Shake to Disconnect

While dragging a single node, give the mouse a few quick back-and-forth flicks. Every wire attached to the node disconnects in one motion. Where the upstream and downstream nodes can be reconnected directly, ArcBrush bridges them automatically. The whole gesture (move, shake, continue dragging, drop) collapses into a single undo step, so one Ctrl+Z restores the node’s start position and every wire that was attached.

Swap Two Nodes

Select exactly two nodes and press Ctrl+R (or use Edit > Swap Selected Nodes). The pair trades canvas positions and every connection that touched the first-clicked node is rewired onto the second, mapping pins by name first and then by Nth-of-type. Wires that have no compatible pin on the destination are dropped. A single Ctrl+Z rewinds the entire swap including wires, positions, and any dropped connections.

Lazy Evaluation

Enable View > Hide Thumbnails (Lazy Eval) to switch the graph into lazy mode. On-canvas thumbnails disappear and only the currently selected (or preview-locked) node and the chain leading to it auto-evaluate. Nodes outside that chain stay dirty until you select them. A “Lazy Mode” indicator appears in the status bar while the toggle is on. This is a big performance win on large graphs and large images, and the Preview panel remains the single preview surface.