Terrain node
heightfield
Create an empty (flat) heightfield: a 2D grid in the XZ plane with Y up, stored in geometry.heightfield with a float32 'height' layer (and an empty 'mask' layer). This is the start of every terrain chain: heightfield -> hf_noise (shape) -> hf_erode (realism) -> hf_mask_by_feature (masks) -> hf_to_mesh (display/export as polygons) or hf_export (Unreal heightmap). Geometry on input 0 is passed through. Units are metres; Y is height.
Inputs
- 0geometry (optional, passed through)
Parameters 5
sizevector 2World size of the terrain in X and Z (units = metres). 1000x1000 is a typical Unreal landscape tile; 4000 for big vistas.
resolutionintNumber of cells along the longest side. 256 = fast previews, 512 = good default, 1009/2017 = Unreal-ready detail (slower erosion).
cell_sizefloatExplicit cell (grid spacing) in world units. 0 = derive from size / resolution.
centervector 2World X,Z of the terrain centre.
heightfloatInitial flat height of every cell.
Use it
Add it from the node menu (right-click empty graph space or Tab, then type heightfield), ask the AI for it by name, or add it with a graph op from the API or MCP:
{"op":"add","type":"heightfield","name":"my_heightfield","params":{},"inputs":["src"]}Any parameter can also be an expression such as "=sin(F*0.1)". See Parameters & expressions.