@cesium/engine 10.1.0 → 11.1.0

package/Source/DataSources/TerrainOffsetProperty.js

@@ -5,6 +5,7 @@ import defined from "../Core/defined.js";
 import destroyObject from "../Core/destroyObject.js";
 import Event from "../Core/Event.js";
 import Iso8601 from "../Core/Iso8601.js";
+import JulianDate from "../Core/JulianDate.js";
 import CesiumMath from "../Core/Math.js";
 import HeightReference, {
   isHeightReferenceRelative,
@@ -20,7 +21,7 @@ function TerrainOffsetProperty(
   scene,
   positionProperty,
   heightReferenceProperty,
-  extrudedHeightReferenceProperty
+  extrudedHeightReferenceProperty,
 ) {
   //>>includeStart('debug', pragmas.debug);
   Check.defined("scene", scene);
@@ -47,19 +48,19 @@ function TerrainOffsetProperty(
     this._removeEventListener = scene.terrainProviderChanged.addEventListener(
       function () {
         that._updateClamping();
-      }
+      },
     );
     this._removeModeListener = scene.morphComplete.addEventListener(
       function () {
         that._updateClamping();
-      }
+      },
     );
   }
 
   if (positionProperty.isConstant) {
     const position = positionProperty.getValue(
       Iso8601.MINIMUM_VALUE,
-      scratchPosition
+      scratchPosition,
     );
     if (
       !defined(position) ||
@@ -74,7 +75,7 @@ function TerrainOffsetProperty(
 
     this._normal = scene.ellipsoid.geodeticSurfaceNormal(
       position,
-      this._normal
+      this._normal,
     );
   }
 }
@@ -124,7 +125,7 @@ TerrainOffsetProperty.prototype._updateClamping = function () {
   const ellipsoid = scene.ellipsoid;
   const cartographicPosition = ellipsoid.cartesianToCartographic(
     position,
-    this._cartographicPosition
+    this._cartographicPosition,
   );
 
   const height = scene.getHeight(cartographicPosition, this._heightReference);
@@ -142,25 +143,33 @@ TerrainOffsetProperty.prototype._updateClamping = function () {
   this._removeCallbackFunc = scene.updateHeight(
     cartographicPosition,
     updateFunction,
-    this._heightReference
+    this._heightReference,
   );
 };
 
+const timeScratch = new JulianDate();
+
 /**
  * Gets the height relative to the terrain based on the positions.
  *
+ * @param {JulianDate} [time=JulianDate.now()] The time for which to retrieve the value. If omitted, the current system time is used.
+ * @param {object} [result] The object to store the value into, if omitted, a new instance is created and returned.
  * @returns {Cartesian3} The offset
  */
 TerrainOffsetProperty.prototype.getValue = function (time, result) {
+  if (!defined(time)) {
+    time = JulianDate.now(timeScratch);
+  }
+
   const heightReference = Property.getValueOrDefault(
     this._heightReference,
     time,
-    HeightReference.NONE
+    HeightReference.NONE,
   );
   const extrudedHeightReference = Property.getValueOrDefault(
     this._extrudedHeightReference,
     time,
-    HeightReference.NONE
+    HeightReference.NONE,
   );
 
   if (
@@ -175,7 +184,7 @@ TerrainOffsetProperty.prototype.getValue = function (time, result) {
     return Cartesian3.multiplyByScalar(
       this._normal,
       this._terrainHeight,
-      result
+      result,
     );
   }
 
@@ -195,7 +204,7 @@ TerrainOffsetProperty.prototype.getValue = function (time, result) {
     return Cartesian3.multiplyByScalar(
       this._normal,
       this._terrainHeight,
-      result
+      result,
     );
   }
 

package/Source/DataSources/TimeIntervalCollectionPositionProperty.js

@@ -2,6 +2,7 @@ import defaultValue from "../Core/defaultValue.js";
 import defined from "../Core/defined.js";
 import DeveloperError from "../Core/DeveloperError.js";
 import Event from "../Core/Event.js";
+import JulianDate from "../Core/JulianDate.js";
 import ReferenceFrame from "../Core/ReferenceFrame.js";
 import TimeIntervalCollection from "../Core/TimeIntervalCollection.js";
 import PositionProperty from "./PositionProperty.js";
@@ -20,7 +21,7 @@ function TimeIntervalCollectionPositionProperty(referenceFrame) {
   this._intervals = new TimeIntervalCollection();
   this._intervals.changedEvent.addEventListener(
     TimeIntervalCollectionPositionProperty.prototype._intervalsChanged,
-    this
+    this,
   );
   this._referenceFrame = defaultValue(referenceFrame, ReferenceFrame.FIXED);
 }
@@ -78,17 +79,22 @@ Object.defineProperties(TimeIntervalCollectionPositionProperty.prototype, {
   },
 });
 
+const timeScratch = new JulianDate();
+
 /**
  * Gets the value of the property at the provided time in the fixed frame.
  *
- * @param {JulianDate} time The time for which to retrieve the value.
+ * @param {JulianDate} [time=JulianDate.now()] The time for which to retrieve the value. If omitted, the current system time is used.
  * @param {object} [result] The object to store the value into, if omitted, a new instance is created and returned.
  * @returns {Cartesian3 | undefined} The modified result parameter or a new instance if the result parameter was not supplied.
  */
 TimeIntervalCollectionPositionProperty.prototype.getValue = function (
   time,
-  result
+  result,
 ) {
+  if (!defined(time)) {
+    time = JulianDate.now(timeScratch);
+  }
   return this.getValueInReferenceFrame(time, ReferenceFrame.FIXED, result);
 };
 
@@ -100,32 +106,29 @@ TimeIntervalCollectionPositionProperty.prototype.getValue = function (
  * @param {Cartesian3} [result] The object to store the value into, if omitted, a new instance is created and returned.
  * @returns {Cartesian3 | undefined} The modified result parameter or a new instance if the result parameter was not supplied.
  */
-TimeIntervalCollectionPositionProperty.prototype.getValueInReferenceFrame = function (
-  time,
-  referenceFrame,
-  result
-) {
-  //>>includeStart('debug', pragmas.debug);
-  if (!defined(time)) {
-    throw new DeveloperError("time is required.");
-  }
-  if (!defined(referenceFrame)) {
-    throw new DeveloperError("referenceFrame is required.");
-  }
-  //>>includeEnd('debug');
+TimeIntervalCollectionPositionProperty.prototype.getValueInReferenceFrame =
+  function (time, referenceFrame, result) {
+    //>>includeStart('debug', pragmas.debug);
+    if (!defined(time)) {
+      throw new DeveloperError("time is required.");
+    }
+    if (!defined(referenceFrame)) {
+      throw new DeveloperError("referenceFrame is required.");
+    }
+    //>>includeEnd('debug');
 
-  const position = this._intervals.findDataForIntervalContainingDate(time);
-  if (defined(position)) {
-    return PositionProperty.convertToReferenceFrame(
-      time,
-      position,
-      this._referenceFrame,
-      referenceFrame,
-      result
-    );
-  }
-  return undefined;
-};
+    const position = this._intervals.findDataForIntervalContainingDate(time);
+    if (defined(position)) {
+      return PositionProperty.convertToReferenceFrame(
+        time,
+        position,
+        this._referenceFrame,
+        referenceFrame,
+        result,
+      );
+    }
+    return undefined;
+  };
 
 /**
  * Compares this property to the provided property and returns
@@ -146,7 +149,8 @@ TimeIntervalCollectionPositionProperty.prototype.equals = function (other) {
 /**
  * @private
  */
-TimeIntervalCollectionPositionProperty.prototype._intervalsChanged = function () {
-  this._definitionChanged.raiseEvent(this);
-};
+TimeIntervalCollectionPositionProperty.prototype._intervalsChanged =
+  function () {
+    this._definitionChanged.raiseEvent(this);
+  };
 export default TimeIntervalCollectionPositionProperty;

package/Source/DataSources/TimeIntervalCollectionProperty.js

@@ -1,6 +1,6 @@
 import defined from "../Core/defined.js";
-import DeveloperError from "../Core/DeveloperError.js";
 import Event from "../Core/Event.js";
+import JulianDate from "../Core/JulianDate.js";
 import TimeIntervalCollection from "../Core/TimeIntervalCollection.js";
 import Property from "./Property.js";
 
@@ -45,7 +45,7 @@ function TimeIntervalCollectionProperty() {
   this._intervals = new TimeIntervalCollection();
   this._intervals.changedEvent.addEventListener(
     TimeIntervalCollectionProperty.prototype._intervalsChanged,
-    this
+    this,
   );
 }
 
@@ -91,19 +91,19 @@ Object.defineProperties(TimeIntervalCollectionProperty.prototype, {
   },
 });
 
+const timeScratch = new JulianDate();
+
 /**
  * Gets the value of the property at the provided time.
  *
- * @param {JulianDate} time The time for which to retrieve the value.
+ * @param {JulianDate} [time=JulianDate.now()] The time for which to retrieve the value. If omitted, the current system time is used.
  * @param {object} [result] The object to store the value into, if omitted, a new instance is created and returned.
  * @returns {object} The modified result parameter or a new instance if the result parameter was not supplied.
  */
 TimeIntervalCollectionProperty.prototype.getValue = function (time, result) {
-  //>>includeStart('debug', pragmas.debug);
   if (!defined(time)) {
-    throw new DeveloperError("time is required");
+    time = JulianDate.now(timeScratch);
   }
-  //>>includeEnd('debug');
 
   const value = this._intervals.findDataForIntervalContainingDate(time);
   if (defined(value) && typeof value.clone === "function") {

package/Source/DataSources/VelocityOrientationProperty.js

@@ -3,6 +3,7 @@ import defaultValue from "../Core/defaultValue.js";
 import defined from "../Core/defined.js";
 import Ellipsoid from "../Core/Ellipsoid.js";
 import Event from "../Core/Event.js";
+import JulianDate from "../Core/JulianDate.js";
 import Matrix3 from "../Core/Matrix3.js";
 import Quaternion from "../Core/Quaternion.js";
 import Transforms from "../Core/Transforms.js";
@@ -104,19 +105,23 @@ Object.defineProperties(VelocityOrientationProperty.prototype, {
 const positionScratch = new Cartesian3();
 const velocityScratch = new Cartesian3();
 const rotationScratch = new Matrix3();
+const timeScratch = new JulianDate();
 
 /**
  * Gets the value of the property at the provided time.
  *
- * @param {JulianDate} [time] The time for which to retrieve the value.
+ * @param {JulianDate} [time=JulianDate.now()] The time for which to retrieve the value. If omitted, the current system time is used.
  * @param {Quaternion} [result] The object to store the value into, if omitted, a new instance is created and returned.
  * @returns {Quaternion} The modified result parameter or a new instance if the result parameter was not supplied.
  */
 VelocityOrientationProperty.prototype.getValue = function (time, result) {
+  if (!defined(time)) {
+    time = JulianDate.now(timeScratch);
+  }
   const velocity = this._velocityVectorProperty._getValue(
     time,
     velocityScratch,
-    positionScratch
+    positionScratch,
   );
 
   if (!defined(velocity)) {
@@ -127,7 +132,7 @@ VelocityOrientationProperty.prototype.getValue = function (time, result) {
     positionScratch,
     velocity,
     this._ellipsoid,
-    rotationScratch
+    rotationScratch,
   );
   return Quaternion.fromRotationMatrix(rotationScratch, result);
 };
@@ -145,7 +150,7 @@ VelocityOrientationProperty.prototype.equals = function (other) {
     (other instanceof VelocityOrientationProperty &&
       Property.equals(
         this._velocityVectorProperty,
-        other._velocityVectorProperty
+        other._velocityVectorProperty,
       ) &&
       (this._ellipsoid === other._ellipsoid ||
         this._ellipsoid.equals(other._ellipsoid)))

package/Source/DataSources/VelocityVectorProperty.js

@@ -1,7 +1,6 @@
 import Cartesian3 from "../Core/Cartesian3.js";
 import defaultValue from "../Core/defaultValue.js";
 import defined from "../Core/defined.js";
-import DeveloperError from "../Core/DeveloperError.js";
 import Event from "../Core/Event.js";
 import JulianDate from "../Core/JulianDate.js";
 import Property from "./Property.js";
@@ -86,7 +85,7 @@ Object.defineProperties(VelocityVectorProperty.prototype, {
             function () {
               this._definitionChanged.raiseEvent(this);
             },
-            this
+            this,
           );
         }
 
@@ -119,12 +118,13 @@ Object.defineProperties(VelocityVectorProperty.prototype, {
 const position1Scratch = new Cartesian3();
 const position2Scratch = new Cartesian3();
 const timeScratch = new JulianDate();
+const timeNowScratch = new JulianDate();
 const step = 1.0 / 60.0;
 
 /**
  * Gets the value of the property at the provided time.
  *
- * @param {JulianDate} [time] The time for which to retrieve the value.
+ * @param {JulianDate} [time=JulianDate.now()] The time for which to retrieve the value. If omitted, the current system time is used.
  * @param {Cartesian3} [result] The object to store the value into, if omitted, a new instance is created and returned.
  * @returns {Cartesian3} The modified result parameter or a new instance if the result parameter was not supplied.
  */
@@ -138,13 +138,11 @@ VelocityVectorProperty.prototype.getValue = function (time, result) {
 VelocityVectorProperty.prototype._getValue = function (
   time,
   velocityResult,
-  positionResult
+  positionResult,
 ) {
-  //>>includeStart('debug', pragmas.debug);
   if (!defined(time)) {
-    throw new DeveloperError("time is required");
+    time = JulianDate.now(timeNowScratch);
   }
-  //>>includeEnd('debug');
 
   if (!defined(velocityResult)) {
     velocityResult = new Cartesian3();
@@ -160,7 +158,7 @@ VelocityVectorProperty.prototype._getValue = function (
   let position1 = property.getValue(time, position1Scratch);
   let position2 = property.getValue(
     JulianDate.addSeconds(time, step, timeScratch),
-    position2Scratch
+    position2Scratch,
   );
 
   //If we don't have a position for now, return undefined.
@@ -173,7 +171,7 @@ VelocityVectorProperty.prototype._getValue = function (
     position2 = position1;
     position1 = property.getValue(
       JulianDate.addSeconds(time, -step, timeScratch),
-      position2Scratch
+      position2Scratch,
     );
 
     if (!defined(position1)) {

package/Source/DataSources/WallGeometryUpdater.js

@@ -67,7 +67,7 @@ WallGeometryUpdater.prototype.createFillGeometryInstance = function (time) {
 
   if (!this._fillEnabled) {
     throw new DeveloperError(
-      "This instance does not represent a filled geometry."
+      "This instance does not represent a filled geometry.",
     );
   }
   //>>includeEnd('debug');
@@ -82,14 +82,14 @@ WallGeometryUpdater.prototype.createFillGeometryInstance = function (time) {
     isAvailable &&
       entity.isShowing &&
       this._showProperty.getValue(time) &&
-      this._fillProperty.getValue(time)
-  );
-  const distanceDisplayCondition = this._distanceDisplayConditionProperty.getValue(
-    time
-  );
-  const distanceDisplayConditionAttribute = DistanceDisplayConditionGeometryInstanceAttribute.fromDistanceDisplayCondition(
-    distanceDisplayCondition
+      this._fillProperty.getValue(time),
   );
+  const distanceDisplayCondition =
+    this._distanceDisplayConditionProperty.getValue(time);
+  const distanceDisplayConditionAttribute =
+    DistanceDisplayConditionGeometryInstanceAttribute.fromDistanceDisplayCondition(
+      distanceDisplayCondition,
+    );
   if (this._materialProperty instanceof ColorMaterialProperty) {
     let currentColor;
     if (
@@ -135,7 +135,7 @@ WallGeometryUpdater.prototype.createOutlineGeometryInstance = function (time) {
 
   if (!this._outlineEnabled) {
     throw new DeveloperError(
-      "This instance does not represent an outlined geometry."
+      "This instance does not represent an outlined geometry.",
     );
   }
   //>>includeEnd('debug');
@@ -146,11 +146,10 @@ WallGeometryUpdater.prototype.createOutlineGeometryInstance = function (time) {
     this._outlineColorProperty,
     time,
     Color.BLACK,
-    scratchColor
-  );
-  const distanceDisplayCondition = this._distanceDisplayConditionProperty.getValue(
-    time
+    scratchColor,
   );
+  const distanceDisplayCondition =
+    this._distanceDisplayConditionProperty.getValue(time);
 
   return new GeometryInstance({
     id: entity,
@@ -160,12 +159,13 @@ WallGeometryUpdater.prototype.createOutlineGeometryInstance = function (time) {
         isAvailable &&
           entity.isShowing &&
           this._showProperty.getValue(time) &&
-          this._showOutlineProperty.getValue(time)
+          this._showOutlineProperty.getValue(time),
       ),
       color: ColorGeometryInstanceAttribute.fromColor(outlineColor),
-      distanceDisplayCondition: DistanceDisplayConditionGeometryInstanceAttribute.fromDistanceDisplayCondition(
-        distanceDisplayCondition
-      ),
+      distanceDisplayCondition:
+        DistanceDisplayConditionGeometryInstanceAttribute.fromDistanceDisplayCondition(
+          distanceDisplayCondition,
+        ),
     },
   });
 };
@@ -204,7 +204,7 @@ WallGeometryUpdater.prototype._setStaticOptions = function (entity, wall) {
     : MaterialAppearance.MaterialSupport.TEXTURED.vertexFormat;
   options.positions = wall.positions.getValue(
     Iso8601.MINIMUM_VALUE,
-    options.positions
+    options.positions,
   );
   options.minimumHeights = defined(minimumHeights)
     ? minimumHeights.getValue(Iso8601.MINIMUM_VALUE, options.minimumHeights)
@@ -225,19 +225,19 @@ WallGeometryUpdater.DynamicGeometryUpdater = DynamicWallGeometryUpdater;
 function DynamicWallGeometryUpdater(
   geometryUpdater,
   primitives,
-  groundPrimitives
+  groundPrimitives,
 ) {
   DynamicGeometryUpdater.call(
     this,
     geometryUpdater,
     primitives,
-    groundPrimitives
+    groundPrimitives,
   );
 }
 
 if (defined(Object.create)) {
   DynamicWallGeometryUpdater.prototype = Object.create(
-    DynamicGeometryUpdater.prototype
+    DynamicGeometryUpdater.prototype,
   );
   DynamicWallGeometryUpdater.prototype.constructor = DynamicWallGeometryUpdater;
 }
@@ -252,23 +252,23 @@ DynamicWallGeometryUpdater.prototype._isHidden = function (entity, wall, time) {
 DynamicWallGeometryUpdater.prototype._setOptions = function (
   entity,
   wall,
-  time
+  time,
 ) {
   const options = this._options;
   options.positions = Property.getValueOrUndefined(
     wall.positions,
     time,
-    options.positions
+    options.positions,
   );
   options.minimumHeights = Property.getValueOrUndefined(
     wall.minimumHeights,
     time,
-    options.minimumHeights
+    options.minimumHeights,
   );
   options.maximumHeights = Property.getValueOrUndefined(
     wall.maximumHeights,
     time,
-    options.maximumHeights
+    options.maximumHeights,
   );
   options.granularity = Property.getValueOrUndefined(wall.granularity, time);
 };

package/Source/DataSources/WallGraphics.js

@@ -177,7 +177,7 @@ Object.defineProperties(WallGraphics.prototype, {
    * @type {Property|undefined}
    */
   distanceDisplayCondition: createPropertyDescriptor(
-    "distanceDisplayCondition"
+    "distanceDisplayCondition",
   ),
 });
 
@@ -223,11 +223,11 @@ WallGraphics.prototype.merge = function (source) {
   this.positions = defaultValue(this.positions, source.positions);
   this.minimumHeights = defaultValue(
     this.minimumHeights,
-    source.minimumHeights
+    source.minimumHeights,
   );
   this.maximumHeights = defaultValue(
     this.maximumHeights,
-    source.maximumHeights
+    source.maximumHeights,
   );
   this.granularity = defaultValue(this.granularity, source.granularity);
   this.fill = defaultValue(this.fill, source.fill);
@@ -238,7 +238,7 @@ WallGraphics.prototype.merge = function (source) {
   this.shadows = defaultValue(this.shadows, source.shadows);
   this.distanceDisplayCondition = defaultValue(
     this.distanceDisplayCondition,
-    source.distanceDisplayCondition
+    source.distanceDisplayCondition,
   );
 };
 export default WallGraphics;

package/Source/DataSources/createPropertyDescriptor.js

@@ -7,7 +7,7 @@ function createProperty(
   privateName,
   subscriptionName,
   configurable,
-  createPropertyCallback
+  createPropertyCallback,
 ) {
   return {
     configurable: configurable,
@@ -41,7 +41,7 @@ function createProperty(
           function () {
             this._definitionChanged.raiseEvent(this, name, value, value);
           },
-          this
+          this,
         );
       }
     },
@@ -66,7 +66,7 @@ function createPropertyDescriptor(name, configurable, createPropertyCallback) {
     `_${name.toString()}`,
     `_${name.toString()}Subscription`,
     defaultValue(configurable, false),
-    defaultValue(createPropertyCallback, createConstantProperty)
+    defaultValue(createPropertyCallback, createConstantProperty),
   );
 }
 export default createPropertyDescriptor;