Skip to main content

Working in Graph Editors

Every node graph in the editor (Visual Script, Shader Graph, State Machine, Animation Graph, Render Pipeline, GPU Pipeline, ProcGen and Particles) is edited on the same canvas, with the same mouse and keyboard controls and the same searchable node palette for adding nodes.

Canvas controls​

InputAction
Drag with the left mouse button on empty canvasMarquee selection. Nodes the rectangle touches are drawn selected while you drag, and the selection changes when you release. Comments are only selected when the rectangle encloses them. Hold Ctrl or Shift to add to the current selection.
Drag a nodeMoves the selected nodes. Moving a comment also moves the nodes on it.
Drag the right or bottom edge of a commentResizes the comment.
Drag with the right or middle mouse buttonPans the view.
Drag from a pinDraws a wire. Pins that can take it light up and the others fade.
Space, or right-click the backgroundOpens the node palette at the pointer.
CPuts a comment box around the selected nodes.
FFrames the selected nodes.
HomeFrames the whole graph.
DeleteRemoves the selection. Removing nodes also removes their wires. A selection of only wires disconnects them.
EscapeCancels the drag in progress.

A comment only reacts to the pointer on its header and its edges, so the nodes on top of it stay easy to click.

The node palette​

The node palette lists every node you can add, grouped by category. Type to search. Open it in one of three ways:

  • press Space over the canvas,
  • right-click the background,
  • drag a wire from a pin and release it over empty canvas.

When the palette opens from a wire, it lists only the nodes that can take that wire, and the new node is connected to it.

Node palette opened by dropping a wire on empty canvas: the header names the wire's pin and type, Compatible only is on, nodes that need a conversion carry a CONVERTS badge, and the footer reads 62 of 93 nodes fit

Dragging off a pin​

  1. Press on an output or input pin and drag. Pins that can take the wire light up, and the others fade.
  2. Release over empty canvas. The palette opens at the pointer.
  3. The header shows the wire you are holding, for example Wire from Position · Vector3 (output).
  4. Pick a node. It is created where you released, and the wire is connected to the pin shown next to its name.

Dragging from an input works the same way in reverse: the palette lists nodes with an output that can feed it.

What the palette shows​

PartMeaning
Best MatchesUp to eight nodes whose pin has exactly the wire's data type. Shown when the list is long.
CategoriesAll other nodes that fit, ordered by how well they fit, then in their usual order.
Note (→ T · Float)The pin the wire will connect to, and that pin's data type. A pin that is named after its type shows the type only once.
Badge exactSame data type.
Badge convertsThe value is converted on the way, for example a Float into a Vector3, or a float4 into a float3. Pins that infer their type from their inputs also count as converts.
Badge anyA catch-all pin that takes anything, for example a String or Variant input.
FooterHow many of the graph's nodes fit, and the shortcut for the toggle.

Node names stay readable next to the notes and badges, and rows without a note or badge use the full width for the name.

When a node has several pins that fit, the wire goes to the best one. On a tie it goes to the first pin. For example, a Float dropped on Lerp (Vector3) connects to T, not to A.

Compatible only​

The Compatible only button next to the search field (or Ctrl+Space) switches between:

  • On (default): only nodes that can take the wire are listed.
  • Off: every node is listed. Nodes that can't take the wire are greyed out with no matching pin. Picking one creates it without connecting the wire.

The setting is remembered between sessions. If nothing in the graph can take the wire, the palette says so and offers Show all nodes.

What decides a match​

A node is listed when the graph's own connection rule accepts one of its pins. This is the same rule the canvas uses to light up pins while you drag. Nodes that can't be added at all are left out, for example a second Material Output in a shader.

GraphRule
Visual ScriptExecution pins connect only to execution pins. Data pins follow the script's conversions: numbers convert to each other, a number converts to a Vector3, and anything converts to String or Variant. Object pins accept the class and the classes derived from it. Type names are shown without the engine prefix, for example RigidBodyComponent.
Shader GraphSampler and string pins connect only to their own type. Every other type converts.
State MachineAny state connects to any state. Any State has no input, so it is never offered for a wire from an output.
Animation GraphPins of the same data type (pose, trigger, number, bool, bone weights), within the scope being viewed.
GPU PipelinePins of the same data type.
Render Pipeline, ProcGenAny output connects to any input. Pins of the same kind (same colour) rank as exact.
ParticlesPins of the same category. Values also need the same kind (numbers and bools convert). A new system has no blocks yet, so it has no value pins to connect to.

Troubleshooting​

SymptomCause
A node you expected is missingIt has no pin that can take this wire, or it can't be added here (for example an event node inside a sub-graph). Turn Compatible only off to see every node.
The wire connected to an unexpected pinSeveral pins fit equally well, so the first one won. Drag the wire to the other pin.
Comment is not listedComments have no pins, so they are only shown with Compatible only off, or when you open the palette with Space or a right-click on the background. Pressing C with nodes selected is quicker.
C, F or Space does nothingThe keys go to the pin under the pointer first, and some graphs use letter keys on pins. Move the pointer off the pin.

See Also​