Table of Contents

Sample Point Node

  • Category: General
  • Edition: All editions (works inside Vista Painter brush graphs, Vista Indie and Pro)
  • Output type: Four constant masks
  • Typical place in a graph: in a brush graph for the Vista Painter, reading one point of the stroke

Sample Point picks one point from the stroke's points and outputs its coordinates as flat maps, one value everywhere. The brushes use it to read where the stroke started or ended, or the height at its first point: the Flatten brush, for example, levels the ground to the height of the stroke's first point.

When to use it

  • In a brush graph: read the position or height of the first, last or any point of the stroke, as a value to compare or flatten to.
  • Not for: ordinary biome graphs. It reads the point count of the stroke, so outside a stroke it finds no point and outputs 0.

Inputs

Slot Type Required What to connect
Positions Positions Yes The stroke's points: an Input node set to Stroke Points Input.

Outputs

Slot Type What it holds
X Mask The point's position across the biome, 0 to 1, the same everywhere.
Y Mask The point's height value, the same everywhere.
Z Mask The point's position along the biome, 0 to 1, the same everywhere.
Valid Mask 1 if the point exists and is valid, 0 otherwise.

With no stroke, all four are 0.

Properties

Property Default Range What it does
Index 0 0 to 1 Which point: 0 is the first, 1 the last, 0.5 the middle one.

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.
Resolution How detailed the flat maps are. It starts at Relative To Graph with a multiplier of 1, so nodes after it do not inherit a tiny map.
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

  • Level the ground to where the stroke starts: Input (Stroke Points Input) → Sample Point (Index 0) Y as the level, blended with the scene height by the stroke mask (for example with Combine) → Height Output.
Note

It needs a stroke. In a normal biome, or a brush graph previewed without its action, it outputs 0; open brush graphs through the Stroke Action's Edit button so the sample stroke is available.

Performance

Very cheap.

  • Input: provides Stroke Points Input.
  • Brush Tip: the brush's intensity and shape.

For AI agents

  • Type name: SamplePointNode. Input Positions = 0 (Buffer); outputs X = 100, Y = 101, Z = 102, Valid = 103 (Masks).
  • Property: index (0 to 1). Sample index = round(index × (STROKE_POINT_COUNT − 1)); the count comes from the execution argument set by the Vista Painter, so outside a stroke there is no sample and every output is 0.
  • Default resolution RelativeToGraph × 1.