Merge pull request #8765 from fredj/cameraUnderground_scene

Add cameraUnderground property to the Scene

Author: lilleyse

CHANGES.md

@@ -4,6 +4,7 @@
 
 ##### Additions :tada:
 
+- Added `Scene.cameraUnderground` for checking whether the camera is underneath the globe. [#8765](https://github.com/CesiumGS/cesium/pull/8765)
 - Added `RequestScheduler` to the public API; this allows users to have more control over the requests made by CesiumJS. [#8384](https://github.com/CesiumGS/cesium/issues/8384)
 
 ##### Fixes :wrench:

Source/Scene/Scene.js

@@ -1435,6 +1435,7 @@ Object.defineProperties(Scene.prototype, {
    * Gets the scalar used to exaggerate the terrain.
    * @memberof Scene.prototype
    * @type {Number}
+   * @readonly
    */
   terrainExaggeration: {
     get: function () {
@@ -1490,6 +1491,7 @@ Object.defineProperties(Scene.prototype, {
    * Determines if the 2D map is rotatable or can be scrolled infinitely in the horizontal direction.
    * @memberof Scene.prototype
    * @type {MapMode2D}
+   * @readonly
    */
   mapMode2D: {
     get: function () {
@@ -1597,6 +1599,7 @@ Object.defineProperties(Scene.prototype, {
    * Whether or not high dynamic range rendering is supported.
    * @memberof Scene.prototype
    * @type {Boolean}
+   * @readonly
    * @default true
    */
   highDynamicRangeSupported: {
@@ -1609,6 +1612,19 @@ Object.defineProperties(Scene.prototype, {
     },
   },
 
+  /**
+   * Whether or not the camera is underneath the globe.
+   * @memberof Scene.prototype
+   * @type {Boolean}
+   * @readonly
+   * @default false
+   */
+  cameraUnderground: {
+    get: function () {
+      return this._cameraUnderground;
+    },
+  },
+
   /**
    * Gets or sets the color of the light emitted by the sun.
    *

Specs/Scene/SceneSpec.js

@@ -2035,7 +2035,7 @@ describe(
 
       return updateGlobeUntilDone(scene)
         .then(function () {
-          expect(scene._cameraUnderground).toBe(false);
+          expect(scene.cameraUnderground).toBe(false);
 
           // Look underground
           scene.camera.setView({
@@ -2053,7 +2053,7 @@ describe(
           return updateGlobeUntilDone(scene);
         })
         .then(function () {
-          expect(scene._cameraUnderground).toBe(true);
+          expect(scene.cameraUnderground).toBe(true);
           scene.destroyForSpecs();
         });
     });
@@ -2069,15 +2069,15 @@ describe(
       ).and.returnValue(true);
 
       return updateGlobeUntilDone(scene).then(function () {
-        expect(scene._cameraUnderground).toBe(false);
+        expect(scene.cameraUnderground).toBe(false);
         scene.destroyForSpecs();
       });
     });
 
     it("detects that camera is above ground if globe is undefined", function () {
       var scene = createScene();
       scene.renderForSpecs();
-      expect(scene._cameraUnderground).toBe(false);
+      expect(scene.cameraUnderground).toBe(false);
       scene.destroyForSpecs();
     });
 
@@ -2086,7 +2086,7 @@ describe(
       var globe = new Globe();
       scene.globe = globe;
       scene.morphTo2D(0.0);
-      expect(scene._cameraUnderground).toBe(false);
+      expect(scene.cameraUnderground).toBe(false);
       scene.destroyForSpecs();
     });
 
@@ -2095,7 +2095,7 @@ describe(
       var globe = new Globe();
       scene.globe = globe;
       scene.morphTo2D(1.0);
-      expect(scene._cameraUnderground).toBe(false);
+      expect(scene.cameraUnderground).toBe(false);
       scene.destroyForSpecs();
     });
 
@@ -2120,7 +2120,7 @@ describe(
       scene.morphToColumbusView(0.0);
 
       return updateGlobeUntilDone(scene).then(function () {
-        expect(scene._cameraUnderground).toBe(true);
+        expect(scene.cameraUnderground).toBe(true);
         scene.destroyForSpecs();
       });
     });