Cube
A 3D cube mesh.
What it does
Cube generates a six-sided box mesh from a single edge-length value. Like the other primitives it is analytic by default: a shape that stays crisp at any zoom and combines with Distance Field booleans against other shapes. Turn Analytical off to tessellate it into a real Geometry mesh for the 3D scene, and raise Subdivisions to lay a regular grid across each face for cloth simulation, displacement, or any effect that needs more vertices.
Size sets the edge length uniformly on all three axes. For a non-uniform box, stretch it afterwards with the Scale transform parameter. Position places the cube's centre in space and applies while Analytical is on, so the shape stays first-class in boolean and Distance Field workflows rather than only as a fallback mesh.
When to use it
A basic box, crate, block, or building block for a 3D scene
A shape to combine with other primitives through Distance Field booleans: keep Analytical on
A subdividable mesh for simulation or displacement: turn Analytical off and raise Subdivisions
A stretched or flattened box: combine Size with the Scale transform parameter
| Parameter | Type | Default |
|---|---|---|
fill | OneOf([Color, FieldOf(Color), ColorArray, Field, Material, MaterialArray, RasterArray]) | — |
size | Number | 100 |
subdivisions | Number | 0 |
analytical | Boolean | false |
position | Vec3 | (0, 0, 0) |
rotation | Vec3 | (0, 0, 0) |
scale | Vec3 | (1, 1, 1) |
anchor | Vec3 | (0, 0, 0) |
opacity | Number | 1 |
Gotchas
Subdivisions only affect the tessellated mesh. While Analytical is on the cube stays an analytic shape and Subdivisions has no visible effect. The value is capped at 48 per face edge, keeping the mesh within safe triangle-count limits for downstream culling.
Even at Subdivisions = 0, each face gets a minimum 2×2 vertex grid (two triangles). There is no lower-poly cube than that once tessellated, so leave Analytical on when the extra vertices are not needed.
Worked example
Add a Cube. Set Size for the edge length.
Wire a Color, Image, or Material node into Fill to drive the surface.
For a simulation-ready mesh, turn Analytical off and raise Subdivisions.
To combine the cube with another shape, keep Analytical on and feed it into a boolean or Distance Field operation.
Use Position, Rotation, Scale, and Anchor to place and stretch the cube in the scene.