CesiumGS · lilleyse · Oct 17, 2022 · Jun 23, 2021 · Jun 24, 2021 · Jun 30, 2021
diff --git a/Apps/Sandcastle/gallery/I3S 3D Object Layer.html b/Apps/Sandcastle/gallery/I3S 3D Object Layer.html
@@ -0,0 +1,77 @@
+<!DOCTYPE html>
+<html lang="en">
+  <head>
+    <meta charset="utf-8" />
+    <meta http-equiv="X-UA-Compatible" content="IE=edge" />
+    <meta
+      name="viewport"
+      content="width=device-width, initial-scale=1, maximum-scale=1, minimum-scale=1, user-scalable=no"
+    />
+    <meta
+      name="description"
+      content="Add I3S 3D Object Layer from a service."
+    />
+    <meta name="cesium-sandcastle-labels" content="DataSources, I3S" />
+    <title>I3S Consumption Cesium Demo</title>
+    <script type="text/javascript" src="../Sandcastle-header.js"></script>
+    <script
+      type="text/javascript"
+      src="../../../Build/CesiumUnminified/Cesium.js"
+      nomodule
+    ></script>
+    <script type="module" src="../load-cesium-es6.js"></script>
+  </head>
+
+  <body
+    class="sandcastle-loading"
+    data-sandcastle-bucket="bucket-requirejs.html"
+  >
+    <style>
+      @import url(../templates/bucket.css);
+    </style>
+    <div id="cesiumContainer" class="fullSize"></div>
+    <div id="loadingOverlay">
+      <h1>Loading...</h1>
+    </div>
+    <div id="toolbar"></div>
+    <script id="cesium_sandcastle_script">
+      function startup(Cesium) {
+        "use strict";
+        //Sandcastle_Begin
+        var viewer = new Cesium.Viewer("cesiumContainer", {
+          terrainProvider: new Cesium.createWorldTerrain({}),
+          animation: false,
+          timeline: false,
+        });
+        // Initialize a terrain provider which provides geoid conversion between orthometric (I3S) and ellipsoidial
+        // height systems (cesium world terrain).
+        // source Data was compiled from https://earth-info.nga.mil/#tab_wgs84-data
+        var geoidService = new Cesium.ArcGISTiledElevationTerrainProvider({
+          url:
+            "https://tiles.arcgis.com/tiles/z2tnIkrLQ2BRzr6P/arcgis/rest/services/EGM2008/ImageServer",
+        });
+        //Create I3S dataSource and autocenters camera to the I3S layers' extent
+        var dataSource = new Cesium.I3SDataSource(
+          "San Francisco",
+          viewer.scene,
+          {
+            autoCenterCameraOnStart: true,
+            geoidTiledTerrainProvider: geoidService,
+          }
+        );
+        dataSource.camera = viewer.camera;
+        dataSource
+          .loadUrl(
+            "https://tiles.arcgis.com/tiles/z2tnIkrLQ2BRzr6P/arcgis/rest/services/SanFrancisco_3DObjects_1_7/SceneServer"
+          )
+          .then(function () {});
+        viewer.dataSources.add(dataSource);
+        //Sandcastle_End
+        if (typeof Cesium !== "undefined") {
+          window.startupCalled = true;
+          startup(Cesium);
+        }
+      }
+    </script>
+  </body>
+</html>
diff --git a/Apps/Sandcastle/gallery/I3S 3D Object Layer.jpg b/Apps/Sandcastle/gallery/I3S 3D Object Layer.jpg
diff --git a/Apps/Sandcastle/gallery/I3S Feature Picking.html b/Apps/Sandcastle/gallery/I3S Feature Picking.html
@@ -0,0 +1,153 @@
+<!DOCTYPE html>
+<html lang="en">
+  <head>
+    <meta charset="utf-8" />
+    <meta http-equiv="X-UA-Compatible" content="IE=edge" />
+    <meta
+      name="viewport"
+      content="width=device-width, initial-scale=1, maximum-scale=1, minimum-scale=1, user-scalable=no"
+    />
+    <meta
+      name="description"
+      content="Pick features from an I3S 3D Object Layer."
+    />
+    <meta name="cesium-sandcastle-labels" content="Showcases, I3S" />
+    <title>I3S Feature Picking Cesium Demo</title>
+    <script type="text/javascript" src="../Sandcastle-header.js"></script>
+    <script
+      type="text/javascript"
+      src="../../../Build/CesiumUnminified/Cesium.js"
+      nomodule
+    ></script>
+    <script type="module" src="../load-cesium-es6.js"></script>
+  </head>
+
+  <body
+    class="sandcastle-loading"
+    data-sandcastle-bucket="bucket-requirejs.html"
+  >
+    <style>
+      @import url(../templates/bucket.css);
+    </style>
+    <div id="cesiumContainer" class="fullSize"></div>
+    <div id="loadingOverlay">
+      <h1>Loading...</h1>
+    </div>
+    <div id="toolbar"></div>
+    <script id="cesium_sandcastle_script">
+      function startup(Cesium) {
+        "use strict";
+        //Sandcastle_Begin
+        var viewer = new Cesium.Viewer("cesiumContainer", {
+          terrainProvider: new Cesium.createWorldTerrain({}),
+          animation: false,
+          timeline: false,
+        });
+        // Initialize a terrain provider which provides geoid conversion between orthometric (I3S) and ellipsoidial
+        // height systems (cesium world terrain).
+        // source Data was compiled from https://earth-info.nga.mil/#tab_wgs84-data
+        var geoidService = new Cesium.ArcGISTiledElevationTerrainProvider({
+          url:
+            "https://tiles.arcgis.com/tiles/z2tnIkrLQ2BRzr6P/arcgis/rest/services/EGM2008/ImageServer",
+        });
+        //Create I3S dataSource and autocenters camera to the I3S layers' extent
+        var dataSource = new Cesium.I3SDataSource("New York", viewer.scene, {
+          autoCenterCameraOnStart: true,
+          geoidTiledTerrainProvider: geoidService,
+        });
+        dataSource.camera = viewer.camera;
+        dataSource
+          .loadUrl(
+            "https://tiles.arcgis.com/tiles/z2tnIkrLQ2BRzr6P/arcgis/rest/services/NYC_Attributed_v17/SceneServer"
+          )
+          .then(function () {});
+        viewer.dataSources.add(dataSource);
+        // An entity object which will hold info about the currently selected feature for infobox display
+        var selectedEntity = new Cesium.Entity();
+
+        // Silhouette a feature on selection and show metadata in the InfoBox.
+        viewer.screenSpaceEventHandler.setInputAction(function onLeftClick(
+          movement
+        ) {
+          // Pick a new feature
+          var pickedFeature = viewer.scene.pick(movement.position);
+          if (!Cesium.defined(pickedFeature)) {
+            return;
+          }
+
+          var pickedPosition = viewer.scene.pickPosition(movement.position);
+
+          if (
+            pickedFeature &&
+            pickedFeature.content &&
+            pickedFeature.content.i3sNode
+          ) {
+            var i3sNode = pickedFeature.content.i3sNode;
+            i3sNode.loadFields().then(function () {
+              var geometry = i3sNode.geometryData[0];
+              if (pickedPosition) {
+                var location = geometry.getClosestPointIndexOnTriangle(
+                  pickedPosition.x,
+                  pickedPosition.y,
+                  pickedPosition.z
+                );
+                var description = "No attributes";
+                var name = "";
+                if (
+                  location.index !== -1 &&
+                  geometry.customAttributes["feature-index"]
+                ) {
+                  var featureIndex =
+                    geometry.customAttributes["feature-index"][location.index];
+                  if (Object.keys(i3sNode.fields).length > 0) {
+                    description =
+                      '<table class="cesium-infoBox-defaultTable"><tbody>';
+                    for (var fieldName in i3sNode.fields) {
+                      if (fieldName) {
+                        var field = i3sNode.fields[fieldName];
+                        description += "<tr><th>" + field.name + "</th><td>";
+                        description +=
+                          field.values[featureIndex] + "</td></tr>";
+                        if (
+                          (!name || 0 === name.length) &&
+                          isNameProperty(field.name)
+                        ) {
+                          name = field.values[featureIndex];
+                        }
+                      }
+                    }
+                    description += "</tbody></table>";
+                  }
+                }
+                if (!name || 0 === name.length) {
+                  name = "unknown";
+                }
+                selectedEntity.name = name;
+                selectedEntity.description = description;
+                viewer.selectedEntity = selectedEntity;
+              }
+            });
+          }
+        },
+        Cesium.ScreenSpaceEventType.LEFT_CLICK);
+
+        function isNameProperty(propertyName) {
+          var name = propertyName.toLowerCase();
+          if (
+            name.localeCompare("name") === 0 ||
+            name.localeCompare("objname") === 0
+          ) {
+            return true;
+          }
+          return false;
+        }
+
+        //Sandcastle_End
+        if (typeof Cesium !== "undefined") {
+          window.startupCalled = true;
+          startup(Cesium);
+        }
+      }
+    </script>
+  </body>
+</html>
diff --git a/Apps/Sandcastle/gallery/I3S Feature Picking.jpg b/Apps/Sandcastle/gallery/I3S Feature Picking.jpg
diff --git a/Apps/Sandcastle/gallery/I3S IntegratedMesh Layer.html b/Apps/Sandcastle/gallery/I3S IntegratedMesh Layer.html
@@ -0,0 +1,72 @@
+<!DOCTYPE html>
+<html lang="en">
+  <head>
+    <meta charset="utf-8" />
+    <meta http-equiv="X-UA-Compatible" content="IE=edge" />
+    <meta
+      name="viewport"
+      content="width=device-width, initial-scale=1, maximum-scale=1, minimum-scale=1, user-scalable=no"
+    />
+    <meta
+      name="description"
+      content="Add I3S IntegratedMesh Layer from a service."
+    />
+    <meta name="cesium-sandcastle-labels" content="DataSources, I3S" />
+    <title>I3S Consumption Cesium Demo</title>
+    <script type="text/javascript" src="../Sandcastle-header.js"></script>
+    <script
+      type="text/javascript"
+      src="../../../Build/CesiumUnminified/Cesium.js"
+      nomodule
+    ></script>
+    <script type="module" src="../load-cesium-es6.js"></script>
+  </head>
+
+  <body
+    class="sandcastle-loading"
+    data-sandcastle-bucket="bucket-requirejs.html"
+  >
+    <style>
+      @import url(../templates/bucket.css);
+    </style>
+    <div id="cesiumContainer" class="fullSize"></div>
+    <div id="loadingOverlay">
+      <h1>Loading...</h1>
+    </div>
+    <div id="toolbar"></div>
+    <script id="cesium_sandcastle_script">
+      function startup(Cesium) {
+        "use strict";
+        //Sandcastle_Begin
+        // Create a Viewer instances wiht ArcGIS Tiled Elevation Layer
+        var viewer = new Cesium.Viewer("cesiumContainer", {
+          terrainProvider: new Cesium.ArcGISTiledElevationTerrainProvider({
+            url:
+              "https://elevation3d.arcgis.com/arcgis/rest/services/WorldElevation3D/Terrain3D/ImageServer",
+          }),
+          animation: false,
+          timeline: false,
+        });
+        //Create an I3S DataSource with the camera autocentered to the I3S layers' extent
+        //No need to do a geoid conversion as both the elevation proivder (ArcGISTiledElevationTerrainProvider)
+        //and the I3S layer to be added (Frankfurt) use orthometric height systems .
+        var dataSource = new Cesium.I3SDataSource("Frankfurt", viewer.scene, {
+          autoCenterCameraOnStart: true,
+        });
+        dataSource.camera = viewer.camera;
+        //populate the I3S DataSource with an IntegratedMesh I3S layer URL and add it to the viewer
+        dataSource
+          .loadUrl(
+            "https://tiles.arcgis.com/tiles/u0sSNqDXr7puKJrF/arcgis/rest/services/Frankfurt2017_v17/SceneServer"
+          )
+          .then(function () {});
+        viewer.dataSources.add(dataSource);
+        //Sandcastle_End
+        if (typeof Cesium !== "undefined") {
+          window.startupCalled = true;
+          startup(Cesium);
+        }
+      }
+    </script>
+  </body>
+</html>
diff --git a/Apps/Sandcastle/gallery/I3S IntegratedMesh Layer.jpg b/Apps/Sandcastle/gallery/I3S IntegratedMesh Layer.jpg
diff --git a/Source/Core/ArcGISTiledElevationTerrainProvider.js b/Source/Core/ArcGISTiledElevationTerrainProvider.js
@@ -174,11 +174,17 @@ function ArcGISTiledElevationTerrainProvider(options) {
         );
       }
 
