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.
Related nodes
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.