Grid
A centred lattice of points, columns by rows by layers, with independent spacing per axis.
What it does
Grid emits a lattice of points, Columns by Rows by Layers, centred on the origin with independent spacing per axis. Each point carries its lattice coordinate as @index_x, @index_y and @index_z, so downstream work can vary by column, row or layer rather than by flat ordinal.
There is no input. Leave Layers at 1 for a flat 2D grid.
When to use it
A deterministic, evenly spaced point set, where Points would scatter.
Instancing on a regular arrangement through Iterator.
Varying an attribute along one axis of the lattice, through
@index_x,@index_yor@index_z.A structured seed for a simulation or an Expression.
| Parameter | Type | Default | What it does |
|---|---|---|---|
columns | Number | 5 | Number of points along X. |
rows | Number | 5 | Number of points along Y. |
layers | Number | 1 | Number of points along Z. Leave at 1 for a flat 2D grid. |
spacing | Vec3 | (50, 50, 50) | Distance between adjacent points, per axis (X, Y, Z). |
obj_position | Vec3 | (0, 0, 0) | Translation (X, Y, Z) |
obj_rotation | Vec3 | (0, 0, 0) | Rotation in degrees (X, Y, Z) |
obj_scale | Vec3 | (1, 1, 1) | Scale (X, Y, Z) |
obj_anchor | Vec3 | (0, 0, 0) | Pivot offset (X, Y, Z) — rotation/scale orbit this point |
opacity | Number | 1 | Layer opacity (0 = transparent, 1 = opaque). Editable, wirable, keyframable. |
Gotchas
Changing Columns, Rows or Layers rebuilds the node's kernel. Changing Spacing only re-uploads a value. Animate Spacing freely and treat the counts as structure.
The transform parameters place the whole lattice. They do not change its shape.
Opacity is a display control. It changes how the points draw and never what the node emits, so a downstream node reads the same lattice at any opacity.
Worked example
Add a Grid. Set Columns and Rows for the arrangement, and leave Layers at 1.
Set Spacing to control the distance between points on each axis.
Wire the output into Iterator's target to place a copy of a shape on every point.
Add an Expression and read
@index_xto vary each column.