Instantiates a scene from the scene source with the specified options.
- iOS 8.0+
- macOS 10.8+
- tvOS 9.0+
- watchOS 3.0+
A dictionary containing options that affect scene loading. See Scene Loading Options for available keys and values. Pass
nilto use default options.
A pointer to an error object. If loading fails, the method returns
niland this pointer references an
NSErrorobject describing the error. Pass
nilif you do not want error information.
SCNScene object containing the entire scene graph from the scene source, or
nil if loading was not successful.
Calling this method is equivalent to calling
scene with a block that checks its
error parameter to see whether the status is
SCNScene. To load a scene without creating a scene source object, use the
A scene source can contain objects that are not part of its scene graph. To obtain these objects, you must load them individually with the the
entries method. For example, a scene file containing a game character could include several animations for the character geometry (such as running, jumping, and standing idle). Because you typically do not apply multiple animations at once, the scene file contains these animations without their being attached to the character geometry.