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.
Related nodes
- Set Variable: stores the value.
For AI agents
- Type name:
GetVariableNode. Output slot id100, typed by the slot type. - Properties:
varName(string). Usevista_graphitor_variable --node <id> --name <name>to set it. - Declares a dependency on the first
SetVariableNodewith the samevarName; with no match, the output links to nothing.