Display a scene

Add 3D visualization to your app to view data in its near real-world perspective. To add 3D visualization, assign a scene to a scene view, similar to the way you assign a map to a map view for 2D visualization. A scene view, like its 2D equivalent, the map view, gives you the ability to zoom and pan around the scene.

The data you visualize in your 3D app is defined by the scene class. The types of data you can display in a scene include:

  • Basemaps, which can be draped over surface layers. A surface layer contains elevation information. Other layer types can also be used as a basemap, including ArcGIS and Open Geographic Consortium (OGC) layers like WMS.
  • Operational layers, which can include feature layers or scene layers. Scene layers represent built and natural 3D content such as buildings, trees, valleys, and mountains and can be accessed as scene services or local scene layer packages.
  • Surface layers, which define the elevation information of the 3D visualization. A surface layer can come in many forms, for example, local raster data such as a DEM or DTED or from an ArcGIS image service.

Display a scene using a scene service

  1. Create a scene that contains a basemap and a scene service.

    @property (strong) AGSScene *scene;
    //Create an instance of a scene
    self.scene = [[AGSScene alloc] init];
    //Define the basemap layer with ESRI imagery
    self.scene.basemap = [AGSBasemap imageryBasemap];
    //Create a scene layer from a scene service and add it to a scene
    AGSArcGISSceneLayer *sceneLayer = [[AGSArcGISSceneLayer alloc] initWithURL:[NSURL URLWithString:@"https://tiles.arcgis.com/tiles/P3ePLMYs2RVChkJx/arcgis/rest/services/Buildings_Brest/SceneServer/layers/0"]];        
    [self.scene.operationalLayers addObject:sceneLayer];

  2. To display the scene, assign it to a scene view that you create.

    @property (weak) IBOutlet AGSSceneView *sceneView;
    //Assign a scene to a scene view so that it is displayed
    self.sceneView.scene = self.scene;

  3. Run the project and it should resemble the following image. You can use gestures to pan and zoom around the scene. For more information on navigating the scene, see the Navigate a scene view topic.
  4. You may want to set the camera (set an initial viewing position) or add graphics.
Buildings from a scene layer

Display a scene using a 3D surface

Add a surface layer to a scene with a basemap for 3D visualization in your app.

  1. Create a scene and assign it to a scene view.

    @property (strong) AGSScene *scene;
    //Create an instance of a scene
    self.scene = [[AGSScene alloc] init];
    //Assign a scene to a scene view so that it is displayed
    self.sceneView.scene = self.scene;

  2. Add an elevation surface and apply it to the scene.

    //create an elevation source
    AGSArcGISTiledElevationSource *elevationSource = [[AGSArcGISTiledElevationSource alloc] initWithURL:[NSURL URLWithString:@"http://elevation3d.arcgis.com/arcgis/rest/services/WorldElevation3D/Terrain3D/ImageServer"]];
    //create surface and append the AGSArcGISTiledElevationSource to its elevationsources       
    AGSSurface *surface = [[AGSSurface alloc] init];
    NSMutableArray *mutableArray = [surface.elevationSources mutableCopy];
    [mutableArray addObject:elevationSource];
    surface.elevationSources = mutableArray;
    //apply the surface to the scene
    self.scene.baseSurface = surface;

You can use gestures to pan and zoom around the scene. For more information on navigating the scene, see the Built-in navigation section of the "Navigate a scene view" topic.

Set the camera

The position you view the scene from is defined by a camera class. When you create a new camera class, you must define the following properties:

  • 3D location—Latitude, longitude, and elevation
  • Heading—Direction the camera is pointing towards
  • Pitch—Up and down angle of 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 metres above sea level
  • For heading, use 295 degrees
  • For pitch, use 71 degrees

AGSCamera *snowdonCamera = [[AGSCamera alloc] initWithLatitude:53.06 longitude:-4.04 altitude:1289 heading:295 pitch:71 roll: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.

[self.sceneView setViewpointCamera:snowdonCamera];

Create a scene layer package and local elevation source

ArcGIS Pro allows you to create a scene layer package using a geoprocessing tool. You can add this local scene layer package (.slpk) as a scene layer  (AGSArcGISSceneLayer) to your ArcGIS Runtime app and add it to a AGSScene.

To take this scene layer offline your app can define an elevation surface by consuming local raster datasets on the client. The following formats are supported for creating a local elevation source:

  • CIB1, 5, 10
  • DTED0, 1, 2
  • GeoTIFF
  • HFA
  • HRE
  • IMG
  • JPEG
  • JPEG 2000
  • NITF
  • PNG
  • RPF
  • SRTM1, 2