You can navigate scene views (SceneView or LocalSceneView) by:
- Using built-in navigation, such as panning, zooming, and changing pitch.
- By programmatically changing camera position.
Built-in navigation
The scene views have a number of built-in gestures that allow you to navigate a scene using touch screen, mouse, or keyboard.
Basic navigation
Navigation for scene views is the same as navigation for a map view. The following table summarizes the built-in navigation capabilities of the SceneView and LocalSceneView controls:
| Navigation | Mouse | Touch | Key Action (on iOS and Mac Catalyst) |
|---|---|---|---|
| Zoom in | • Scroll backward • Hold shift + drag up • Double tap | • Two finger pinch open 
• Single finger double-tap 
| • = |
| Zoom out | • Scroll forward • Hold shift + drag down | • Two finger pinch close 
• Two finger single-tap | • - |
| Continuous zoom in/out | • N/A | • Single finger double-tap, ending in a vertical up/down drag
| • N/A |
| Move/Pan | • Tap and drag | • Single finger drag
• Flick 
| • ↑ • ↓ • ← • → |
| Rotate the scene | • Hold down ⌥ and drag left/right | • Two finger rotate 
| • ⌥← for left • ⌥→ for right |
| Rotate to North | • N/A | • N/A | • ⌘0 • shift ⌘↑ |
| Camera look-around effect | • N/A | • Single finger double-tap and hold. The camera's heading changes when you drag left/right and the pitch changes at the current location when you drag up/down | • N/A |
| Tilt up/down | • Hold down ⌥ and drag up/down | • N/A | • ⌥↑ to tilt up • ⌥↓ to tilt down |
| Tilt to zero | • N/A | • N/A | • shift 0 |
Advanced navigation
Scene views have additional navigation not found in a map view:
| Navigation | User Action | Key Action (on iOS and Mac Catalyst) |
|---|---|---|
| Tilt the scene | • Two-finger drag 
| • ⌥↑ for tilt up • ⌥↓ for tilt down • ⇧0 for tilt to 0 |
Programmatically change camera position
Your applications can programmatically navigate a 3D scene by creating a new camera and setting it to the view you are working with. A camera defines the location from which you are viewing the scene.
The camera is shown in this image for illustration purposes; when you set camera settings (location, pitch), think of the camera class as a real-life camera you're adjusting the position of.
Set the camera
For example, to point the camera to toward the Snowdon mountainside, use these values:
- For 3D location, use 53.06 latitude, -4.04 longitude, 1289 meters above sea level
- For heading, use 295 degrees
- For pitch, use 71 degrees
- For roll, use 0 degrees
static let snowdonCamera = Camera(
latitude: 53.06,
longitude: -4.04,
altitude: 1289,
heading: 295,
pitch: 71,
roll: 0
)
You now have a new camera to apply to the scene view. You can apply it immediately using set, as shown in the code below for a SceneView, or the camera can be animated to the new position using one of the asynchronous methods.
SceneViewReader { sceneViewProxy in
SceneView(scene: scene)
.task {
await sceneViewProxy.setViewpointCamera(ScenesNavigateView.snowdonCamera)
}
}