ArcGIS Runtime SDK for Qt

Build a new scene

Scenes are the document used for persistence and sharing of 3D content on the ArcGIS platform. To learn about opening scenes from ArcGIS Online and Portal, see Display a scene. This guide describes how to create a new scene programmatically, add content, and show the scene in your app.

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; there are no special restrictions for basemaps in scenes.
  • 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.
To learn more about the types of layers that can be used in scenes, see Layer types described. To learn more about the content that can be used in maps and scenes, see Layers and tables.

Add a scene layer from a service or package

  1. Create a scene that contains a basemap and a scene layer, either from a service or a local package.

    // Create a scene using the imagery BaseMap
    m_cityScene = new Scene(Basemap::topographic(this), this);
    
    
    // Create a new elevation source
    ArcGISTiledElevationSource* elevationSource = new ArcGISTiledElevationSource(
                QUrl("http://elevation3d.arcgis.com/arcgis/rest/services/WorldElevation3D/Terrain3D/ImageServer"), this);
    // Add the elevation source to the scene to display elevation
    m_cityScene->baseSurface()->elevationSources()->append(elevationSource);
    
    
    // add a scene service with ArcGISSceneLayer
    m_sceneLayer = new ArcGISSceneLayer(
                QUrl("http://scene.arcgis.com/arcgis/rest/services/Hosted/Buildings_Brest/SceneServer/layers/0"));
    m_cityScene->operationalLayers()->append(m_sceneLayer);

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

    // Set scene to the scene view
    m_sceneView->setArcGISScene(m_cityScene);

  3. You may want to set the camera (set an initial viewing position) or add graphics.

You can see the complete code in the C++ sample Display Scene Layer.

Add a 3D surface (terrain)

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.

    // Create a new basemap instance
    Basemap* basemap = Basemap::imagery(this);
    // Create a new scene instance
    m_mountainScene = new Scene(basemap, this);
    // Set scene on the scene view
    m_sceneView->setArcGISScene(m_mountainScene);

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

    // Create a new elevation source
    ArcGISTiledElevationSource* elevationSource = new ArcGISTiledElevationSource(
                QUrl("http://elevation3d.arcgis.com/arcgis/rest/services/WorldElevation3D/Terrain3D/ImageServer"), this);
    // Add the elevation source to the scene to display elevation
    m_mountainScene->baseSurface()->elevationSources()->append(elevationSource);

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

// create a camera
Camera camera(28.4, 83.9, 10010.0, 10.0, 80.0, 300.0);

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.

You can see the complete code in the C++ sample Basic Scene View.

// set the viewpoint
m_sceneView->setViewpointCamera(camera);

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  ( ArcGISSceneLayer) to your ArcGIS Runtime app and add it to a Scene. To display the scene layer package, create a new scene layer with a URL pointing to a local scene layer package.

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:

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