Table of Contents

Spline Extract Node

  • Category: General
  • Edition: Vista Pro with Vista Splines
  • Output type: Four masks and two sets of positions
  • Typical place in a graph: at the start of a branch that needs a scene spline as data

Spline Extract turns a scene spline into data for the graph: a soft and a hard mask of its ribbon, the area it encloses, its height, and its points. Use it when the ready made spline nodes (Path, Ramp, Thin Out Along) do not do exactly what you need, and build your own effect from the parts.

The spline's ribbon as a soft mask

When to use it

  • Custom spline effects: a river bed that digs deeper in the middle, a hedge along a lane, flowers along a path.
  • Positions along a spline for Position SDF or spawning along it.
  • A filled area from a closed spline, such as a lake or a field.
  • Not for: the common cases, which have their own nodes: Path for masks, Ramp for road beds, Thin Out Along for clearing.

Scene setup

Spline Extract reads spline evaluators in the loaded scene, by Id, the same way as Path.

Outputs

Slot Type What it holds
Mask Mask The ribbon: 1 along the center line, fading to 0 at its edges.
Mask Bool Mask The ribbon as a hard mask: 1 anywhere on it, 0 elsewhere.
Region Mask The area inside the spline, as if closed from its last point back to its first. Meant for closed splines; on an open one it gives a wedge between the ends.
Height Mask The spline's height on its ribbon, as a fraction of the Vista Manager's Max Height; 0 elsewhere.
Anchors Positions The spline's knots.
Points Positions Evenly spaced points along the spline, in order: ready for Position SDF in Path mode.

Outputs that nothing reads are not computed.

Properties

Property Default Range What it does
Spline Id PICK_A_SPLINE_ID Text Selects the spline evaluators to read. Type an Id or pick one from the menu next to it. With no match, nothing comes out.

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 this node's result is, in texels across the biome. The node has no input, so Relative To Main Input (default) and Relative To Graph both follow the biome's Canvas Resolution, times the multiplier below. Absolute sets an exact size. Absolute is limited to 32 to 512 in Vista Personal and 32 to 4096 in Vista Indie and Pro.
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.

Examples

An open spline (Id "Doc Road", knots at 110 m) on a 1024 × 1024 m biome with the Vista Manager's Max Height at 400 m.

Mask Mask Bool Region Height
The ribbon, soft at its edges The ribbon, hard edged A wedge between the spline's two ends The ribbon at an even dark red

Mask fades across the ribbon, Mask Bool is solid. Region on this open road closes the curve between its ends, giving a wedge; on a closed spline it fills the inside. Height reads 0.275 on the ribbon: 110 m of 400 m.

Recipes

  • River bed: Mask → Curve for the bank profile → subtract from the height with Combine.
  • Lake from a closed spline: Region → Height Mask style blending, or straight into a water mask.
  • Distance from a road: Points → Position SDF (Path, Closed off) → falloff mask.
Note

The spline evaluator refreshes its shape when the spline changes. Moving only the spline's GameObject may not update the result until the spline itself is edited.

Performance

Cheap. Only the outputs in use are computed.

For AI agents

  • Type name: SplineExtractNode (Vista Pro, Splines module). Outputs: Mask = 100, Mask Bool = 101, Region = 102, Height = 103 (Masks); Anchors = 200, Points = 201 (Buffers). No inputs.
  • Property: splineId (string).
  • Measured on the doc spline: Mask mean 0.081, Mask Bool 0.161, Region 0.049, Height max 0.275 (knots at 110 m of 400 m).