SCNView

See:

• https://developer.apple.com/documentation/scenekit/scnview.option

Initializes and returns a newly allocated SceneKit view object with the specified frame rectangle and options.

See:

• https://developer.apple.com/documentation/scenekit/scnview/1524215-init

A Boolean value that determines whether the user can manipulate the current point of view that is used to render the scene.

See:

• https://developer.apple.com/documentation/scenekit/scnview/1523171-allowscameracontrol

The antialiasing mode used for rendering the view’s scene.

See:

• https://developer.apple.com/documentation/scenekit/scnview/1524085-antialiasingmode

SceneKit uses this audio engine to play sounds from SCNAudioPlayer objects attached to nodes in the scene. You can use this object directly to add other sound sources not related to scene contents, or to add other sound processing nodes or mixing nodes to the audio engine. To identify the node SceneKit uses for spatializing scene sounds when connecting other nodes, use the audioEnvironmentNode property.

See:

• https://developer.apple.com/documentation/scenekit/scnscenerenderer/1522686-audioengine

SceneKit uses this audio node to spatialize sounds from SCNAudioPlayer objects attached to nodes in the scene. You can use this object in conjunction with the audioEngine property to rearrange the audio graph to add other, non-spatialized audio sources or mix in audio processing effects.

See:

• https://developer.apple.com/documentation/scenekit/scnscenerenderer/1523582-audioenvironmentnode

Required. The node representing the listener’s position in the scene for use with positional audio effects.

See:

• https://developer.apple.com/documentation/scenekit/scnscenerenderer/1523747-audiolistener

Required. A Boolean value that determines whether SceneKit automatically adds lights to a scene.

See:

• https://developer.apple.com/documentation/scenekit/scnscenerenderer/1523812-autoenablesdefaultlighting

Use this property, along with the depthPixelFormat and stencilPixelFormat properties, if you perform custom drawing with Metal (see the SCNSceneRendererDelegate and SCNNodeRendererDelegate classes) and need to create a new MTLRenderPipelineState object to change the GPU state as part of your rendering.NoteThis property is valid only for scene renderers whose renderingAPI value is metal. You create a SceneKit view that renders using Metal with the preferredRenderingAPI initialization option or in Interface Builder, or an SCNRenderer that uses Metal with the init(device:options:) method. For OpenGL-based scene renderers, this property’s value is always nil.

See:

• https://developer.apple.com/documentation/scenekit/scnscenerenderer/1523701-colorpixelformat

Use this property to schedule additional command buffers for the Metal device to execute as part of the render cycle. For example, you can use a compute command encoder to modify the vertex data in a Metal buffer for use by a SCNGeometrySource object.NoteThis property is valid only for scene renderers whose renderingAPI value is metal. You create a SceneKit view that renders using Metal with the preferredRenderingAPI initialization option or in Interface Builder, or an SCNRenderer that uses Metal with the init(device:options:) method. For OpenGL-based scene renderers, this property’s value is always nil.

See:

• https://developer.apple.com/documentation/scenekit/scnscenerenderer/1523974-commandqueue

In macOS, the value of this property is a Core OpenGL cglContextObj object.In iOS, the value of this property is an EAGLContext object.

See:

• https://developer.apple.com/documentation/scenekit/scnscenerenderer/1522840-context

Use this render command encoder to encode additional rendering commands before or after SceneKit draws its own content.This property is valid only during the SceneKit rendering loop—that is, within one of the methods defined in the SCNSceneRendererDelegate protocol. Accessing this property at any other time returns nil.

See:

• https://developer.apple.com/documentation/scenekit/scnscenerenderer/1522609-currentrendercommandencoder

Required.

See:

• https://developer.apple.com/documentation/scenekit/scnscenerenderer/1522854-currenttime

Required. Options for drawing overlay content in a scene that can aid debugging.

See:

• https://developer.apple.com/documentation/scenekit/scnscenerenderer/1523281-debugoptions

Required. A delegate object that receives messages about SceneKit’s rendering process.

See:

• https://developer.apple.com/documentation/scenekit/scnscenerenderer/1522671-delegate

Required. A delegate object that receives messages about SceneKit’s rendering process.

See:

• https://developer.apple.com/documentation/scenekit/scnscenerenderer/1522671-delegate

