Table of Contents

Constant Height Node

  • Category: Base Shape
  • Edition: All editions
  • Output type: Height / Mask
  • Typical place in a graph: a helper: flat ground, a minimum height, or a full strength mask

Constant Height gives the same height everywhere, set in meters. On its own it is perfectly flat ground at that height. It is mostly used as a building block: a sea floor or lake bed level, a minimum height that the land never goes below, a plateau to blend toward, or a constant full strength mask for a texture or output that should cover the whole biome.

A flat surface 100 m above the terrain floor, in 2D and 3D

When to use it

  • Flat ground at a set height, such as the floor of a valley biome or the bed of a lake.
  • A minimum height: Combine (Max) your shape with a Constant Height, so nothing goes below it, for a plateau base or sea level shore.
  • A ceiling: Combine (Min) cuts every peak off at that height, for mesas.
  • A full strength mask: with Target Height equal to the terrain height, the value is 1 everywhere, for example as the weight of a single ground texture.
  • Not for: a flat area in one place only (use Flatten or Flatten At).

Inputs

None.

Outputs

Slot Type What it holds
Output Mask The same value everywhere: Target Height divided by the terrain height. 0 is the terrain floor; 1 is the full terrain height.

Properties

Property Default Range What it does
Target Height 0 0 and up, meters The height of the flat surface above the terrain floor. It is converted using the terrain height (the Vista Manager's Max Height), so 100 on a 400 m terrain gives 0.25. Set it to the terrain height for a value of 1.

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 many texels the result has. This node defaults to Absolute at 8 × 8, which is plenty for a single value and costs almost nothing; nodes that combine it with a larger texture scale it up. You rarely need to change it.
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. It has no input to pass through, so nothing comes out, and the nodes after it receive empty, flat ground.

Example

Property Value
Target Height 100

2D: one even dark red 3D: a flat surface lifted above the floor

On a 400 m terrain, 100 m gives 0.25 everywhere: a flat surface a quarter of the way up.

Recipes

  • Sea floor with islands: island shape → Combine (Max) with Constant Height a few meters up, so the sea floor is flat instead of dropping to 0.
  • Mesa tops: mountains → Combine (Min) with Constant Height, cutting every peak at the same height; erode afterwards.
  • One texture over everything: Constant Height (Target Height = terrain height) → Texture Output. The sample graphs on these pages use exactly this for their grass.
Note

The value depends on the terrain height. If you change the Vista Manager's Max Height, the same Target Height gives a different value, but the same height in meters.

Warning

A Target Height above the terrain height gives a value above 1, and the terrain is cut flat at its full height.

Performance

Practically free.

  • Flatten, Flatten At: flatten the land in chosen places.
  • Combine: use Max or Min with this node for floors and ceilings.
  • Levels: raise or lower a whole shape instead of replacing it.

For AI agents

  • Type name: ConstantHeightNode. Output slot 100 (Mask). No inputs.
  • Property: targetHeight (meters, ≥ 0). Output value = targetHeight ÷ terrain height (TERRAIN_HEIGHT arg = Vista Manager Terrain Max Height).
  • Default resolution: Absolute 8.