@cesium/engine 10.1.0 → 11.1.0

package/Source/DataSources/RectangleGeometryUpdater.js

@@ -65,13 +65,13 @@ function RectangleGeometryUpdater(entity, scene) {
     entity,
     "rectangle",
     entity.rectangle,
-    undefined
+    undefined,
   );
 }
 
 if (defined(Object.create)) {
   RectangleGeometryUpdater.prototype = Object.create(
-    GroundGeometryUpdater.prototype
+    GroundGeometryUpdater.prototype,
   );
   RectangleGeometryUpdater.prototype.constructor = RectangleGeometryUpdater;
 }
@@ -85,14 +85,14 @@ if (defined(Object.create)) {
  * @exception {DeveloperError} This instance does not represent a filled geometry.
  */
 RectangleGeometryUpdater.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');
@@ -105,11 +105,12 @@ RectangleGeometryUpdater.prototype.createFillGeometryInstance = function (
       isAvailable &&
         entity.isShowing &&
         this._showProperty.getValue(time) &&
-        this._fillProperty.getValue(time)
-    ),
-    distanceDisplayCondition: DistanceDisplayConditionGeometryInstanceAttribute.fromDistanceDisplayCondition(
-      this._distanceDisplayConditionProperty.getValue(time)
+        this._fillProperty.getValue(time),
     ),
+    distanceDisplayCondition:
+      DistanceDisplayConditionGeometryInstanceAttribute.fromDistanceDisplayCondition(
+        this._distanceDisplayConditionProperty.getValue(time),
+      ),
     offset: undefined,
     color: undefined,
   };
@@ -133,8 +134,8 @@ RectangleGeometryUpdater.prototype.createFillGeometryInstance = function (
         this._terrainOffsetProperty,
         time,
         defaultOffset,
-        offsetScratch
-      )
+        offsetScratch,
+      ),
     );
   }
 
@@ -154,14 +155,14 @@ RectangleGeometryUpdater.prototype.createFillGeometryInstance = function (
  * @exception {DeveloperError} This instance does not represent an outlined geometry.
  */
 RectangleGeometryUpdater.prototype.createOutlineGeometryInstance = function (
-  time
+  time,
 ) {
   //>>includeStart('debug', pragmas.debug);
   Check.defined("time", 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');
@@ -172,23 +173,23 @@ RectangleGeometryUpdater.prototype.createOutlineGeometryInstance = function (
     this._outlineColorProperty,
     time,
     Color.BLACK,
-    scratchColor
-  );
-  const distanceDisplayCondition = this._distanceDisplayConditionProperty.getValue(
-    time
+    scratchColor,
   );
+  const distanceDisplayCondition =
+    this._distanceDisplayConditionProperty.getValue(time);
 
   const attributes = {
     show: new ShowGeometryInstanceAttribute(
       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,
+      ),
     offset: undefined,
   };
 
@@ -198,8 +199,8 @@ RectangleGeometryUpdater.prototype.createOutlineGeometryInstance = function (
         this._terrainOffsetProperty,
         time,
         defaultOffset,
-        offsetScratch
-      )
+        offsetScratch,
+      ),
     );
   }
 
