View content beneath the terrain surface

View on GitHubSample viewer app

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

Image of view content beneath the terrain surface

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 to use the sample

The sample loads a scene with underground features. Pan and zoom to explore the scene. Observe how the opacity of the base surface is reduced and the navigation constraint is removed, allowing you to pan and zoom through the base surface.

How it works

  1. Display an ArcGISScene 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
  • NavigationConstraint

About the data

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

Tags

3D, subsurface, underground, utilities

Sample Code

ViewContentBeneathTerrainSurfaceSample.java
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
package com.esri.samples.view_content_beneath_terrain_surface;

import javafx.application.Application;
import javafx.scene.Scene;
import javafx.scene.control.ProgressIndicator;
import javafx.scene.layout.StackPane;
import javafx.stage.Stage;

import com.esri.arcgisruntime.mapping.ArcGISScene;
import com.esri.arcgisruntime.mapping.NavigationConstraint;
import com.esri.arcgisruntime.mapping.view.DrawStatus;
import com.esri.arcgisruntime.mapping.view.SceneView;

public class ViewContentBeneathTerrainSurfaceSample extends Application {

  private SceneView sceneView;
  private ArcGISScene scene; // keep loadable in scope to avoid garbage collection

  @Override
  public void start(Stage stage) throws Exception {

    // create stack pane and JavaFX app scene
    StackPane stackPane = new StackPane();
    Scene fxScene = new Scene(stackPane);

    // set title, size, and add JavaFX scene to stage
    stage.setTitle("View Content Beneath Terrain Surface Sample");
    stage.setWidth(800);
    stage.setHeight(700);
    stage.setScene(fxScene);
    stage.show();

    // create a scene from a web scene Url and set it to the scene view
    scene = new ArcGISScene("https://www.arcgis.com/home/item.html?id=91a4fafd747a47c7bab7797066cb9272");
    sceneView = new SceneView();
    sceneView.setArcGISScene(scene);

    // add a progress indicator and display it when scene view drawing is in progress
    var progressIndicator = new ProgressIndicator();
    progressIndicator.visibleProperty().bind(sceneView.drawStatusProperty().isEqualTo(DrawStatus.IN_PROGRESS));

    // once the scene has loaded, set the navigation constraint and opacity of the base surface
    scene.addDoneLoadingListener(() -> {
      // ensure the navigation constraint is set to NONE to view content beneath the terrain surface
      scene.getBaseSurface().setNavigationConstraint(NavigationConstraint.NONE);
      // set opacity to view content beneath the base surface
      scene.getBaseSurface().setOpacity(0.4f);
    });

    // add the scene view and progress indicator to the stack pane
    stackPane.getChildren().addAll(sceneView, progressIndicator);
  }

  /**
   * Stops and releases all resources used in application.
   */
  @Override
  public void stop() {

    if (sceneView != null) {
      sceneView.dispose();
    }
  }

  /**
   * Opens and runs application.
   *
   * @param args arguments passed to this application
   */
  public static void main(String[] args) {

    Application.launch(args);
  }
}

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