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
MainActivity.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
76
77
78
79
80
81
/*
* 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.
*
*/package com.esri.arcgisruntime.sample.viewcontentbeneaththeterrainsurface;
import android.os.Bundle;
import androidx.appcompat.app.AppCompatActivity;
import android.util.Log;
import android.widget.Toast;
import com.esri.arcgisruntime.loadable.LoadStatus;
import com.esri.arcgisruntime.mapping.ArcGISScene;
import com.esri.arcgisruntime.mapping.NavigationConstraint;
import com.esri.arcgisruntime.mapping.view.SceneView;
import com.esri.arcgisruntime.portal.Portal;
import com.esri.arcgisruntime.portal.PortalItem;
publicclassMainActivityextendsAppCompatActivity{
privatestaticfinal String TAG = MainActivity.class.getSimpleName();
private SceneView mSceneView;
@OverrideprotectedvoidonCreate(Bundle savedInstanceState){
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_main);
mSceneView = findViewById(R.id.sceneView);
Portal portal = new Portal(getString(R.string.arcgis_online_url));
PortalItem portalItem = new PortalItem(portal, getString(R.string.subsurface_item_id));
// catch any load errors from the portal items portalItem.addDoneLoadingListener(() -> {
if (portalItem.getLoadStatus() != LoadStatus.LOADED) {
String error = "Portal item failed to load: " + portalItem.getLoadError();
Log.e(TAG, error);
Toast.makeText(this, error, Toast.LENGTH_LONG).show();
}
});
// create a scene from a web scene Url and set it to the scene view ArcGISScene scene = new ArcGISScene(portalItem);
// ensure the navigation constraint is set to NONE scene.getBaseSurface().setNavigationConstraint(NavigationConstraint.NONE);
// set opacity to view content beneath the base surface scene.getBaseSurface().setOpacity(0.5f);
mSceneView.setScene(scene);
}
@OverrideprotectedvoidonPause(){
mSceneView.pause();
super.onPause();
}
@OverrideprotectedvoidonResume(){
super.onResume();
mSceneView.resume();
}
@OverrideprotectedvoidonDestroy(){
mSceneView.dispose();
super.onDestroy();
}
}