Table of Contents

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.

For AI agents

  • Type name: InputNode (menu path IO/Graph Input). Output slot id 100, typed by the slot type (MaskSlot, ColorTextureSlot, BufferSlot).
  • Properties: inputName (string), slot type set with SetSlotType in 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.