@cesium/engine 1.0.0 → 1.1.0

package/Source/Core/Matrix2.js

@@ -613,6 +613,7 @@ const scaleScratch4 = new Cartesian2();
  *
  * @param {Matrix2} matrix The matrix.
  * @param {Matrix2} rotation The rotation matrix.
+ * @param {Matrix2} result The object onto which to store the result.
  * @returns {Matrix2} The modified result parameter.
  *
  * @see Matrix2.fromRotation
@@ -782,7 +783,7 @@ Matrix2.multiplyByScalar = function (matrix, scalar, result) {
  * Computes the product of a matrix times a (non-uniform) scale, as if the scale were a scale matrix.
  *
  * @param {Matrix2} matrix The matrix on the left-hand side.
- * @param {Number} scale The non-uniform scale on the right-hand side.
+ * @param {Cartesian2} scale The non-uniform scale on the right-hand side.
  * @param {Matrix2} result The object onto which to store the result.
  * @returns {Matrix2} The modified result parameter.
  *

package/Source/Core/Matrix3.js

@@ -974,6 +974,7 @@ const scaleScratch4 = new Cartesian3();
  *
  * @param {Matrix3} matrix The matrix.
  * @param {Matrix3} rotation The rotation matrix.
+ * @param {Matrix3} result The object onto which to store the result.
  * @returns {Matrix3} The modified result parameter.
  *
  * @see Matrix3.getRotation
@@ -1193,7 +1194,7 @@ Matrix3.multiplyByScalar = function (matrix, scalar, result) {
  * Computes the product of a matrix times a (non-uniform) scale, as if the scale were a scale matrix.
  *
  * @param {Matrix3} matrix The matrix on the left-hand side.
- * @param {Number} scale The non-uniform scale on the right-hand side.
+ * @param {Cartesian3} scale The non-uniform scale on the right-hand side.
  * @param {Matrix3} result The object onto which to store the result.
  * @returns {Matrix3} The modified result parameter.
  *

package/Source/Core/Matrix4.js

@@ -1633,6 +1633,7 @@ const scaleScratch4 = new Cartesian3();
  *
  * @param {Matrix4} matrix The matrix.
  * @param {Matrix3} rotation The rotation matrix.
+ * @param {Matrix4} result The object onto which to store the result.
  * @returns {Matrix4} The modified result parameter.
  *
  * @see Matrix4.fromRotation

package/Source/Core/OrientedBoundingBox.js

@@ -18,13 +18,13 @@ import Rectangle from "./Rectangle.js";
 
 /**
  * Creates an instance of an OrientedBoundingBox.
- * An OrientedBoundingBox of some object is a closed and convex cuboid. It can provide a tighter bounding volume than {@link BoundingSphere} or {@link AxisAlignedBoundingBox} in many cases.
+ * An OrientedBoundingBox of some object is a closed and convex rectangular cuboid. It can provide a tighter bounding volume than {@link BoundingSphere} or {@link AxisAlignedBoundingBox} in many cases.
  * @alias OrientedBoundingBox
  * @constructor
  *
  * @param {Cartesian3} [center=Cartesian3.ZERO] The center of the box.
  * @param {Matrix3} [halfAxes=Matrix3.ZERO] The three orthogonal half-axes of the bounding box.
- *                                          Equivalently, the transformation matrix, to rotate and scale a 0x0x0
+ *                                          Equivalently, the transformation matrix, to rotate and scale a 1x1x1
  *                                          cube centered at the origin.
  *
  *
@@ -334,7 +334,7 @@ const scratchPlane = new Plane(Cartesian3.UNIT_X, 0.0);
  * @param {OrientedBoundingBox} [result] The object onto which to store the result.
  * @returns {OrientedBoundingBox} The modified result parameter or a new OrientedBoundingBox instance if none was provided.
  *
- * @exception {DeveloperError} rectangle.width must be between 0 and pi.
+ * @exception {DeveloperError} rectangle.width must be between 0 and 2 * pi.
  * @exception {DeveloperError} rectangle.height must be between 0 and pi.
  * @exception {DeveloperError} ellipsoid must be an ellipsoid of revolution (<code>radii.x == radii.y</code>)
  */
@@ -350,7 +350,7 @@ OrientedBoundingBox.fromRectangle = function (
     throw new DeveloperError("rectangle is required");
   }
   if (rectangle.width < 0.0 || rectangle.width > CesiumMath.TWO_PI) {
-    throw new DeveloperError("Rectangle width must be between 0 and 2*pi");
+    throw new DeveloperError("Rectangle width must be between 0 and 2 * pi");
   }
   if (rectangle.height < 0.0 || rectangle.height > CesiumMath.PI) {
     throw new DeveloperError("Rectangle height must be between 0 and pi");

package/Source/Core/S2Cell.js

@@ -264,7 +264,7 @@ S2Cell.getIdFromToken = function (token) {
  * Converts a 64-bit S2 cell ID to an S2 cell token.
  *
  * @param {BigInt} [cellId] The S2 cell ID.
- * @returns {BigInt} Returns hexadecimal representation of an S2CellId.
+ * @returns {string} Returns hexadecimal representation of an S2CellId.
  * @private
  */
 S2Cell.getTokenFromId = function (cellId) {
@@ -378,7 +378,7 @@ S2Cell.prototype.getParentAtLevel = function (level) {
  * Get center of the S2 cell.
  *
  * @param {Ellipsoid} [options.ellipsoid=Ellipsoid.WGS84] The ellipsoid.
- * @returns {Cartesian} The position of center of the S2 cell.
+ * @returns {Cartesian3} The position of center of the S2 cell.
  * @private
  */
 S2Cell.prototype.getCenter = function (ellipsoid) {
@@ -400,7 +400,7 @@ S2Cell.prototype.getCenter = function (ellipsoid) {
  *
  * @param {Number} index An integer index of the vertex. Must be in the range [0-3].
  * @param {Ellipsoid} [options.ellipsoid=Ellipsoid.WGS84] The ellipsoid.
- * @returns {Cartesian} The position of the vertex of the S2 cell.
+ * @returns {Cartesian3} The position of the vertex of the S2 cell.
  * @private
  */
 S2Cell.prototype.getVertex = function (index, ellipsoid) {

package/Source/Core/Transforms.js

@@ -659,9 +659,8 @@ const j2000ttDays = 2451545.0;
  *
  * @example
  * const interval = new Cesium.TimeInterval(...);
- * Promise.resolve(Cesium.Transforms.preloadIcrfFixed(interval)).then(function() {
- *     // the data is now loaded
- * });
+ * await Cesium.Transforms.preloadIcrfFixed(interval));
+ * // the data is now loaded
  *
  * @see Transforms.computeIcrfToFixedMatrix
  * @see Transforms.computeFixedToIcrfMatrix
@@ -672,15 +671,12 @@ Transforms.preloadIcrfFixed = function (timeInterval) {
   const stopDayTT = timeInterval.stop.dayNumber;
   const stopSecondTT = timeInterval.stop.secondsOfDay + ttMinusTai;
 
-  const xysPromise = Transforms.iau2006XysData.preload(
+  return Transforms.iau2006XysData.preload(
     startDayTT,
     startSecondTT,
     stopDayTT,
     stopSecondTT
   );
-  const eopPromise = Transforms.earthOrientationParameters.getPromiseToLoad();
-
-  return Promise.all([xysPromise, eopPromise]);
 };
 
 /**

package/Source/DataSources/GpxDataSource.js

@@ -41,11 +41,9 @@ const autolinker = new Autolinker({
   stripPrefix: false,
   email: false,
   replaceFn: function (linker, match) {
-    if (!match.protocolUrlMatch) {
-      // Prevent matching of non-explicit urls.
-      // i.e. foo.id won't match but http://foo.id will
-      return false;
-    }
+    //Prevent matching of non-explicit urls.
+    //i.e. foo.id won't match but http://foo.id will
+    return match.urlMatchType === "scheme" || match.urlMatchType === "www";
   },
 });
 
@@ -754,7 +752,7 @@ function GpxDataSource() {
   this._error = new Event();
   this._loading = new Event();
   this._clock = undefined;
-  this._entityCollection = new EntityCollection();
+  this._entityCollection = new EntityCollection(this);
   this._entityCluster = new EntityCluster();
   this._name = undefined;
   this._version = undefined;

package/Source/DataSources/KmlDataSource.js

@@ -143,11 +143,9 @@ const autolinker = new Autolinker({
   stripPrefix: false,
   email: false,
   replaceFn: function (match) {
-    if (!match.protocolUrlMatch) {
-      //Prevent matching of non-explicit urls.
-      //i.e. foo.id won't match but http://foo.id will
-      return false;
-    }
+    //Prevent matching of non-explicit urls.
+    //i.e. foo.id won't match but http://foo.id will
+    return match.urlMatchType === "scheme" || match.urlMatchType === "www";
   },
 });
 

package/Source/Renderer/Context.js

@@ -4,6 +4,7 @@ import ComponentDatatype from "../Core/ComponentDatatype.js";
 import createGuid from "../Core/createGuid.js";
 import defaultValue from "../Core/defaultValue.js";
 import defined from "../Core/defined.js";
+import deprecationWarning from "../Core/deprecationWarning.js";
 import destroyObject from "../Core/destroyObject.js";
 import DeveloperError from "../Core/DeveloperError.js";
 import Geometry from "../Core/Geometry.js";
@@ -42,9 +43,18 @@ function Context(canvas, options) {
   Check.defined("canvas", canvas);
   //>>includeEnd('debug');
 
+  let requestWebgl2 = false;
+  if (defined(options) && defined(options.requestWebgl2)) {
+    requestWebgl2 = options.requestWebgl2;
+    Context._deprecationWarning(
+      "ContextOptions.requestWebgl2",
+      "Cesium.requestWebgl2 was deprecated in CesiumJS 1.101 and will be removed in 1.102. Use Cesium.requestWebgl1 to request a WebGL1 or WebGL2 context."
+    );
+  }
+
   const {
     getWebGLStub,
-    requestWebgl2 = false,
+    requestWebgl1 = !requestWebgl2,
     webgl: webglOptions = {},
     allowTextureFilterAnisotropic = true,
   } = defaultValue(options, {});
@@ -59,7 +69,7 @@ function Context(canvas, options) {
 
   const glContext = defined(getWebGLStub)
     ? getWebGLStub(canvas, webglOptions)
-    : getWebGLContext(canvas, webglOptions, requestWebgl2);
+    : getWebGLContext(canvas, webglOptions, requestWebgl1);
 
   // Get context type. instanceof will throw if WebGL2 is not supported
   const webgl2 =
@@ -367,7 +377,7 @@ function Context(canvas, options) {
    */
   this.options = {
     getWebGLStub: getWebGLStub,
-    requestWebgl2: requestWebgl2,
+    requestWebgl1: requestWebgl1,
     webgl: webglOptions,
     allowTextureFilterAnisotropic: allowTextureFilterAnisotropic,
   };
@@ -397,7 +407,7 @@ function Context(canvas, options) {
  * especially for horizon views.
  * </p>
  *
- * @property {Boolean} [requestWebGl2 = false] If true and the browser supports it, use a WebGL 2 rendering context
+ * @property {Boolean} [requestWebgl1 = true] If true and the browser supports it, use a WebGL 1 rendering context
  * @property {Boolean} [allowTextureFilterAnisotropic=true] If true, use anisotropic filtering during texture sampling
  * @property {WebGLOptions} [webgl] WebGL options to be passed on to canvas.getContext
  * @property {Function} [getWebGLStub] A function to create a WebGL stub for testing
@@ -407,19 +417,23 @@ function Context(canvas, options) {
  * @private
  * @param {HTMLCanvasElement} canvas The canvas element to which the context will be associated
  * @param {WebGLOptions} webglOptions WebGL options to be passed on to HTMLCanvasElement.getContext()
- * @param {Boolean} requestWebgl2 Whether to request a WebGL2RenderingContext
+ * @param {Boolean} requestWebgl1 Whether to request a WebGLRenderingContext or a WebGL2RenderingContext.
  * @returns {WebGLRenderingContext|WebGL2RenderingContext}
  */
-function getWebGLContext(canvas, webglOptions, requestWebgl2) {
+function getWebGLContext(canvas, webglOptions, requestWebgl1) {
   if (typeof WebGLRenderingContext === "undefined") {
     throw new RuntimeError(
       "The browser does not support WebGL.  Visit http://get.webgl.org."
     );
   }
 
-  requestWebgl2 =
-    requestWebgl2 && typeof WebGL2RenderingContext !== "undefined";
-  const contextType = requestWebgl2 ? "webgl2" : "webgl";
+  // Ensure that WebGL 2 is supported when it is requested. Otherwise, fall back to WebGL 1.
+  const webgl2Supported = typeof WebGL2RenderingContext !== "undefined";
+  if (!requestWebgl1 && !webgl2Supported) {
+    requestWebgl1 = true;
+  }
+
+  const contextType = requestWebgl1 ? "webgl" : "webgl2";
   const glContext = canvas.getContext(contextType, webglOptions);
 
   if (!defined(glContext)) {
@@ -1633,4 +1647,8 @@ Context.prototype.destroy = function () {
 
   return destroyObject(this);
 };
+
+// Used for specs.
+Context._deprecationWarning = deprecationWarning;
+
 export default Context;

package/Source/Renderer/Pass.js

@@ -20,7 +20,8 @@ const Pass = {
   CESIUM_3D_TILE_CLASSIFICATION_IGNORE_SHOW: 6,
   OPAQUE: 7,
   TRANSLUCENT: 8,
-  OVERLAY: 9,
-  NUMBER_OF_PASSES: 10,
+  VOXELS: 9,
+  OVERLAY: 10,
+  NUMBER_OF_PASSES: 11,
 };
 export default Object.freeze(Pass);

package/Source/Scene/Cesium3DTileContentType.js

@@ -132,6 +132,24 @@ const Cesium3DTileContentType = {
    * @experimental This feature is using part of the 3D Tiles spec that is not final and is subject to change without Cesium's standard deprecation policy.
    */
   GEOJSON: "geoJson",
+  /**
+   * Binary voxel content for <code>3DTILES_content_voxels</code> extension.
+   *
+   * @type {String}
+   * @constant
+   * @private
+   * @experimental This feature is using part of the 3D Tiles spec that is not final and is subject to change without Cesium's standard deprecation policy.
+   */
+  VOXEL_BINARY: "voxl",
+  /**
+   * Binary voxel content for <code>3DTILES_content_voxels</code> extension.
+   *
+   * @type {String}
+   * @constant
+   * @private
+   * @experimental This feature is using part of the 3D Tiles spec that is not final and is subject to change without Cesium's standard deprecation policy.
+   */
+  VOXEL_JSON: "voxelJson",
 };
 
 /**
@@ -150,6 +168,7 @@ Cesium3DTileContentType.isBinaryFormat = function (contentType) {
     case Cesium3DTileContentType.VECTOR:
     case Cesium3DTileContentType.GEOMETRY:
     case Cesium3DTileContentType.IMPLICIT_SUBTREE:
+    case Cesium3DTileContentType.VOXEL_BINARY:
     case Cesium3DTileContentType.GLTF_BINARY:
       return true;
     default: