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 or macOS.
• 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.
• Snap to Grid causes nodes to snap to a configurable grid when moved or created. Toggle and adjust spacing in Settings → Interface.

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 and a Delete option.

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.
• 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.