Torus
A 3D torus mesh.
What it does
Torus builds a ring-shaped mesh from two radii. Major Radius sets the distance from the centre to the middle of the tube, Minor Radius the thickness of the tube itself. Major Segments and Minor Segments set how finely the two circles are tessellated, trading smoothness for vertex count.
Turn Analytical on to emit the torus as an analytic shape rather than a tessellated mesh: resolution-independent, and ready for Distance Field booleans with other shapes. In that mode Major Segments and Minor Segments have no effect, since there is no tessellation to control.
When to use it
A ring, donut, tube-loop, or handle shape in 3D
A smooth loop for a Distance Field boolean: turn Analytical on
A tube mesh to deform, displace, or subdivide further: keep Analytical off and dial in the segment counts
A chunky low-poly ring: lower both segment counts
| Parameter | Type | Default |
|---|---|---|
fill | OneOf([Color, FieldOf(Color), ColorArray, Field, Material, MaterialArray, RasterArray]) | — |
major_radius | Number | 100 |
minor_radius | Number | 30 |
major_segments | Number | 48 |
minor_segments | Number | 24 |
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
The torus's ring sits in the local XZ plane. Under rotation, the identity it carries for downstream shape operations such as Distance Field booleans only survives at zero rotation. Treat a rotated tessellated torus as a plain mesh rather than a live analytic ring.
Minor Radius is the tube thickness, not its diameter. A Minor Radius half the size of Major Radius gives a fairly fat donut.
Major Segments and Minor Segments only affect the tessellated mesh, and are ignored while Analytical is on.
Worked example
Add a Torus. Set Major Radius for the ring's size and Minor Radius for the tube's thickness.
Raise Major Segments and Minor Segments for a smoother surface, or lower them for a faceted, low-poly look.
Wire a Color or Material into Fill to drive the surface from the graph.
For a Distance Field boolean with another shape, turn Analytical on.