@@ -214,7 +215,7 @@ RectangleGeometryUpdater.prototype._computeCenter = function (time, result) {
   const rect = Property.getValueOrUndefined(
     this._entity.rectangle.coordinates,
     time,
-    scratchCenterRect
+    scratchCenterRect,
   );
   if (!defined(rect)) {
     return;
@@ -248,28 +249,28 @@ RectangleGeometryUpdater.prototype._isDynamic = function (entity, rectangle) {
 
 RectangleGeometryUpdater.prototype._setStaticOptions = function (
   entity,
-  rectangle
+  rectangle,
 ) {
   const isColorMaterial =
     this._materialProperty instanceof ColorMaterialProperty;
 
   let heightValue = Property.getValueOrUndefined(
     rectangle.height,
-    Iso8601.MINIMUM_VALUE
+    Iso8601.MINIMUM_VALUE,
   );
   const heightReferenceValue = Property.getValueOrDefault(
     rectangle.heightReference,
     Iso8601.MINIMUM_VALUE,
-    HeightReference.NONE
+    HeightReference.NONE,
   );
   let extrudedHeightValue = Property.getValueOrUndefined(
     rectangle.extrudedHeight,
-    Iso8601.MINIMUM_VALUE
+    Iso8601.MINIMUM_VALUE,
   );
   const extrudedHeightReferenceValue = Property.getValueOrDefault(
     rectangle.extrudedHeightReference,
     Iso8601.MINIMUM_VALUE,
-    HeightReference.NONE
+    HeightReference.NONE,
   );
   if (defined(extrudedHeightValue) && !defined(heightValue)) {
     heightValue = 0;
@@ -281,45 +282,47 @@ RectangleGeometryUpdater.prototype._setStaticOptions = function (
     : MaterialAppearance.MaterialSupport.TEXTURED.vertexFormat;
   options.rectangle = rectangle.coordinates.getValue(
     Iso8601.MINIMUM_VALUE,
-    options.rectangle
+    options.rectangle,
   );
   options.granularity = Property.getValueOrUndefined(
     rectangle.granularity,
-    Iso8601.MINIMUM_VALUE
+    Iso8601.MINIMUM_VALUE,
   );
   options.stRotation = Property.getValueOrUndefined(
     rectangle.stRotation,
-    Iso8601.MINIMUM_VALUE
+    Iso8601.MINIMUM_VALUE,
   );
   options.rotation = Property.getValueOrUndefined(
     rectangle.rotation,
-    Iso8601.MINIMUM_VALUE
-  );
-  options.offsetAttribute = GroundGeometryUpdater.computeGeometryOffsetAttribute(
-    heightValue,
-    heightReferenceValue,
-    extrudedHeightValue,
-    extrudedHeightReferenceValue
+    Iso8601.MINIMUM_VALUE,
   );
+  options.offsetAttribute =
+    GroundGeometryUpdater.computeGeometryOffsetAttribute(
+      heightValue,
+      heightReferenceValue,
+      extrudedHeightValue,
+      extrudedHeightReferenceValue,
+    );
   options.height = GroundGeometryUpdater.getGeometryHeight(
     heightValue,
-    heightReferenceValue
+    heightReferenceValue,
   );
 
   extrudedHeightValue = GroundGeometryUpdater.getGeometryExtrudedHeight(
     extrudedHeightValue,
-    extrudedHeightReferenceValue
+    extrudedHeightReferenceValue,
   );
   if (extrudedHeightValue === GroundGeometryUpdater.CLAMP_TO_GROUND) {
     extrudedHeightValue = ApproximateTerrainHeights.getMinimumMaximumHeights(
-      RectangleGeometry.computeRectangle(options, scratchRectangle)
+      RectangleGeometry.computeRectangle(options, scratchRectangle),
     ).minimumTerrainHeight;
   }
 
   options.extrudedHeight = extrudedHeightValue;
 };
 
-RectangleGeometryUpdater.DynamicGeometryUpdater = DynamicRectangleGeometryUpdater;
+RectangleGeometryUpdater.DynamicGeometryUpdater =
+  DynamicRectangleGeometryUpdater;
 
 /**
  * @private
@@ -327,27 +330,28 @@ RectangleGeometryUpdater.DynamicGeometryUpdater = DynamicRectangleGeometryUpdate
 function DynamicRectangleGeometryUpdater(
   geometryUpdater,
   primitives,
-  groundPrimitives
+  groundPrimitives,
 ) {
   DynamicGeometryUpdater.call(
     this,
     geometryUpdater,
     primitives,
-    groundPrimitives
+    groundPrimitives,
   );
 }
 
 if (defined(Object.create)) {
   DynamicRectangleGeometryUpdater.prototype = Object.create(
-    DynamicGeometryUpdater.prototype
+    DynamicGeometryUpdater.prototype,
   );
-  DynamicRectangleGeometryUpdater.prototype.constructor = DynamicRectangleGeometryUpdater;
+  DynamicRectangleGeometryUpdater.prototype.constructor =
+    DynamicRectangleGeometryUpdater;
 }
 
 DynamicRectangleGeometryUpdater.prototype._isHidden = function (
   entity,
   rectangle,
-  time
+  time,
 ) {
   return (
     !defined(this._options.rectangle) ||
@@ -355,7 +359,7 @@ DynamicRectangleGeometryUpdater.prototype._isHidden = function (
       this,
       entity,
       rectangle,
-      time
+      time,
     )
   );
 };
@@ -363,23 +367,23 @@ DynamicRectangleGeometryUpdater.prototype._isHidden = function (
 DynamicRectangleGeometryUpdater.prototype._setOptions = function (
   entity,
   rectangle,
-  time
+  time,
 ) {
   const options = this._options;
   let heightValue = Property.getValueOrUndefined(rectangle.height, time);
   const heightReferenceValue = Property.getValueOrDefault(
     rectangle.heightReference,
     time,
-    HeightReference.NONE
+    HeightReference.NONE,
   );
   let extrudedHeightValue = Property.getValueOrUndefined(
     rectangle.extrudedHeight,
-    time
+    time,
   );
   const extrudedHeightReferenceValue = Property.getValueOrDefault(
     rectangle.extrudedHeightReference,
     time,
-    HeightReference.NONE
+    HeightReference.NONE,
   );
   if (defined(extrudedHeightValue) && !defined(heightValue)) {
     heightValue = 0;
@@ -388,32 +392,33 @@ DynamicRectangleGeometryUpdater.prototype._setOptions = function (
   options.rectangle = Property.getValueOrUndefined(
     rectangle.coordinates,
     time,
-    options.rectangle
+    options.rectangle,
   );
   options.granularity = Property.getValueOrUndefined(
     rectangle.granularity,
-    time
+    time,
   );
   options.stRotation = Property.getValueOrUndefined(rectangle.stRotation, time);
   options.rotation = Property.getValueOrUndefined(rectangle.rotation, time);
-  options.offsetAttribute = GroundGeometryUpdater.computeGeometryOffsetAttribute(
-    heightValue,
-    heightReferenceValue,
-    extrudedHeightValue,
-    extrudedHeightReferenceValue
-  );
+  options.offsetAttribute =
+    GroundGeometryUpdater.computeGeometryOffsetAttribute(
+      heightValue,
+      heightReferenceValue,
+      extrudedHeightValue,
+      extrudedHeightReferenceValue,
+    );
   options.height = GroundGeometryUpdater.getGeometryHeight(
     heightValue,
-    heightReferenceValue
+    heightReferenceValue,
   );
 
   extrudedHeightValue = GroundGeometryUpdater.getGeometryExtrudedHeight(
     extrudedHeightValue,
-    extrudedHeightReferenceValue
+    extrudedHeightReferenceValue,
   );
   if (extrudedHeightValue === GroundGeometryUpdater.CLAMP_TO_GROUND) {
     extrudedHeightValue = ApproximateTerrainHeights.getMinimumMaximumHeights(
-      RectangleGeometry.computeRectangle(options, scratchRectangle)
+      RectangleGeometry.computeRectangle(options, scratchRectangle),
     ).minimumTerrainHeight;
   }
 

package/Source/DataSources/RectangleGraphics.js

@@ -228,7 +228,7 @@ Object.defineProperties(RectangleGraphics.prototype, {
    * @type {Property|undefined}
    */
   distanceDisplayCondition: createPropertyDescriptor(
-    "distanceDisplayCondition"
+    "distanceDisplayCondition",
   ),
 
   /**
@@ -297,15 +297,15 @@ RectangleGraphics.prototype.merge = function (source) {
   this.height = defaultValue(this.height, source.height);
   this.heightReference = defaultValue(
     this.heightReference,
-    source.heightReference
+    source.heightReference,
   );
   this.extrudedHeight = defaultValue(
     this.extrudedHeight,
-    source.extrudedHeight
+    source.extrudedHeight,
   );
   this.extrudedHeightReference = defaultValue(
     this.extrudedHeightReference,
-    source.extrudedHeightReference
+    source.extrudedHeightReference,
   );
   this.rotation = defaultValue(this.rotation, source.rotation);
   this.stRotation = defaultValue(this.stRotation, source.stRotation);
@@ -318,11 +318,11 @@ RectangleGraphics.prototype.merge = function (source) {
   this.shadows = defaultValue(this.shadows, source.shadows);
   this.distanceDisplayCondition = defaultValue(
     this.distanceDisplayCondition,
-    source.distanceDisplayCondition
+    source.distanceDisplayCondition,
   );
   this.classificationType = defaultValue(
     this.classificationType,
-    source.classificationType
+    source.classificationType,
   );
   this.zIndex = defaultValue(this.zIndex, source.zIndex);
 };

package/Source/DataSources/ReferenceProperty.js

@@ -1,6 +1,7 @@
 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";
 
 function resolve(that) {
@@ -21,7 +22,7 @@ function resolve(that) {
       // target entity was found. listen for changes to entity definition
       targetEntity.definitionChanged.addEventListener(
         ReferenceProperty.prototype._onTargetEntityDefinitionChanged,
-        that
+        that,
       );
       that._targetEntity = targetEntity;
     }
@@ -114,7 +115,7 @@ function ReferenceProperty(targetCollection, targetId, targetPropertyNames) {
 
   targetCollection.collectionChanged.addEventListener(
     ReferenceProperty.prototype._onCollectionChanged,
-    this
+    this,
   );
 }
 
@@ -254,15 +255,20 @@ ReferenceProperty.fromString = function (targetCollection, referenceString) {
   return new ReferenceProperty(targetCollection, identifier, values);
 };
 
+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.
  */
 ReferenceProperty.prototype.getValue = function (time, result) {
   const target = resolve(this);
+  if (!defined(time)) {
+    time = JulianDate.now(timeScratch);
+  }
   return defined(target) ? target.getValue(time, result) : undefined;
 };
 
@@ -278,7 +284,7 @@ ReferenceProperty.prototype.getValue = function (time, result) {
 ReferenceProperty.prototype.getValueInReferenceFrame = function (
   time,
   referenceFrame,
-  result
+  result,
 ) {
   const target = resolve(this);
   return defined(target)
@@ -335,7 +341,7 @@ ReferenceProperty.prototype._onTargetEntityDefinitionChanged = function (
   targetEntity,
   name,
   value,
-  oldValue
+  oldValue,
 ) {
   if (defined(this._targetProperty) && this._targetPropertyNames[0] === name) {
     this._targetProperty = undefined;
@@ -346,13 +352,13 @@ ReferenceProperty.prototype._onTargetEntityDefinitionChanged = function (
 ReferenceProperty.prototype._onCollectionChanged = function (
   collection,
   added,
-  removed
+  removed,
 ) {
   let targetEntity = this._targetEntity;
   if (defined(targetEntity) && removed.indexOf(targetEntity) !== -1) {
     targetEntity.definitionChanged.removeEventListener(
       ReferenceProperty.prototype._onTargetEntityDefinitionChanged,
-      this
+      this,
     );
     this._targetEntity = this._targetProperty = undefined;
   } else if (!defined(targetEntity)) {

package/Source/DataSources/Rotation.js

@@ -93,7 +93,7 @@ const Rotation = {
     packedArray,
     startingIndex,
     lastIndex,
-    result
+    result,
   ) {
     //>>includeStart('debug', pragmas.debug);
     if (!defined(packedArray)) {
@@ -135,7 +135,7 @@ const Rotation = {
     sourceArray,
     firstIndex,
     lastIndex,
-    result
+    result,
   ) {
     //>>includeStart('debug', pragmas.debug);
     if (!defined(array)) {

package/Source/DataSources/SampledPositionProperty.js

@@ -4,6 +4,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 PositionProperty from "./PositionProperty.js";
 import Property from "./Property.js";
@@ -178,14 +179,19 @@ Object.defineProperties(SampledPositionProperty.prototype, {
   },
 });
 
+const timeScratch = new JulianDate();
+
 /**
  * Gets the position 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 | undefined} The modified result parameter or a new instance if the result parameter was not supplied.
  */
 SampledPositionProperty.prototype.getValue = function (time, result) {
+  if (!defined(time)) {
+    time = JulianDate.now(timeScratch);
+  }
   return this.getValueInReferenceFrame(time, ReferenceFrame.FIXED, result);
 };
 
@@ -200,7 +206,7 @@ SampledPositionProperty.prototype.getValue = function (time, result) {
 SampledPositionProperty.prototype.getValueInReferenceFrame = function (
   time,
   referenceFrame,
-  result
+  result,
 ) {
   //>>includeStart('debug', pragmas.debug);
   Check.defined("time", time);
@@ -214,7 +220,7 @@ SampledPositionProperty.prototype.getValueInReferenceFrame = function (
       result,
       this._referenceFrame,
       referenceFrame,
-      result
+      result,
     );
   }
   return undefined;
@@ -241,7 +247,7 @@ SampledPositionProperty.prototype.setInterpolationOptions = function (options) {
 SampledPositionProperty.prototype.addSample = function (
   time,
   position,
-  derivatives
+  derivatives,
 ) {
   const numberOfDerivatives = this._numberOfDerivatives;
   //>>includeStart('debug', pragmas.debug);
@@ -250,7 +256,7 @@ SampledPositionProperty.prototype.addSample = function (
     (!defined(derivatives) || derivatives.length !== numberOfDerivatives)
   ) {
     throw new DeveloperError(
-      "derivatives length must be equal to the number of derivatives."
+      "derivatives length must be equal to the number of derivatives.",
     );
   }
   //>>includeEnd('debug');
@@ -269,7 +275,7 @@ SampledPositionProperty.prototype.addSample = function (
 SampledPositionProperty.prototype.addSamples = function (
   times,
   positions,
-  derivatives
+  derivatives,
 ) {
   this._property.addSamples(times, positions, derivatives);
 };
@@ -283,7 +289,7 @@ SampledPositionProperty.prototype.addSamples = function (
  */
 SampledPositionProperty.prototype.addSamplesPackedArray = function (
   packedSamples,
-  epoch
+  epoch,
 ) {
   this._property.addSamplesPackedArray(packedSamples, epoch);
 };