Table of Contents

Get Variable Node

  • Category: IO
  • Edition: All editions
  • Output type: Mask, Color or Positions, chosen with Slot Type
  • Typical place in a graph: at the start of a group that needs a shared result, such as the final height for texturing

Get Variable reads a result stored by a Set Variable node with the same name, anywhere in the same graph. It replaces long connections across the canvas, so each part of a large graph can start with a short, labeled node instead.

When to use it

  • Start each texturing or spawning group with the final height or another shared result.
  • Not for: reading data from outside the graph (use Input).

Outputs

Slot Type What it holds
(the Variable Name) Mask, Color or Positions The value stored by the Set Variable of that name. Nothing if no Set Variable has the name.

Properties

Property Default Range What it does
Variable Name Empty A name from the list Picks the variable to read from the Set Variable nodes in the graph.
Slot Type Mask Slot Mask Slot, Color Texture Slot, Buffer Slot The kind of data. Match the Set Variable.

Common properties

Property What it does
Id The node's unique name in this graph, shown for reference. You cannot edit it. Scripts and the AI workflow CLI use it to find the node.
Split Execution Lets this node run over several frames so the editor stays responsive during long generations. It only works when Allow Split Execution is on in the graph settings. This node finishes in one step, so splitting only adds a short pause around it; leave it off.
Bypass Skips the node. Nothing comes out.
Note

The graph runs the matching Set Variable first, even though no connection is drawn between them.

Note

Renaming a Set Variable breaks the Get Variables that use the old name; pick the new name in each of them.

Performance

Free: it reads the stored value without copying it, unless you preview it.

For AI agents

  • Type name: GetVariableNode. Output slot id 100, typed by the slot type.
  • Properties: varName (string). Use vista_graphitor_variable --node <id> --name <name> to set it.
  • Declares a dependency on the first SetVariableNode with the same varName; with no match, the output links to nothing.