Class

SCNReferenceNode

A scene graph node that serves as a placeholder for content to be loaded from a separate scene file.

Declaration

@interface SCNReferenceNode : SCNNode

Overview

When you tell a reference node to load its content, SceneKit loads the referenced scene file and makes children of the scene file’s root node become children of the reference node.

Topics

Creating a Reference Node

- initWithURL:

Initializes a node whose content is to be loaded from the referenced URL.

+ referenceNodeWithURL:

Creates a node whose content is to be loaded from the referenced URL.

Loading and Unloading a Reference Node’s Content

referenceURL

The URL to a scene file from which to load content for the reference node.

loadingPolicy

An option for whether to load the node’s content automatically.

- load

Loads content into the node from its referenced external scene file.

loaded

A Boolean value that indicates whether the reference node has already loaded its content.

- unload

Removes the node’s children and marks the node as not loaded.

Constants

SCNReferenceLoadingPolicy

Options for when to load the reference node’s content, used by the loadingPolicy property.

Initializers

Relationships

Inherits From

See Also

Scene Structure

Organizing a Scene with Nodes

Use nodes to define the structure of a scene.

SCNNode

A structural element of a scene graph, representing a position and transform in a 3D coordinate space, to which you can attach geometry, lights, cameras, or other displayable content.