Display a scene layer

View on GitHubSample viewer app

Add a scene layer to a scene.

screenshot

Use case

Each scene layer added to a scene can assist in performing helpful visual analysis. For example, if presenting the results of a shadow analysis of a major metropolitan downtown area in 3D, adding a scene layer of 3D buildings to the scene that could be toggled on/off would help to better contextualize the source of the shadows.

How to use the sample

When launched, this sample displays a scene service with an ArcGISSceneLayer. Pan and zoom to explore the scene.

How it works

  1. Create a Scene and set its Basemap with Scene::setBasemap().
  2. Create a Surface and add an elevation source to it: surface::elevationSources()::append(arcGISTiledElevationSource).
  3. Add the created surface to the scene: Scene::setBaseSurface(surface).
  4. Create a SceneView and set the scene to the view with SceneView::setArcGISScene(scene).
  5. Create an ArcGISSceneLayer using a data source URL: new ArcGISSceneLayer(URL).
  6. Add the new scene layer to the scene as an operational layer with ArcGISScene::operationalLayers()::append(sceneLayer).

Relevant API

  • ArcGISSceneLayer
  • ArcGISTiledElevationSource
  • Scene
  • SceneView
  • Surface

About the data

The scene launches with a northward view of the city of Brest, France. A 3D scene layer representing buildings (some textured) is used as an example.

Tags

3D, layer, scene

Sample Code

DisplaySceneLayer.cppDisplaySceneLayer.cppDisplaySceneLayer.hDisplaySceneLayer.qml
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
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
// [WriteFile Name=DisplaySceneLayer, Category=Scenes]
// [Legal]
// Copyright 2016 Esri.
//
// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the License.
// You may obtain a copy of the License at
// http://www.apache.org/licenses/LICENSE-2.0
//
// Unless required by applicable law or agreed to in writing, software
// distributed under the License is distributed on an "AS IS" BASIS,
// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
// See the License for the specific language governing permissions and
// limitations under the License.
// [Legal]

#ifdef PCH_BUILD
#include "pch.hpp"
#endif // PCH_BUILD

// sample headers
#include "DisplaySceneLayer.h"

// ArcGIS Maps SDK headers
#include "ArcGISSceneLayer.h"
#include "ArcGISTiledElevationSource.h"
#include "Basemap.h"
#include "Camera.h"
#include "ElevationSourceListModel.h"
#include "LayerListModel.h"
#include "MapTypes.h"
#include "Point.h"
#include "Scene.h"
#include "SceneQuickView.h"
#include "SpatialReference.h"
#include "Surface.h"
#include "Viewpoint.h"

using namespace Esri::ArcGISRuntime;

DisplaySceneLayer::DisplaySceneLayer(QQuickItem* parent) :
  QQuickItem(parent)
{
}

DisplaySceneLayer::~DisplaySceneLayer() = default;

void DisplaySceneLayer::init()
{
  qmlRegisterType<SceneQuickView>("Esri.Samples", 1, 0, "SceneView");
  qmlRegisterType<DisplaySceneLayer>("Esri.Samples", 1, 0, "DisplaySceneLayerSample");
}

void DisplaySceneLayer::componentComplete()
{
  QQuickItem::componentComplete();

  // find QML SceneView component
  m_sceneView = findChild<SceneQuickView*>("sceneView");

  // create a new scene instance
  Basemap* basemap = new Basemap(BasemapStyle::ArcGISTopographic, this);
  m_scene = new Scene(basemap, this);

  //! [add a scene service with ArcGISSceneLayer]
  m_sceneLayer = new ArcGISSceneLayer(QUrl("https://tiles.arcgis.com/tiles/P3ePLMYs2RVChkJx/arcgis/rest/services/Buildings_Brest/SceneServer/layers/0"), this);
  m_scene->operationalLayers()->append(m_sceneLayer);
  //! [add a scene service with ArcGISSceneLayer]

  // create a new elevation source and add to scene
  ArcGISTiledElevationSource* elevationSource = new ArcGISTiledElevationSource(QUrl("https://elevation3d.arcgis.com/arcgis/rest/services/WorldElevation3D/Terrain3D/ImageServer"), this);
  m_scene->baseSurface()->elevationSources()->append(elevationSource);

  // create a camera and set the initial viewpoint
  Point pt(-4.49779155626782, 48.38282454039932, 62.013264927081764, SpatialReference(4326));
  Camera camera(pt, 41.64729875588979, 71.2017391571523, 2.194677223e-314);
  Viewpoint initViewpoint(pt, camera);
  m_scene->setInitialViewpoint(initViewpoint);

  // set scene on the scene view
  m_sceneView->setArcGISScene(m_scene);
}

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