Terrain node

hf_scatter

Scatter points on the terrain surface, weighted by a mask layer and limited by slope and height. Output points have P (on the surface), N (terrain normal), up (blend of +Y and N), orient (quaternion xyzw: random yaw around up), pscale, id, slope (degrees), and one float attrib per heightfield layer sampled at the point. Feed into copy_to_points or use 'forest'.

Inputs

Parameters 9

countint
Default 2000Range 0 to 2000000

Number of candidate points before mask/slope rejection (final count is lower where the mask is weak).

maskstring
Default ""

Mask layer weighting the density (0..1). Empty = uniform.

slope_maxfloat
Default 35Range 0 to 90

No points on slopes steeper than this (degrees).

height_rangevector 2
Default [-1000000000, 1000000000]

Only scatter between these world heights.

min_distancefloat
Default 0Range 0 to …

Minimum spacing between points (world units, 0 = off; approximate Poisson-disk thinning).

pscale_rangevector 2
Default [0.7, 1.3]

Random uniform pscale range.

align_to_normalfloat
Default 0.2Range 0 to 1

0 = 'up' is world +Y (trees), 1 = up follows the terrain normal (rocks, grass).

as_mesh_pointstoggle
Default on

Remove the heightfield from the output (only points). Off keeps the heightfield too.

seedint
Default 0

Random seed.

Use it

Add it from the node menu (right-click empty graph space or Tab, then type hf_scatter), ask the AI for it by name, or add it with a graph op from the API or MCP:

{"op":"add","type":"hf_scatter","name":"my_hf_scatter","params":{},"inputs":["src"]}

Any parameter can also be an expression such as "=sin(F*0.1)". See Parameters & expressions.