Terrain node
hf_import
Load a heightmap image into a new heightfield (inverse of hf_export: image column = X, row = Z). 16-bit PNGs keep full precision; 8-bit images will look terraced (blur slightly with hf_blur). Writes 'height'.
Inputs
- 0geometry (optional, passed through)
Parameters 6
filestringHeightmap image path: 8 or 16-bit greyscale PNG (or any PIL image; colour is converted to luminance) or a .r16/.raw square little-endian uint16 file.
height_minfloatWorld height of black (0).
height_maxfloatWorld height of white (max value).
sizevector 2World size in X and Z the image is stretched over.
centervector 2World X,Z centre.
flip_rowstoggleFlip the image vertically (if the import appears mirrored in Z).
Use it
Add it from the node menu (right-click empty graph space or Tab, then type hf_import), ask the AI for it by name, or add it with a graph op from the API or MCP:
{"op":"add","type":"hf_import","name":"my_hf_import","params":{},"inputs":["src"]}Any parameter can also be an expression such as "=sin(F*0.1)". See Parameters & expressions.