@cesium/engine 10.1.0 → 11.0.0

package/Source/DataSources/ScaledPositionProperty.js

@@ -2,6 +2,7 @@ import defined from "../Core/defined.js";
 import DeveloperError from "../Core/DeveloperError.js";
 import Ellipsoid from "../Core/Ellipsoid.js";
 import Event from "../Core/Event.js";
+import JulianDate from "../Core/JulianDate.js";
 import ReferenceFrame from "../Core/ReferenceFrame.js";
 import Property from "./Property.js";
 
@@ -37,7 +38,12 @@ Object.defineProperties(ScaledPositionProperty.prototype, {
   },
 });
 
+const timeScratch = new JulianDate();
+
 ScaledPositionProperty.prototype.getValue = function (time, result) {
+  if (!defined(time)) {
+    time = JulianDate.now(timeScratch);
+  }
   return this.getValueInReferenceFrame(time, ReferenceFrame.FIXED, result);
 };
 

package/Source/DataSources/StripeMaterialProperty.js

@@ -2,6 +2,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";
 import StripeOrientation from "./StripeOrientation.js";
@@ -135,14 +136,19 @@ StripeMaterialProperty.prototype.getType = function (time) {
   return "Stripe";
 };
 
+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.
  */
 StripeMaterialProperty.prototype.getValue = function (time, result) {
+  if (!defined(time)) {
+    time = JulianDate.now(timeScratch);
+  }
   if (!defined(result)) {
     result = {};
   }

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,
@@ -146,12 +147,20 @@ TerrainOffsetProperty.prototype._updateClamping = function () {
   );
 };
 
+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,

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";
@@ -78,10 +79,12 @@ 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.
  */
@@ -89,6 +92,9 @@ TimeIntervalCollectionPositionProperty.prototype.getValue = function (
   time,
   result
 ) {
+  if (!defined(time)) {
+    time = JulianDate.now(timeScratch);
+  }
   return this.getValueInReferenceFrame(time, ReferenceFrame.FIXED, result);
 };
 

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";
 
@@ -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,15 +105,19 @@ 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,

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";
@@ -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.
  */
@@ -140,11 +140,9 @@ VelocityVectorProperty.prototype._getValue = function (
   velocityResult,
   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();

package/Source/Renderer/AutomaticUniforms.js

@@ -1484,7 +1484,7 @@ const AutomaticUniforms = {
   }),
 
   /**
-   * An automatic GLSL uniform containing the specular environment map atlas used within the scene.
+   * An automatic GLSL uniform containing the specular environment cube map used within the scene.
    *
    * @example
    * // GLSL declaration
@@ -1499,22 +1499,7 @@ const AutomaticUniforms = {
   }),
 
   /**
-   * An automatic GLSL uniform containing the size of the specular environment map atlas used within the scene.
-   *
-   * @example
-   * // GLSL declaration
-   * uniform vec2 czm_specularEnvironmentMapSize;
-   */
-  czm_specularEnvironmentMapSize: new AutomaticUniform({
-    size: 1,
-    datatype: WebGLConstants.FLOAT_VEC2,
-    getValue: function (uniformState) {
-      return uniformState.specularEnvironmentMapsDimensions;
-    },
-  }),
-
-  /**
-   * An automatic GLSL uniform containing the maximum level-of-detail of the specular environment map atlas used within the scene.
+   * An automatic GLSL uniform containing the maximum valid level-of-detail of the specular environment cube map used within the scene.
    *
    * @example
    * // GLSL declaration

package/Source/Renderer/Context.js

@@ -160,6 +160,8 @@ function Context(canvas, options) {
     "OES_texture_half_float_linear",
   ]);
 
+  this._supportsTextureLod = !!getExtension(gl, ["EXT_shader_texture_lod"]);
+
   this._colorBufferFloat = !!getExtension(gl, [
     "EXT_color_buffer_float",
     "WEBGL_color_buffer_float",
@@ -777,6 +779,19 @@ Object.defineProperties(Context.prototype, {
     },
   },
 
+  /**
+   * <code>true</code> if EXT_shader_texture_lod is supported. This extension provides
+   * access to explicit LOD selection in texture sampling functions.
+   * @memberof Context.prototype
+   * @type {boolean}
+   * @see {@link https://registry.khronos.org/webgl/extensions/EXT_shader_texture_lod/}
+   */
+  supportsTextureLod: {
+    get: function () {
+      return this._webgl2 || this._supportsTextureLod;
+    },
+  },
+
   /**
    * <code>true</code> if EXT_texture_filter_anisotropic is supported. This extension provides
    * access to anisotropic filtering for textured surfaces at an oblique angle from the viewer.