Use this property, along with the colorPixelFormat and stencilPixelFormat properties, if you perform custom drawing with Metal (see the SCNSceneRendererDelegate and SCNNodeRendererDelegate classes) and need to create a new MTLRenderPipelineState object to change the GPU state as part of your rendering.NoteThis property is valid only for scene renderers whose renderingAPI value is metal. You create a SceneKit view that renders using Metal with the preferredRenderingAPI initialization option or in Interface Builder, or an SCNRenderer that uses Metal with the init(device:options:) method. For OpenGL-based scene renderers, this property’s value is always nil.

See:

• https://developer.apple.com/documentation/scenekit/scnscenerenderer/1523780-depthpixelformat

Use this property to create or look up other Metal resources that use the same device as your SceneKit renderer.NoteThis property is valid only for scene renderers whose renderingAPI value is metal. You create a SceneKit view that renders using Metal with the preferredRenderingAPI initialization option or in Interface Builder, or an SCNRenderer that uses Metal with the init(device:options:) method. For OpenGL-based scene renderers, this property’s value is always nil.

See:

• https://developer.apple.com/documentation/scenekit/scnscenerenderer/1523935-device

Required. A Boolean value that determines whether SceneKit applies jittering to reduce aliasing artifacts.

See:

• https://developer.apple.com/documentation/scenekit/scnscenerenderer/1524026-isjitteringenabled

Required. A Boolean value that determines whether the scene is playing.

See:

• https://developer.apple.com/documentation/scenekit/scnscenerenderer/1523401-isplaying

Required. A Boolean value that determines whether the scene is playing.

See:

• https://developer.apple.com/documentation/scenekit/scnscenerenderer/1523401-isplaying

Required. A Boolean value that determines whether SceneKit restarts the scene time after all animations in the scene have played.

See:

• https://developer.apple.com/documentation/scenekit/scnscenerenderer/1522878-loops

Required. A Sprite Kit scene to be rendered on top of the SceneKit content.

See:

• https://developer.apple.com/documentation/scenekit/scnscenerenderer/1524051-overlayskscene

The view’s OpenGL pixel format.

See:

• https://developer.apple.com/documentation/scenekit/scnview/1523612-pixelformat

Required. The node from which the scene’s contents are viewed for rendering.

See:

• https://developer.apple.com/documentation/scenekit/scnscenerenderer/1523982-pointofview

The animation frame rate that the view uses to render its scene.

See:

• https://developer.apple.com/documentation/scenekit/scnview/1621205-preferredframespersecond

You choose a graphics technology when initializing a scene renderer:When initializing a SCNView object, use the init(frame:options:) initializer and the preferredRenderingAPI key. Alternatively, create a view in Interface Builder and use the Rendering API control in the inspector. During initialization, the view will attempt to use the preferred API, but will fall back to a different API if the preferred one is not supported on the current hardware.To create a SCNRenderer object that renders into your own OpenGL contect, use the init(context:options:) initializer. To create a renderer for use in your own Metal workflow, use the init(device:options:) initializer.The rendering technology used by a SCNLayer object is determined by Core Animation.After initializing a renderer, this property reflects the rendering technology in use.

See:

• https://developer.apple.com/documentation/scenekit/scnscenerenderer/1522616-renderingapi

Required. The current scene time.

See:

• https://developer.apple.com/documentation/scenekit/scnscenerenderer/1522680-scenetime

Required. A Boolean value that determines whether SceneKit displays rendering performance statistics in an accessory view.

See:

• https://developer.apple.com/documentation/scenekit/scnscenerenderer/1522763-showsstatistics

Use this property, along with the depthPixelFormat and colorPixelFormat properties, if you perform custom drawing with Metal (see the SCNSceneRendererDelegate and SCNNodeRendererDelegate classes) and need to create a new MTLRenderPipelineState object to change the GPU state as part of your rendering.NoteThis property is valid only for scene renderers whose renderingAPI value is metal. You create a SceneKit view that renders using Metal with the preferredRenderingAPI initialization option or in Interface Builder, or an SCNRenderer that uses Metal with the init(device:options:) method. For OpenGL-based scene renderers, this property’s value is always nil.

See:

• https://developer.apple.com/documentation/scenekit/scnscenerenderer/1523315-stencilpixelformat

Required. The technique SceneKit uses when rendering the object.

