@cesium/engine 10.1.0 → 11.1.0

package/Source/DataSources/PolylineVolumeGeometryUpdater.js

@@ -49,15 +49,16 @@ function PolylineVolumeGeometryUpdater(entity, scene) {
     entity,
     "polylineVolume",
     entity.polylineVolume,
-    undefined
+    undefined,
   );
 }
 
 if (defined(Object.create)) {
   PolylineVolumeGeometryUpdater.prototype = Object.create(
-    GeometryUpdater.prototype
+    GeometryUpdater.prototype,
   );
-  PolylineVolumeGeometryUpdater.prototype.constructor = PolylineVolumeGeometryUpdater;
+  PolylineVolumeGeometryUpdater.prototype.constructor =
+    PolylineVolumeGeometryUpdater;
 }
 
 /**
@@ -69,14 +70,14 @@ if (defined(Object.create)) {
  * @exception {DeveloperError} This instance does not represent a filled geometry.
  */
 PolylineVolumeGeometryUpdater.prototype.createFillGeometryInstance = function (
-  time
+  time,
 ) {
   //>>includeStart('debug', pragmas.debug);
   Check.defined("time", 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');
@@ -91,14 +92,14 @@ PolylineVolumeGeometryUpdater.prototype.createFillGeometryInstance = function (
     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 (
@@ -138,52 +139,51 @@ PolylineVolumeGeometryUpdater.prototype.createFillGeometryInstance = function (
  *
  * @exception {DeveloperError} This instance does not represent an outlined geometry.
  */
-PolylineVolumeGeometryUpdater.prototype.createOutlineGeometryInstance = function (
-  time
-) {
-  //>>includeStart('debug', pragmas.debug);
-  Check.defined("time", time);
+PolylineVolumeGeometryUpdater.prototype.createOutlineGeometryInstance =
+  function (time) {
+    //>>includeStart('debug', pragmas.debug);
+    Check.defined("time", time);
 
-  if (!this._outlineEnabled) {
-    throw new DeveloperError(
-      "This instance does not represent an outlined geometry."
-    );
-  }
-  //>>includeEnd('debug');
+    if (!this._outlineEnabled) {
+      throw new DeveloperError(
+        "This instance does not represent an outlined geometry.",
+      );
+    }
+    //>>includeEnd('debug');
 
-  const entity = this._entity;
-  const isAvailable = entity.isAvailable(time);
-  const outlineColor = Property.getValueOrDefault(
-    this._outlineColorProperty,
-    time,
-    Color.BLACK,
-    scratchColor
-  );
-  const distanceDisplayCondition = this._distanceDisplayConditionProperty.getValue(
-    time
-  );
+    const entity = this._entity;
+    const isAvailable = entity.isAvailable(time);
+    const outlineColor = Property.getValueOrDefault(
+      this._outlineColorProperty,
+      time,
+      Color.BLACK,
+      scratchColor,
+    );
+    const distanceDisplayCondition =
+      this._distanceDisplayConditionProperty.getValue(time);
 
-  return new GeometryInstance({
-    id: entity,
-    geometry: new PolylineVolumeOutlineGeometry(this._options),
-    attributes: {
-      show: new ShowGeometryInstanceAttribute(
-        isAvailable &&
-          entity.isShowing &&
-          this._showProperty.getValue(time) &&
-          this._showOutlineProperty.getValue(time)
-      ),
-      color: ColorGeometryInstanceAttribute.fromColor(outlineColor),
-      distanceDisplayCondition: DistanceDisplayConditionGeometryInstanceAttribute.fromDistanceDisplayCondition(
-        distanceDisplayCondition
-      ),
-    },
-  });
-};
+    return new GeometryInstance({
+      id: entity,
+      geometry: new PolylineVolumeOutlineGeometry(this._options),
+      attributes: {
+        show: new ShowGeometryInstanceAttribute(
+          isAvailable &&
+            entity.isShowing &&
+            this._showProperty.getValue(time) &&
+            this._showOutlineProperty.getValue(time),
+        ),
+        color: ColorGeometryInstanceAttribute.fromColor(outlineColor),
+        distanceDisplayCondition:
+          DistanceDisplayConditionGeometryInstanceAttribute.fromDistanceDisplayCondition(
+            distanceDisplayCondition,
+          ),
+      },
+    });
+  };
 
 PolylineVolumeGeometryUpdater.prototype._isHidden = function (
   entity,
-  polylineVolume
+  polylineVolume,
 ) {
   return (
     !defined(polylineVolume.positions) ||
@@ -194,7 +194,7 @@ PolylineVolumeGeometryUpdater.prototype._isHidden = function (
 
 PolylineVolumeGeometryUpdater.prototype._isDynamic = function (
   entity,
-  polylineVolume
+  polylineVolume,
 ) {
   return (
     !polylineVolume.positions.isConstant || //
@@ -207,7 +207,7 @@ PolylineVolumeGeometryUpdater.prototype._isDynamic = function (
 
 PolylineVolumeGeometryUpdater.prototype._setStaticOptions = function (
   entity,
-  polylineVolume
+  polylineVolume,
 ) {
   const granularity = polylineVolume.granularity;
   const cornerType = polylineVolume.cornerType;
@@ -220,11 +220,11 @@ PolylineVolumeGeometryUpdater.prototype._setStaticOptions = function (
     : MaterialAppearance.MaterialSupport.TEXTURED.vertexFormat;
   options.polylinePositions = polylineVolume.positions.getValue(
     Iso8601.MINIMUM_VALUE,
-    options.polylinePositions
+    options.polylinePositions,
   );
   options.shapePositions = polylineVolume.shape.getValue(
     Iso8601.MINIMUM_VALUE,
-    options.shape
+    options.shape,
   );
   options.granularity = defined(granularity)
     ? granularity.getValue(Iso8601.MINIMUM_VALUE)
@@ -234,7 +234,8 @@ PolylineVolumeGeometryUpdater.prototype._setStaticOptions = function (
     : undefined;
 };
 
-PolylineVolumeGeometryUpdater.DynamicGeometryUpdater = DynamicPolylineVolumeGeometryUpdater;
+PolylineVolumeGeometryUpdater.DynamicGeometryUpdater =
+  DynamicPolylineVolumeGeometryUpdater;
 
 /**
  * @private
@@ -242,27 +243,28 @@ PolylineVolumeGeometryUpdater.DynamicGeometryUpdater = DynamicPolylineVolumeGeom
 function DynamicPolylineVolumeGeometryUpdater(
   geometryUpdater,
   primitives,
-  groundPrimitives
+  groundPrimitives,
 ) {
   DynamicGeometryUpdater.call(
     this,
     geometryUpdater,
     primitives,
-    groundPrimitives
+    groundPrimitives,
   );
 }
 
 if (defined(Object.create)) {
   DynamicPolylineVolumeGeometryUpdater.prototype = Object.create(
-    DynamicGeometryUpdater.prototype
+    DynamicGeometryUpdater.prototype,
   );
-  DynamicPolylineVolumeGeometryUpdater.prototype.constructor = DynamicPolylineVolumeGeometryUpdater;
+  DynamicPolylineVolumeGeometryUpdater.prototype.constructor =
+    DynamicPolylineVolumeGeometryUpdater;
 }
 
 DynamicPolylineVolumeGeometryUpdater.prototype._isHidden = function (
   entity,
   polylineVolume,
-  time
+  time,
 ) {
   const options = this._options;
   return (
@@ -272,7 +274,7 @@ DynamicPolylineVolumeGeometryUpdater.prototype._isHidden = function (
       this,
       entity,
       polylineVolume,
-      time
+      time,
     )
   );
 };
@@ -280,25 +282,25 @@ DynamicPolylineVolumeGeometryUpdater.prototype._isHidden = function (
 DynamicPolylineVolumeGeometryUpdater.prototype._setOptions = function (
   entity,
   polylineVolume,
-  time
+  time,
 ) {
   const options = this._options;
   options.polylinePositions = Property.getValueOrUndefined(
     polylineVolume.positions,
     time,
-    options.polylinePositions
+    options.polylinePositions,
   );
   options.shapePositions = Property.getValueOrUndefined(
     polylineVolume.shape,
-    time
+    time,
   );
   options.granularity = Property.getValueOrUndefined(
     polylineVolume.granularity,
-    time
+    time,
   );
   options.cornerType = Property.getValueOrUndefined(
     polylineVolume.cornerType,
-    time
+    time,
   );
 };
 export default PolylineVolumeGeometryUpdater;

package/Source/DataSources/PolylineVolumeGraphics.js

@@ -176,7 +176,7 @@ Object.defineProperties(PolylineVolumeGraphics.prototype, {
    * @type {Property|undefined}
    */
   distanceDisplayCondition: createPropertyDescriptor(
-    "distanceDisplayCondition"
+    "distanceDisplayCondition",
   ),
 });
 
@@ -231,7 +231,7 @@ PolylineVolumeGraphics.prototype.merge = function (source) {
   this.shadows = defaultValue(this.shadows, source.shadows);
   this.distanceDisplayCondition = defaultValue(
     this.distanceDisplayCondition,
-    source.distanceDisplayCondition
+    source.distanceDisplayCondition,
   );
 };
 export default PolylineVolumeGraphics;

package/Source/DataSources/PositionProperty.js

@@ -14,6 +14,7 @@ import Transforms from "../Core/Transforms.js";
  * @constructor
  * @abstract
  *
+ * @see CallbackPositionProperty
  * @see CompositePositionProperty
  * @see ConstantPositionProperty
  * @see SampledPositionProperty
@@ -61,7 +62,7 @@ Object.defineProperties(PositionProperty.prototype, {
  * Gets the value of the property at the provided time in the fixed frame.
  * @function
  *
- * @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 | undefined} The modified result parameter or a new instance if the result parameter was not supplied.
  */
@@ -99,7 +100,7 @@ PositionProperty.convertToReferenceFrame = function (
   value,
   inputFrame,
   outputFrame,
-  result
+  result,
 ) {
   if (!defined(value)) {
     return value;
@@ -114,7 +115,7 @@ PositionProperty.convertToReferenceFrame = function (
 
   const icrfToFixed = Transforms.computeIcrfToCentralBodyFixedMatrix(
     time,
-    scratchMatrix3
+    scratchMatrix3,
   );
   if (inputFrame === ReferenceFrame.INERTIAL) {
     return Matrix3.multiplyByVector(icrfToFixed, value, result);
@@ -123,7 +124,7 @@ PositionProperty.convertToReferenceFrame = function (
     return Matrix3.multiplyByVector(
       Matrix3.transpose(icrfToFixed, scratchMatrix3),
       value,
-      result
+      result,
     );
   }
 };

package/Source/DataSources/PositionPropertyArray.js

@@ -3,6 +3,7 @@ import defined from "../Core/defined.js";
 import DeveloperError from "../Core/DeveloperError.js";
 import Event from "../Core/Event.js";
 import EventHelper from "../Core/EventHelper.js";
+import JulianDate from "../Core/JulianDate.js";
 import ReferenceFrame from "../Core/ReferenceFrame.js";
 import Property from "./Property.js";
 
@@ -76,14 +77,19 @@ Object.defineProperties(PositionPropertyArray.prototype, {
   },
 });
 
+const timeScratch = new JulianDate();
+
 /**
  * Gets the value of the property.
  *
- * @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.
  */
 PositionPropertyArray.prototype.getValue = function (time, result) {
+  if (!defined(time)) {
+    time = JulianDate.now(timeScratch);
+  }
   return this.getValueInReferenceFrame(time, ReferenceFrame.FIXED, result);
 };
 
@@ -98,7 +104,7 @@ PositionPropertyArray.prototype.getValue = function (time, result) {
 PositionPropertyArray.prototype.getValueInReferenceFrame = function (
   time,
   referenceFrame,
-  result
+  result,
 ) {
   //>>includeStart('debug', pragmas.debug);
   if (!defined(time)) {
@@ -125,7 +131,7 @@ PositionPropertyArray.prototype.getValueInReferenceFrame = function (
     const itemValue = property.getValueInReferenceFrame(
       time,
       referenceFrame,
-      result[i]
+      result[i],
     );
     if (defined(itemValue)) {
       result[x] = itemValue;
@@ -155,7 +161,7 @@ PositionPropertyArray.prototype.setValue = function (value) {
         eventHelper.add(
           property.definitionChanged,
           PositionPropertyArray.prototype._raiseDefinitionChanged,
-          this
+          this,
         );
       }
     }

package/Source/DataSources/Property.js

@@ -52,7 +52,7 @@ Object.defineProperties(Property.prototype, {
  * Gets the value of the property at the provided time.
  * @function
  *
- * @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.
  */
@@ -124,7 +124,7 @@ Property.getValueOrClonedDefault = function (
   property,
   time,
   valueDefault,
-  result
+  result,
 ) {
   let value;
   if (defined(property)) {

package/Source/DataSources/PropertyArray.js

@@ -1,7 +1,7 @@
 import defined from "../Core/defined.js";
-import DeveloperError from "../Core/DeveloperError.js";
 import Event from "../Core/Event.js";
 import EventHelper from "../Core/EventHelper.js";
+import JulianDate from "../Core/JulianDate.js";
 import Property from "./Property.js";
 
 /**
@@ -60,19 +60,19 @@ Object.defineProperties(PropertyArray.prototype, {
   },
 });
 
+const timeScratch = new JulianDate();
+
 /**
  * Gets the value of the property.
  *
- * @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, which is an array of values produced by evaluating each of the contained properties at the given time or a new instance if the result parameter was not supplied.
  */
 PropertyArray.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._value;
   if (!defined(value)) {
@@ -116,7 +116,7 @@ PropertyArray.prototype.setValue = function (value) {
         eventHelper.add(
           property.definitionChanged,
           PropertyArray.prototype._raiseDefinitionChanged,
-          this
+          this,
         );
       }
     }

package/Source/DataSources/PropertyBag.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 ConstantProperty from "./ConstantProperty.js";
 import createPropertyDescriptor from "./createPropertyDescriptor.js";
 import Property from "./Property.js";
@@ -98,7 +99,7 @@ function createConstantProperty(value) {
 PropertyBag.prototype.addProperty = function (
   propertyName,
   value,
-  createPropertyCallback
+  createPropertyCallback,
 ) {
   const propertyNames = this._propertyNames;
 
@@ -108,7 +109,7 @@ PropertyBag.prototype.addProperty = function (
   }
   if (propertyNames.indexOf(propertyName) !== -1) {
     throw new DeveloperError(
-      `${propertyName} is already a registered property.`
+      `${propertyName} is already a registered property.`,
     );
   }
   //>>includeEnd('debug');
@@ -120,8 +121,8 @@ PropertyBag.prototype.addProperty = function (
     createPropertyDescriptor(
       propertyName,
       true,
-      defaultValue(createPropertyCallback, createConstantProperty)
-    )
+      defaultValue(createPropertyCallback, createConstantProperty),
+    ),
   );
 
   if (defined(value)) {
@@ -157,21 +158,21 @@ PropertyBag.prototype.removeProperty = function (propertyName) {
   this._definitionChanged.raiseEvent(this);
 };
 
+const timeScratch = new JulianDate();
+
 /**
  * Gets the value of this property.  Each contained property will be evaluated at the given time, and the overall
  * result will be an object, mapping property names to those values.
  *
- * @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.
  * Note that any properties in result which are not part of this PropertyBag will be left as-is.
  * @returns {object} The modified result parameter or a new instance if the result parameter was not supplied.
  */
 PropertyBag.prototype.getValue = function (time, result) {
-  //>>includeStart('debug', pragmas.debug);
   if (!defined(time)) {
-    throw new DeveloperError("time is required.");
+    time = JulianDate.now(timeScratch);
   }
-  //>>includeEnd('debug');
 
   if (!defined(result)) {
     result = {};
@@ -183,7 +184,7 @@ PropertyBag.prototype.getValue = function (time, result) {
     result[propertyName] = Property.getValueOrUndefined(
       this[propertyName],
       time,
-      result[propertyName]
+      result[propertyName],
     );
   }
   return result;