Instance Property

allowsCameraControl

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

Declaration

@property(nonatomic) BOOL allowsCameraControl;

Discussion

If you set this property to YES, 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 defaultCameraController 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 cameraControlConfiguration 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 fieldOfView)

The default value of this property is NO. Use this option if you intend to control the camera programmatically.

See Also

Managing Camera Controls

cameraControlConfiguration

The current configuration for the camera controller's event-handling behavior.

SCNCameraControlConfiguration

Properties affecting the behavior of a camera controller.