Prepares the specified SceneKit objects for rendering, using a background thread.
- iOS 8.0+
- macOS 10.10+
- Mac Catalyst 13.0+
- tvOS 9.0+
- watchOS 2.0+
A block that SceneKit calls when object preparation fails or completes.
The block takes the following parameter:
trueif all content was successfully prepared for rendering; otherwise,
By default, SceneKit lazily loads resources onto the GPU for rendering. This approach uses memory and GPU bandwidth efficiently, but can lead to stutters in an otherwise smooth frame rate when you add large amounts of new content to an animated scene. To avoid such issues, use this method to prepare content for drawing before adding it to the scene. SceneKit uses a secondary thread to prepare content asynchronously.
SceneKit prepares all content associated with the objects you provide. If you provide an
SCNMaterial object, SceneKit loads any texture images assigned to its material properties. If you provide an
SCNGeometry object, SceneKit loads all materials attached to the geometry, as well as its vertex data. If you provide an
SCNScene object, SceneKit loads all geometries and materials associated with the node and all its child nodes, or with the entire node hierarchy of the scene.
You can observe the progress of this operation with the
Progress class. For details, see