Detail Instance Output Node
- Category: IO
- Edition: All editions
- Output type: Grass and small plants on Polaris terrain
- Typical place in a graph: at the end of a spawning chain, after Scatter
Detail Instance Output places grass and small plants on a Polaris terrain, one plant per position. Give it positions, usually a dense Scatter, and a Detail Template; optional masks thin the plants out and vary their size and rotation. Unity terrain does not use it: Unity terrain grass comes from Detail Density Output.
When to use it
- Grass and flowers on Polaris terrain.
- Graphs that must work on both terrain systems: use this node and a Detail Density Output with the same template side by side.
- Not for: Unity terrain (use Detail Density Output); trees (use Tree Output); rocks and props (use Object Output).
Inputs
| Slot | Type | Required | What to connect |
|---|---|---|---|
| Positions | Positions | Yes | Where to place each plant, usually a dense Scatter. Points outside the biome are skipped. With nothing connected, no plants. |
| Density | Mask | No | Thins the plants out: its brightness, times Density Multiplier, is the chance each position keeps its plant. |
| Vertical Scale | Mask | No | The height of each plant, times Vertical Scale Multiplier. |
| Horizontal Scale | Mask | No | The width of each plant, times Horizontal Scale Multiplier. |
| Rotation Y | Mask | No | Turns each plant around its vertical axis, between Min Rotation and Max Rotation. |
Outputs
| Slot | Type | What it holds |
|---|---|---|
| Output | Positions | The placed plants with their size and rotation. You rarely need it. |
Properties
| Property | Default | Range | What it does |
|---|---|---|---|
| Detail Template | None | A Detail Template asset | The grass or plant to place. Create one with Assets > Create > Vista > Detail Template. Without a template, nothing is placed. |
| Density Multiplier | 1 | 0 and up | Scales the chance that each position keeps its plant. |
| Vertical Scale Multiplier | 1 | 0 and up | Plant height, times the Vertical Scale mask if connected. |
| Horizontal Scale Multiplier | 1 | 0 and up | Plant width, times the Horizontal Scale mask if connected. |
| Min Rotation, Max Rotation | -360, 360 | -360 to 360 | The rotation range, picked by the Rotation Y mask. |
| Rotation Multiplier | 1 | 0 and up | Scales the Rotation Y mask before it picks a rotation. |
| Seed | 0 | Any integer | Changes which positions the Density mask removes. It is combined with the biome's seed. |
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. |
Output nodes cannot be bypassed.
Recipes
- Grass on Polaris: grass mask → Scatter (small Spacing, a few meters) → Detail Instance Output.
- One graph for both terrain systems: the same grass mask → Detail Density Output, and → Scatter → Detail Instance Output, both with the same Detail Template. Each terrain system uses the one it supports.
Note
Unity terrain ignores this output; on a Unity terrain nothing is placed. Use Detail Density Output there.
Warning
Grass needs many positions. Check the point count of the Scatter before generating a large biome, and keep Spacing as large as the look allows.
Performance
The node is a single quick GPU step. The cost is in the number of positions and the plants rendered.
Related nodes
- Detail Density Output: grass by density, for Unity terrain.
- Detail Instance Slot Output: the same, with the template chosen in the Vista Painter.
- Scatter: makes the positions.
For AI agents
- Type name:
DetailInstanceOutputNode. Slot ids: Positions =0(Buffer), Density =1, Vertical Scale =2, Horizontal Scale =3, Rotation Y =4(Masks); Output =100(Buffer). - Properties for
vista_graphitor_node_set:detailTemplate(asset path),densityMultiplier,verticalScaleMultiplier,horizontalScaleMultiplier,minRotation,maxRotation,rotationMultiplier,seed. Same per instance rules asTreeOutputNode. - Not bypassable. Skipped without a valid template or when the biome's Data Mask excludes DetailInstances. Unity terrain has no detail instance populator; Polaris only.