@cesium/engine 10.1.0 → 11.1.0

package/Source/DataSources/GeometryUpdaterSet.js

@@ -52,7 +52,7 @@ function GeometryUpdaterSet(entity, scene) {
 
   this._removeEntitySubscription = entity.definitionChanged.addEventListener(
     GeometryUpdaterSet.prototype._onEntityPropertyChanged,
-    this
+    this,
   );
 }
 
@@ -60,7 +60,7 @@ GeometryUpdaterSet.prototype._onEntityPropertyChanged = function (
   entity,
   propertyName,
   newValue,
-  oldValue
+  oldValue,
 ) {
   const updaters = this.updaters;
   for (let i = 0; i < updaters.length; i++) {
@@ -68,7 +68,7 @@ GeometryUpdaterSet.prototype._onEntityPropertyChanged = function (
       entity,
       propertyName,
       newValue,
-      oldValue
+      oldValue,
     );
   }
 };

package/Source/DataSources/GeometryVisualizer.js

@@ -35,7 +35,7 @@ function GeometryVisualizer(
   scene,
   entityCollection,
   primitives,
-  groundPrimitives
+  groundPrimitives,
 ) {
   //>>includeStart('debug', pragmas.debug);
   Check.defined("scene", scene);
@@ -60,10 +60,10 @@ function GeometryVisualizer(
   this._openColorBatches = new Array(numberOfShadowModes * 2);
   this._openMaterialBatches = new Array(numberOfShadowModes * 2);
 
-  const supportsMaterialsforEntitiesOnTerrain = Entity.supportsMaterialsforEntitiesOnTerrain(
-    scene
-  );
-  this._supportsMaterialsforEntitiesOnTerrain = supportsMaterialsforEntitiesOnTerrain;
+  const supportsMaterialsforEntitiesOnTerrain =
+    Entity.supportsMaterialsforEntitiesOnTerrain(scene);
+  this._supportsMaterialsforEntitiesOnTerrain =
+    supportsMaterialsforEntitiesOnTerrain;
 
   let i;
   for (i = 0; i < numberOfShadowModes; ++i) {
@@ -71,11 +71,10 @@ function GeometryVisualizer(
       primitives,
       scene,
       i,
-      false
+      false,
     );
-    this._outlineBatches[
-      numberOfShadowModes + i
-    ] = new StaticOutlineGeometryBatch(primitives, scene, i, true);
+    this._outlineBatches[numberOfShadowModes + i] =
+      new StaticOutlineGeometryBatch(primitives, scene, i, true);
 
     this._closedColorBatches[i] = new StaticGeometryColorBatch(
       primitives,
@@ -83,18 +82,17 @@ function GeometryVisualizer(
       undefined,
       true,
       i,
-      true
-    );
-    this._closedColorBatches[
-      numberOfShadowModes + i
-    ] = new StaticGeometryColorBatch(
-      primitives,
-      PerInstanceColorAppearance,
-      undefined,
       true,
-      i,
-      false
     );
+    this._closedColorBatches[numberOfShadowModes + i] =
+      new StaticGeometryColorBatch(
+        primitives,
+        PerInstanceColorAppearance,
+        undefined,
+        true,
+        i,
+        false,
+      );
 
     this._closedMaterialBatches[i] = new StaticGeometryPerMaterialBatch(
       primitives,
@@ -102,18 +100,17 @@ function GeometryVisualizer(
       undefined,
       true,
       i,
-      true
-    );
-    this._closedMaterialBatches[
-      numberOfShadowModes + i
-    ] = new StaticGeometryPerMaterialBatch(
-      primitives,
-      MaterialAppearance,
-      undefined,
       true,
-      i,
-      false
     );
+    this._closedMaterialBatches[numberOfShadowModes + i] =
+      new StaticGeometryPerMaterialBatch(
+        primitives,
+        MaterialAppearance,
+        undefined,
+        true,
+        i,
+        false,
+      );
 
     this._openColorBatches[i] = new StaticGeometryColorBatch(
       primitives,
@@ -121,18 +118,17 @@ function GeometryVisualizer(
       undefined,
       false,
       i,
-      true
-    );
-    this._openColorBatches[
-      numberOfShadowModes + i
-    ] = new StaticGeometryColorBatch(
-      primitives,
-      PerInstanceColorAppearance,
-      undefined,
-      false,
-      i,
-      false
+      true,
     );
+    this._openColorBatches[numberOfShadowModes + i] =
+      new StaticGeometryColorBatch(
+        primitives,
+        PerInstanceColorAppearance,
+        undefined,
+        false,
+        i,
+        false,
+      );
 
     this._openMaterialBatches[i] = new StaticGeometryPerMaterialBatch(
       primitives,
@@ -140,18 +136,17 @@ function GeometryVisualizer(
       undefined,
       false,
       i,
-      true
-    );
-    this._openMaterialBatches[
-      numberOfShadowModes + i
-    ] = new StaticGeometryPerMaterialBatch(
-      primitives,
-      MaterialAppearance,
-      undefined,
-      false,
-      i,
-      false
+      true,
     );
+    this._openMaterialBatches[numberOfShadowModes + i] =
+      new StaticGeometryPerMaterialBatch(
+        primitives,
+        MaterialAppearance,
+        undefined,
+        false,
+        i,
+        false,
+      );
   }
 
   const numberOfClassificationTypes =
@@ -164,19 +159,19 @@ function GeometryVisualizer(
         new StaticGroundGeometryPerMaterialBatch(
           groundPrimitives,
           i,
-          MaterialAppearance
-        )
+          MaterialAppearance,
+        ),
       );
       groundColorBatches[i] = new StaticGroundGeometryColorBatch(
         groundPrimitives,
-        i
+        i,
       );
     }
   } else {
     for (i = 0; i < numberOfClassificationTypes; ++i) {
       groundColorBatches[i] = new StaticGroundGeometryColorBatch(
         groundPrimitives,
-        i
+        i,
       );
     }
   }
@@ -193,7 +188,7 @@ function GeometryVisualizer(
     this._openMaterialBatches,
     this._groundColorBatches,
     this._groundMaterialBatches,
-    this._dynamicBatch
+    this._dynamicBatch,
   );
 
   this._subscriptions = new AssociativeArray();
@@ -202,12 +197,12 @@ function GeometryVisualizer(
   this._entityCollection = entityCollection;
   entityCollection.collectionChanged.addEventListener(
     GeometryVisualizer.prototype._onCollectionChanged,
-    this
+    this,
   );
   this._onCollectionChanged(
     entityCollection,
     entityCollection.values,
-    emptyArray
+    emptyArray,
   );
 }
 
@@ -299,8 +294,8 @@ GeometryVisualizer.prototype.update = function (time) {
       id,
       updaterSet.geometryChanged.addEventListener(
         GeometryVisualizer._onGeometryChanged,
-        this
-      )
+        this,
+      ),
     );
   }
 
@@ -358,7 +353,7 @@ GeometryVisualizer.prototype.getBoundingSphere = function (entity, result) {
       } else if (state === BoundingSphereState.DONE) {
         boundingSpheres[count] = BoundingSphere.clone(
           tmp,
-          boundingSpheres[count]
+          boundingSpheres[count],
         );
         count++;
       }
@@ -389,7 +384,7 @@ GeometryVisualizer.prototype.isDestroyed = function () {
 GeometryVisualizer.prototype.destroy = function () {
   this._entityCollection.collectionChanged.removeEventListener(
     GeometryVisualizer.prototype._onCollectionChanged,
-    this
+    this,
   );
   this._addedObjects.removeAll();
   this._removedObjects.removeAll();
@@ -434,7 +429,7 @@ GeometryVisualizer.prototype._removeUpdater = function (updater) {
  */
 GeometryVisualizer.prototype._insertUpdaterIntoBatch = function (
   time,
-  updater
+  updater,
 ) {
   if (updater.isDynamic) {
     this._dynamicBatch.add(time, updater);
@@ -457,9 +452,8 @@ GeometryVisualizer.prototype._insertUpdaterIntoBatch = function (
 
   if (updater.fillEnabled) {
     if (updater.onTerrain) {
-      const classificationType = updater.classificationTypeProperty.getValue(
-        time
-      );
+      const classificationType =
+        updater.classificationTypeProperty.getValue(time);
       if (updater.fillMaterialProperty instanceof ColorMaterialProperty) {
         this._groundColorBatches[classificationType].add(time, updater);
       } else {
@@ -471,7 +465,7 @@ GeometryVisualizer.prototype._insertUpdaterIntoBatch = function (
         if (defined(updater.terrainOffsetProperty)) {
           this._closedColorBatches[numberOfShadowModes + shadows].add(
             time,
-            updater
+            updater,
           );
         } else {
           this._closedColorBatches[shadows].add(time, updater);
@@ -479,7 +473,7 @@ GeometryVisualizer.prototype._insertUpdaterIntoBatch = function (
       } else if (defined(updater.terrainOffsetProperty)) {
         this._closedMaterialBatches[numberOfShadowModes + shadows].add(
           time,
-          updater
+          updater,
         );
       } else {
         this._closedMaterialBatches[shadows].add(time, updater);
@@ -488,7 +482,7 @@ GeometryVisualizer.prototype._insertUpdaterIntoBatch = function (
       if (defined(updater.terrainOffsetProperty)) {
         this._openColorBatches[numberOfShadowModes + shadows].add(
           time,
-          updater
+          updater,
         );
       } else {
         this._openColorBatches[shadows].add(time, updater);
@@ -496,7 +490,7 @@ GeometryVisualizer.prototype._insertUpdaterIntoBatch = function (
     } else if (defined(updater.terrainOffsetProperty)) {
       this._openMaterialBatches[numberOfShadowModes + shadows].add(
         time,
-        updater
+        updater,
       );
     } else {
       this._openMaterialBatches[shadows].add(time, updater);
@@ -525,7 +519,7 @@ GeometryVisualizer._onGeometryChanged = function (updater) {
 GeometryVisualizer.prototype._onCollectionChanged = function (
   entityCollection,
   added,
-  removed
+  removed,
 ) {
   const addedObjects = this._addedObjects;
   const removedObjects = this._removedObjects;

package/Source/DataSources/GpxDataSource.js

@@ -168,13 +168,13 @@ function createDefaultBillboard(image) {
     BILLBOARD_NEAR_DISTANCE,
     BILLBOARD_NEAR_RATIO,
     BILLBOARD_FAR_DISTANCE,
-    BILLBOARD_FAR_RATIO
+    BILLBOARD_FAR_RATIO,
   );
   billboard.pixelOffsetScaleByDistance = new NearFarScalar(
     BILLBOARD_NEAR_DISTANCE,
     BILLBOARD_NEAR_RATIO,
     BILLBOARD_FAR_DISTANCE,
-    BILLBOARD_FAR_RATIO
+    BILLBOARD_FAR_RATIO,
   );
   billboard.verticalOrigin = new ConstantProperty(VerticalOrigin.BOTTOM);
   billboard.image = image;
@@ -248,7 +248,7 @@ function processDescription(node, entity) {
     const infoType = descriptiveInfoTypes[infoTypeName];
     infoType.value = defaultValue(
       queryStringValue(node, infoType.tag, namespaces.gpx),
-      ""
+      "",
     );
     if (defined(infoType.value) && infoType.value !== "") {
       text = `${text}<p>${infoType.text}: ${infoType.value}</p>`;
@@ -299,7 +299,7 @@ function processWpt(dataSource, geometryNode, entityCollection, options) {
     : dataSource._pinBuilder.fromMakiIconId(
         "marker",
         Color.RED,
-        BILLBOARD_SIZE
+        BILLBOARD_SIZE,
       );
   entity.billboard = createDefaultBillboard(image);
 
@@ -364,7 +364,7 @@ function processTrk(dataSource, geometryNode, entityCollection, options) {
       : dataSource._pinBuilder.fromMakiIconId(
           "marker",
           Color.RED,
-          BILLBOARD_SIZE
+          BILLBOARD_SIZE,
         );
     entity.billboard = createDefaultBillboard(image);
     entity.position = property;
@@ -376,7 +376,7 @@ function processTrk(dataSource, geometryNode, entityCollection, options) {
       new TimeInterval({
         start: times[0],
         stop: times[times.length - 1],
-      })
+      }),
     );
   }
   entity.polyline = createDefaultPolyline(options.trackColor);
@@ -608,8 +608,8 @@ function loadGpx(dataSource, gpx, options) {
     clock.multiplier = Math.round(
       Math.min(
         Math.max(JulianDate.secondsDifference(stop, start) / 60, 1),
-        3.15569e7
-      )
+        3.15569e7,
+      ),
     );
   }
   let changed = false;
@@ -987,8 +987,8 @@ GpxDataSource.prototype.load = function (data, options) {
         clock.multiplier = Math.round(
           Math.min(
             Math.max(JulianDate.secondsDifference(stop, start) / 60, 1),
-            3.15569e7
-          )
+            3.15569e7,
+          ),
         );
       }
 

package/Source/DataSources/GridMaterialProperty.js

@@ -3,6 +3,7 @@ import Color from "../Core/Color.js";
 import defaultValue from "../Core/defaultValue.js";
 import defined from "../Core/defined.js";
 import Event from "../Core/Event.js";
+import JulianDate from "../Core/JulianDate.js";
 import createPropertyDescriptor from "./createPropertyDescriptor.js";
 import Property from "./Property.js";
 
@@ -134,14 +135,19 @@ GridMaterialProperty.prototype.getType = function (time) {
   return "Grid";
 };
 
+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.
  */
 GridMaterialProperty.prototype.getValue = function (time, result) {
+  if (!defined(time)) {
+    time = JulianDate.now(timeScratch);
+  }
   if (!defined(result)) {
     result = {};
   }
@@ -149,30 +155,30 @@ GridMaterialProperty.prototype.getValue = function (time, result) {
     this._color,
     time,
     defaultColor,
-    result.color
+    result.color,
   );
   result.cellAlpha = Property.getValueOrDefault(
     this._cellAlpha,
     time,
-    defaultCellAlpha
+    defaultCellAlpha,
   );
   result.lineCount = Property.getValueOrClonedDefault(
     this._lineCount,
     time,
     defaultLineCount,
-    result.lineCount
+    result.lineCount,
   );
   result.lineThickness = Property.getValueOrClonedDefault(
     this._lineThickness,
     time,
     defaultLineThickness,
-    result.lineThickness
+    result.lineThickness,
   );
   result.lineOffset = Property.getValueOrClonedDefault(
     this._lineOffset,
     time,
     defaultLineOffset,
-    result.lineOffset
+    result.lineOffset,
   );
   return result;
 };

package/Source/DataSources/GroundGeometryUpdater.js

@@ -87,14 +87,14 @@ GroundGeometryUpdater.prototype._onEntityPropertyChanged = function (
   entity,
   propertyName,
   newValue,
-  oldValue
+  oldValue,
 ) {
   GeometryUpdater.prototype._onEntityPropertyChanged.call(
     this,
     entity,
     propertyName,
     newValue,
-    oldValue
+    oldValue,
   );
   if (this._observedPropertyNames.indexOf(propertyName) === -1) {
     return;
@@ -127,13 +127,13 @@ GroundGeometryUpdater.prototype._onEntityPropertyChanged = function (
   ) {
     const centerPosition = new CallbackProperty(
       this._computeCenter.bind(this),
-      !this._dynamic
+      !this._dynamic,
     );
     this._terrainOffsetProperty = new TerrainOffsetProperty(
       this._scene,
       centerPosition,
       heightReferenceProperty,
-      extrudedHeightReferenceProperty
+      extrudedHeightReferenceProperty,
     );
   }
 };
@@ -178,7 +178,7 @@ GroundGeometryUpdater.getGeometryHeight = function (height, heightReference) {
  */
 GroundGeometryUpdater.getGeometryExtrudedHeight = function (
   extrudedHeight,
-  extrudedHeightReference
+  extrudedHeightReference,
 ) {
   //>>includeStart('debug', pragmas.debug);
   Check.defined("extrudedHeightReference", extrudedHeightReference);
@@ -208,7 +208,7 @@ GroundGeometryUpdater.computeGeometryOffsetAttribute = function (
   height,
   heightReference,
   extrudedHeight,
-  extrudedHeightReference
+  extrudedHeightReference,
 ) {
   if (!defined(height) || !defined(heightReference)) {
     heightReference = HeightReference.NONE;

package/Source/DataSources/ImageMaterialProperty.js

@@ -3,6 +3,7 @@ import Color from "../Core/Color.js";
 import defaultValue from "../Core/defaultValue.js";
 import defined from "../Core/defined.js";
 import Event from "../Core/Event.js";
+import JulianDate from "../Core/JulianDate.js";
 import createPropertyDescriptor from "./createPropertyDescriptor.js";
 import Property from "./Property.js";
 
@@ -114,14 +115,20 @@ ImageMaterialProperty.prototype.getType = function (time) {
   return "Image";
 };
 
+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.
  */
 ImageMaterialProperty.prototype.getValue = function (time, result) {
+  if (!defined(time)) {
+    time = JulianDate.now(timeScratch);
+  }
+
   if (!defined(result)) {
     result = {};
   }
@@ -131,13 +138,13 @@ ImageMaterialProperty.prototype.getValue = function (time, result) {
     this._repeat,
     time,
     defaultRepeat,
-    result.repeat
+    result.repeat,
   );
   result.color = Property.getValueOrClonedDefault(
     this._color,
     time,
     defaultColor,
-    result.color
+    result.color,
   );
   if (Property.getValueOrDefault(this._transparent, time, defaultTransparent)) {
     result.color.alpha = Math.min(0.99, result.color.alpha);