A Boolean value that determines whether the user can manipulate the current point of view that is used to render the scene.
- iOS 8.0+
- macOS 10.8+
- tvOS 9.0+
If you set this property to
true, SceneKit creates a camera node and handles mouse or touch events to allow the user to pan, zoom, and rotate their view of the scene. (Enabling user camera control does not modify camera objects already existing in the scene graph or the nodes containing them.)
When you enable user camera control, the
default object handles input events and drives camera behavior. You can use that object's methods and properties to change the style of user camera interaction, and use the
camera property to adjust control sensitivity.
In the default configuration, SceneKit provides the following controls:
Pan with one finger to rotate the camera around the scene
Pan with two fingers to translate the camera on its local xy-plane
Pan with three fingers vertically to move the the camera forward backward
Double-tap to switch to the next camera in the scene
Rotate with two fingers to roll the camera (rotate on the camera node's z-axis)
Pinch to zoom in or zoom out (change the camera's
The default value of this property is
false. Use this option if you intend to control the camera programmatically.