Skip To Content ArcGIS for Developers Sign In Dashboard

ArcGIS Runtime SDK for .NET

View content beneath terrain surface

This code sample is available for these platforms:
View Sample on GitHub

See through terrain in a scene and move the camera underground.

Use case

By default, a scene's terrain is fully opaque and the camera cannot go underground. To see underground features such as pipes in a utility network, you can lower the opacity of the terrain surface and set the navigation constraint on the surface to allow underground navigation.

How it works

Note: This sample uses a web scene, which comes pre-configured with these settings.

  1. Display an Scene in a SceneView which contains layers with underground features.
  2. To see underground, get the scene's base surface and set its opacity to a value between 0 and 1.
  3. To allow the camera to go underground, set the surface's navigation constraint to None.

Relevant API

  • Surface
  • Surface.NavigationConstraint

About the data

This data is a point scene layer showing underground wellbore paths (green polylines) and seismic events (brown points).

Tags

3D, subsurface, underground, utilities

Sample Code

<UserControl
    x:Class="ArcGISRuntime.UWP.Samples.ViewContentBeneathSurface.ViewContentBeneathSurface"
    xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
    xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
    xmlns:esriUI="using:Esri.ArcGISRuntime.UI.Controls">
    <Grid>
        <esriUI:SceneView x:Name="MySceneView" />
    </Grid>
</UserControl>
// Copyright 2019 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.

using Esri.ArcGISRuntime.Mapping;
using Esri.ArcGISRuntime.Portal;

namespace ArcGISRuntime.UWP.Samples.ViewContentBeneathSurface
{
    [ArcGISRuntime.Samples.Shared.Attributes.Sample(
        "View content beneath terrain surface",
        "Map",
        "See through terrain in a scene and move the camera underground.",
        "")]
    public partial class ViewContentBeneathSurface
    {
        public ViewContentBeneathSurface()
        {
            InitializeComponent();
            Initialize();
        }

        private async void Initialize()
        {
            // Load the item from ArcGIS Online.
            PortalItem webSceneItem = await PortalItem.CreateAsync(await ArcGISPortal.CreateAsync(), "91a4fafd747a47c7bab7797066cb9272");

            // Load the web scene from the item.
            Scene webScene = new Scene(webSceneItem);

            // Show the web scene in the view.
            MySceneView.Scene = webScene;

            // Set the view properties to enable underground navigation.
            // Note: the scene in this sample sets these properties automatically.
            // Scenes authored in this way will be enabled for underground navigation without
            // changing the navigation constraint manually.
            MySceneView.Scene.BaseSurface.NavigationConstraint = NavigationConstraint.None;
            MySceneView.Scene.BaseSurface.Opacity = .6;
        }
    }
}