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 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
Display an ArcGISScene in a SceneView which contains layers with underground features.
To see underground, get the scene's base surface and set its opacity to a value between 0 and 1.
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
75
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.SceneView;
publicclassViewContentBeneathTerrainSurfaceSampleextendsApplication{
private SceneView sceneView;
private ArcGISScene scene; // keep loadable in scope to avoid garbage collection@Overridepublicvoidstart(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 to show the scene is loading ProgressIndicator progressIndicator = new ProgressIndicator(ProgressIndicator.INDETERMINATE_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);
});
// hide the progress indicator once the sceneview has completed drawing sceneView.addDrawStatusChangedListener(event -> progressIndicator.setVisible(false));
// add the scene view and progress indicator to the stack pane stackPane.getChildren().addAll(sceneView, progressIndicator);
}
/**
* Stops and releases all resources used in application.
*/@Overridepublicvoidstop(){
if (sceneView != null) {
sceneView.dispose();
}
}
/**
* Opens and runs application.
*
* @param args arguments passed to this application
*/publicstaticvoidmain(String[] args){
Application.launch(args);
}
}