Navigate a scene view

You can navigate a scene view (a 3D map):

Built-in navigation

The scene view has a number of built-in gestures that allow you to navigate a scene (3D) using the mouse or touch screen.

Basic navigation

Basic navigation for scene views is the same as navigation for map views:

NavigationMouseTouch
Pan    • Hold left button and drag    • Drag
      Drag gesture
    • Flick
      Flick gesture
Zoom in    • Scroll wheel forward
    • Hold center button and drag
    • Spread
      Spread gesture
Zoom out                       • Scroll wheel backward
    • Hold center button and drag
    • Pinch
      Pinch gesture
Rotate    • Hold right button and drag    • Multiple finger hold and twist          
      Twist gesture

Advanced navigation

Scene views have additional navigation not found in map views:

NavigationMouseTouch
Change pitchN/A    • Multiple fingers drag up/down
      Multiple finger drag up/down gesture
Change heading      N/A                                                        • Multiple fingers drag left/right        
      Multiple finger drag left/right gesture

Navigating a scene view on a touch screen warrants some additional details.

There are three navigation modes available using touch: pan mode (single finger), zoom and pan mode (multiple finger), and rotate and pitch mode (multiple finger). For single finger pan, place one finger on the screen. For pan and zoom mode, spread, pinch, or drag two or more fingers. For heading and pitch mode, place multiple fingers on the screen and move with a consistent distance between your fingers. The following list describes the touch gestures used to execute navigation operations in each mode.

  • Pan mode (single finger)
    • Drag: Pans
    • Flick: Pans
  • Pan and zoom mode (multiple fingers)
    • Spread: Zooms in
    • Pinch: Zooms out
    • Drag: Pans
    • Pivot: Rotates
  • Heading and pitch mode (multiple fingers)
    • Drag up and down: Changes pitch
    • Drag left and right: Changes heading

Programmatically change camera position

Your applications can programmatically navigate a 3D scene by creating a new camera and setting it to the scene view. A camera defines the location from which you are viewing the scene.

Camera position for a scene view

The camera is shown in this image for illustration purposes; when you set camera settings (location, pitch), think of the camera class a real-life camera you're adjusting the position of.

Set the camera

For example, to point the camera to toward the Snowdon mountainside, as shown in the following code snippet and image, 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
Use dark colors for code blocksCopy
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
var snowdonCamera = new Camera(53.06, -4.04, 3289, 295, 71, 0);
Surface elevation applied to a scene

Now you have a new camera you can apply to your scene view. You can apply it immediately using SetViewpointCamera as shown in the code below, or the camera can be animated to the new position using one of the asynchronous methods.

Use dark colors for code blocksCopy
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
MySceneView.SetViewpointCamera(snowdonCamera);

Your browser is no longer supported. Please upgrade your browser for the best experience. See our browser deprecation post for more details.