See:

• https://developer.apple.com/documentation/scenekit/scntechniquesupport/1520496-technique

A 2D point in the rendered screen coordinate space can refer to any point along a line segment in the 3D scene coordinate space. Hit-testing is the process of finding elements of a scene located along this line segment. For example, you can use this method to find the geometry corresponding to a click event in a SceneKit view.

See:

• https://developer.apple.com/documentation/scenekit/scnscenerenderer/1522929-hittest

Any node containing a camera or spotlight may serve as a point of view (see the pointOfView property for details). Such a node defines a viewing frustum—a portion of the scene’s coordinate space, shaped like a truncated pyramid, that encloses all points visible from that point of view.Use this method to test whether a node lies within the viewing frustum defined by another node (which may or may not be the scene renderer’s current pointOfView node). For example, in a game scene containing multiple camera nodes, you could use this method to determine which camera is currently best for viewing a moving player character.Note that this method does not perform occlusion testing. That is, it returns true if the tested node lies within the specified viewing frustum regardless of whether that node’s contents are obscured by other geometry.

See:

• https://developer.apple.com/documentation/scenekit/scnscenerenderer/1522647-isnode

Any node containing a camera or spotlight may serve as a point of view (see the pointOfView property for details). Such a node defines a viewing frustum—a portion of the scene’s coordinate space, shaped like a truncated pyramid, that encloses all points visible from that point of view.Use this method find all nodes whose content lies within the viewing frustum defined by another node (which may or may not be the scene renderer’s current pointOfView node).Note that this method does not perform occlusion testing. That is, the returned array includes any node that lies within the specified viewing frustum regardless of whether that node’s contents are obscured by other geometry.

See:

• https://developer.apple.com/documentation/scenekit/scnscenerenderer/1522942-nodesinsidefrustum

This method has no effect if the scene is already paused.

See:

• https://developer.apple.com/documentation/scenekit/scnview/1522825-pause

This method has no effect if the scene is not paused.

See:

• https://developer.apple.com/documentation/scenekit/scnview/1523699-play

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 SCNNode or 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 Progress.

See:

• https://developer.apple.com/documentation/scenekit/scnscenerenderer/1523375-prepare

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. You can call this method on a secondary thread to prepare content asynchronously. SceneKit prepares all content associated with the object parameter 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 SCNNode or 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 use the block parameter to cancel preparation if content is no longer needed. For example, in a game you might use this method to preload areas of the game world the player is soon to enter, but if the player character dies before entering those areas, you can return true from the block to cancel preloading.You can observe the progress of this operation with the Progress class. For details, see Progress.

See:

• https://developer.apple.com/documentation/scenekit/scnscenerenderer/1522798-prepare

Use this method to change the scene displayed in a SceneKit view (or other renderer) with an animated transition. For details on transition styles, see SKTransition.

See:

• https://developer.apple.com/documentation/scenekit/scnscenerenderer/1523028-present

The z-coordinate of the returned point describes the depth of the projected point relative to the near and far clipping planes of the renderer’s viewing frustum (defined by its pointOfView node). Projecting a point on the near clipping plane returns a point whose z-coordinate is 0.0; projecting a point on the far clipping plane returns a point whose z-coordinate is 1.0.

See:

• https://developer.apple.com/documentation/scenekit/scnscenerenderer/1524089-projectpoint

This method is thread-safe and may be called at any time.

See:

• https://developer.apple.com/documentation/scenekit/scnview/1524031-snapshot

Stops playback of the view’s scene and resets the scene time to its start time.

See:

• https://developer.apple.com/documentation/scenekit/scnview/1524132-stop

The z-coordinate of the point parameter describes the depth at which to unproject the point relative to the near and far clipping planes of the renderer’s viewing frustum (defined by its pointOfView node). Unprojecting a point whose z-coordinate is 0.0 returns a point on the near clipping plane; unprojecting a point whose z-coordinate is 1.0 returns a point on the far clipping plane.A 2D point in the rendered screen coordinate space can refer to any point along a line segment in the 3D scene coordinate space. To test for scene contents along this line—for example, to find the geometry corresponding to the location of a click event in a view—use the hitTest(_:options:) method.

See:

• https://developer.apple.com/documentation/scenekit/scnscenerenderer/1522631-unprojectpoint