The number of subdivisions SceneKit uses to smooth the geometry’s surface at render time.
- iOS 8.0+
- macOS 10.10+
- Mac Catalyst 13.0+Beta
- tvOS 9.0+
- watchOS 2.0+
Surface subdivision is a technique for using low-detail geometry to generate a smooth surface for rendering. When you increase the
subdivision value of a geometry, SceneKit automatically splits each face in the rendered surface, creating a more detailed, smoother geometry, as shown in . SceneKit performs this subdivision process at render time, preserving the original geometry data.
ubdividing a surface rounds away any sharp edges and corners in the geometry; however, such details may be important to a model’s design. To preserve edges, use the
edge property to identify edges and the
edge property to specify how smooth or sharp they should appear after subdivision. To preserve corners, include a geometry source whose
semantic value is
vertex when creating the geometry.
The default subdivision level is zero, specifying no subdivision—SceneKit renders the geometry exactly as its vertex data specifies.