Input Node
- Category: IO (listed as Graph Input in the node menu)
- Edition: All editions
- Output type: Mask, Color or Positions, chosen with Slot Type
- Typical place in a graph: at the start of a graph, to bring in data from outside: the terrain already in the scene, the biome's shape, a stroke from the Vista Painter, or a slot of a sub graph
The Input node brings data into the graph from outside, by name. Vista fills some names on its own: the terrain height already in the scene, the biome's mask and outline, and in brush graphs the stroke being painted. Other names become input slots when the graph is used as a sub graph, or are filled by your own code. If nothing provides the named input, the node outputs a Fallback texture, or nothing.
When to use it
- Build on the terrain that is already there: Scene Height, for biomes that add to or reshape existing land.
- Shape a biome by its own outline: Biome Mask Input and the biome's polygon inputs.
- Read the stroke in a Vista Painter brush graph: Stroke Mask Input, Stroke Proximity Input, Stroke Points Input, Scene Texture Weight.
- Give a reusable graph an input slot, so a Sub Graph node can feed it.
- Not for: passing data between parts of the same graph (use Set Variable and Get Variable).
Outputs
| Slot | Type | What it holds |
|---|---|---|
| (the input's Name) | Mask, Color or Positions | The data provided under that name, the Fallback texture when nothing is provided, or nothing. The slot is labeled with the name, or "(not set)". |
Properties
| Property | Default | Range | What it does |
|---|---|---|---|
| Name | Empty | Any text | The name of the input. The small menu next to it lists the names Vista provides; picking one also sets the right Slot Type. |
| Slot Type | Mask Slot | Mask Slot, Color Texture Slot, Buffer Slot | The kind of data: a mask or height, a color image, or a set of positions. |
| Fallback | None | A texture | Mask and color inputs only. The texture to use when nothing provides this input, such as while you edit the graph on its own. The node shows a warning when it falls back. |
Names Vista provides
| Name | Type | What it holds | Provided by |
|---|---|---|---|
| Scene Height | Mask | The terrain height already in the scene under the biome, 0 to 1 of the Vista Manager's Max Height. | A Local Procedural Biome with Collect Scene Height on. |
| Biome Mask Input | Mask | The biome's mask: 1 inside, fading to 0 across its falloff. | The biome, for biome mask graphs. |
| Biome Inner Polygon Input, Biome Outer Polygon Input | Positions | The points of the biome's inner and outer outline. | The biome. |
| Stroke Mask Input | Mask | Where the brush stroke went, with its soft edge. | The Vista Painter (Vista Indie and Pro). |
| Stroke Proximity Input | Mask | Distance from the stroke's path. | The Vista Painter. |
| Stroke Points Input | Positions | The recorded points of the stroke. | The Vista Painter. |
| **Scene Texture Weight/**name | Mask | The current weight of a terrain layer the user assigns to that slot name. | The Vista Painter. |
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. |
Recipes
- Add mountains to existing terrain: Input (Scene Height) → Combine (Add) with new mountains → Height Output, and turn on Collect Scene Height on the biome.
- Fade a biome's effect at its edge: Input (Biome Mask Input) → multiply into the masks that should fade.
- Brush graph: Input (Stroke Mask Input) → effect → outputs. See Stroke Graph.
Tip
Set a Fallback texture for inputs that are only provided in use, such as stroke inputs, so the graph previews something while you edit it.
Note
Scene Height is only collected when the biome's Collect Scene Height is on, and the biome warns when that is on without an Input node that reads it. Turn it off when unused; collecting costs time.
Note
The name must match exactly, including spaces and capitals.
Performance
Very cheap: a copy of the provided data, if any.
Related nodes
- Output: the matching exit point.
- Set Variable, Get Variable: pass data inside one graph.
- Brush Tip: the brush's intensity and shape in a brush graph.
For AI agents
- Type name:
InputNode(menu pathIO/Graph Input). Output slot id100, typed by the slot type (MaskSlot, ColorTextureSlot, BufferSlot). - Properties:
inputName(string), slot type set withSetSlotTypein the editor's Slot Type popup,fallbackTexture(texture asset; not for buffers). - Reserved names:
Scene Height,Biome Mask Input,Biome Inner Polygon Input,Biome Outer Polygon Input(core);Stroke Mask Input,Stroke Proximity Input,Stroke Points Input,Scene Texture Weight/<slot>(Strokes). - With nothing provided and no fallback, the slot carries no data; downstream nodes see an unconnected input.