A torus, or ring-shaped geometry.
- iOS 8.0+
- macOS 10.8+
- Mac Catalyst 13.0+
- tvOS 9.0+
- watchOS 2.0+
A torus is mathematically defined as a surface of revolution formed by revolving a circle around a coplanar axis. It is the product of two circles: a large ring and a pipe that encircles the ring. SceneKit uses these terms to define the dimensions of a torus geometry in its local coordinate space. The torus’
ring property defines a circle in the x- and z-axis dimensions, centered at the origin, and its
pipe property defines the width of the surface encircling the ring. To change the orientation of a torus, adjust the
transform property of the node containing the torus geometry.
Control the level of detail with the
pipe properties. Higher segment counts produce more vertices and a more smoothly curved surface, which can improve rendering quality at a cost to rendering performance.