Add a scene layer to a scene.
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
- Create a
Scene
and set itsBasemap
withScene::setBasemap()
. - Create a
Surface
and add an elevation source to it:surface::elevationSources()::append(arcGISTiledElevationSource)
. - Add the created surface to the scene:
Scene::setBaseSurface(surface)
. - Create a
SceneView
and set the scene to the view withSceneView::setArcGISScene(scene)
. - Create an
ArcGISSceneLayer
using a data source URL:new ArcGISSceneLayer(URL)
. - 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
// [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);
}