-      that._terrainDataStructure = {
-        elementMultiplier: 1.0,
-        lowestEncodedHeight: metadata.minValues[0],
-        highestEncodedHeight: metadata.maxValues[0],
-      };
+      if (metadata.minValues && metadata.maxValues) {
+        that._terrainDataStructure = {
+          elementMultiplier: 1.0,
+          lowestEncodedHeight: metadata.minValues[0],
+          highestEncodedHeight: metadata.maxValues[0],
+        };
+      } else {
+        that._terrainDataStructure = {
+          elementMultiplier: 1.0,
+        };
+      }
 
       that._ready = true;
 
@@ -201,7 +207,6 @@ Object.defineProperties(ArcGISTiledElevationTerrainProvider.prototype, {
    * are passed an instance of {@link TileProviderError}.
    * @memberof ArcGISTiledElevationTerrainProvider.prototype
    * @type {Event}
-   * @readonly
    */
   errorEvent: {
     get: function () {
@@ -214,7 +219,6 @@ Object.defineProperties(ArcGISTiledElevationTerrainProvider.prototype, {
    * the source of the terrain.  This function should not be called before {@link ArcGISTiledElevationTerrainProvider#ready} returns true.
    * @memberof ArcGISTiledElevationTerrainProvider.prototype
    * @type {Credit}
-   * @readonly
    */
   credit: {
     get: function () {
@@ -234,7 +238,6 @@ Object.defineProperties(ArcGISTiledElevationTerrainProvider.prototype, {
    * not be called before {@link ArcGISTiledElevationTerrainProvider#ready} returns true.
    * @memberof ArcGISTiledElevationTerrainProvider.prototype
    * @type {GeographicTilingScheme}
-   * @readonly
    */
   tilingScheme: {
     get: function () {
@@ -253,7 +256,6 @@ Object.defineProperties(ArcGISTiledElevationTerrainProvider.prototype, {
    * Gets a value indicating whether or not the provider is ready for use.
    * @memberof ArcGISTiledElevationTerrainProvider.prototype
    * @type {Boolean}
-   * @readonly
    */
   ready: {
     get: function () {
@@ -280,7 +282,6 @@ Object.defineProperties(ArcGISTiledElevationTerrainProvider.prototype, {
    * called before {@link ArcGISTiledElevationTerrainProvider#ready} returns true.
    * @memberof ArcGISTiledElevationTerrainProvider.prototype
    * @type {Boolean}
-   * @readonly
    */
   hasWaterMask: {
     get: function () {
@@ -293,7 +294,6 @@ Object.defineProperties(ArcGISTiledElevationTerrainProvider.prototype, {
    * This function should not be called before {@link ArcGISTiledElevationTerrainProvider#ready} returns true.
    * @memberof ArcGISTiledElevationTerrainProvider.prototype
    * @type {Boolean}
-   * @readonly
    */
   hasVertexNormals: {
     get: function () {
@@ -307,7 +307,6 @@ Object.defineProperties(ArcGISTiledElevationTerrainProvider.prototype, {
    * information is not available.
    * @memberof ArcGISTiledElevationTerrainProvider.prototype
    * @type {TileAvailability}
-   * @readonly
    */
   availability: {
     get: function () {
@@ -459,7 +458,7 @@ ArcGISTiledElevationTerrainProvider.prototype.getLevelMaximumGeometricError = fu
  * @param {Number} x The X coordinate of the tile for which to request geometry.
  * @param {Number} y The Y coordinate of the tile for which to request geometry.
  * @param {Number} level The level of the tile for which to request geometry.
- * @returns {Boolean|undefined} Undefined if not supported, otherwise true or false.
+ * @returns {Boolean} Undefined if not supported, otherwise true or false.
  */
 ArcGISTiledElevationTerrainProvider.prototype.getTileDataAvailable = function (
   x,