Instance Method

renderer(_:didRenderScene:atTime:)

Tells the delegate that the renderer has rendered the scene.

Declaration

optional func renderer(_ renderer: SCNSceneRenderer, didRenderScene scene: SCNScene, atTime time: TimeInterval)

Parameters

aRenderer

The SceneKit object responsible for rendering the scene.

scene

The scene object that was rendered.

time

The current system time, in seconds. If your custom rendering involves animation, use this parameter to compute your own animation state.

Discussion

Implement this method to perform custom drawing after SceneKit has rendered a scene—for example, to draw overlay content on top of SceneKit content. You should only execute Metal or OpenGL drawing commands (and any setup required to perform them) in this method—the results of modifying SceneKit objects in this method are undefined.

  • To render using Metal, use the renderer parameter to retrieve the scene renderer’s currentRenderCommandEncoder object and encode your own drawing commands. If you need to reference other Metal state, see the properties listed in SCNSceneRenderer.

  • To render using OpenGL, simply call the relevant OpenGL drawing commands—SceneKit automatically makes its OpenGL context the current context before calling this method. If you need to reference the OpenGL context being rendered into, examine the context property of the renderer parameter.

You must draw using the appropriate graphics technology for the view currently being rendered. Use the renderingAPI property of the renderer object to determine whether Metal or OpenGL is in use.

See Also

Rendering Custom Scene Content

func renderer(SCNSceneRenderer, willRenderScene: SCNScene, atTime: TimeInterval)

Tells the delegate that the renderer has cleared the viewport and is about to render the scene.