@cesium/engine 2.0.0 → 2.2.0

package/Source/Core/VRTheWorldTerrainProvider.js

@@ -1,7 +1,8 @@
+import Check from "./Check.js";
 import Credit from "./Credit.js";
 import defaultValue from "./defaultValue.js";
 import defined from "./defined.js";
-import DeveloperError from "./DeveloperError.js";
+import deprecationWarning from "./deprecationWarning.js";
 import Ellipsoid from "./Ellipsoid.js";
 import Event from "./Event.js";
 import GeographicTilingScheme from "./GeographicTilingScheme.js";
@@ -20,38 +21,143 @@ function DataRectangle(rectangle, maxLevel) {
 }
 
 /**
+ * @typedef {Object} VRTheWorldTerrainProvider.ConstructorOptions
+ *
+ * Initialization options for the VRTheWorldTerrainProvider constructor
+ *
+ * @property {Ellipsoid} [ellipsoid] The ellipsoid.  If not specified, the WGS84 ellipsoid is used.
+ * @property {Credit|string} [credit] A credit for the data source, which is displayed on the canvas.
+ * @property {Resource|string} [url] The URL of the VR-TheWorld TileMap. Deprecated.
+ */
+
+/**
+ * Used to track creation details while fetching initial metadata
+ *
+ * @constructor
+ * @private
+ *
+ * @param {VRTheWorldTerrainProvider.ConstructorOptions} options An object describing initialization options
+ */
+function TerrainProviderBuilder(options) {
+  this.ellipsoid = defaultValue(options.ellipsoid, Ellipsoid.WGS84);
+  this.tilingScheme = undefined;
+  this.heightmapWidth = undefined;
+  this.heightmapHeight = undefined;
+  this.levelZeroMaximumGeometricError = undefined;
+  this.rectangles = [];
+}
+
+TerrainProviderBuilder.prototype.build = function (provider) {
+  provider._tilingScheme = this.tilingScheme;
+  provider._heightmapWidth = this.heightmapWidth;
+  provider._heightmapHeight = this.heightmapHeight;
+  provider._levelZeroMaximumGeometricError = this.levelZeroMaximumGeometricError;
+  provider._rectangles = this.rectangles;
+  provider._ready = true;
+};
+
+function metadataSuccess(terrainProviderBuilder, xml) {
+  const srs = xml.getElementsByTagName("SRS")[0].textContent;
+  if (srs === "EPSG:4326") {
+    terrainProviderBuilder.tilingScheme = new GeographicTilingScheme({
+      ellipsoid: terrainProviderBuilder.ellipsoid,
+    });
+  } else {
+    throw new RuntimeError(`SRS ${srs} is not supported`);
+  }
+
+  const tileFormat = xml.getElementsByTagName("TileFormat")[0];
+  terrainProviderBuilder.heightmapWidth = parseInt(
+    tileFormat.getAttribute("width"),
+    10
+  );
+  terrainProviderBuilder.heightmapHeight = parseInt(
+    tileFormat.getAttribute("height"),
+    10
+  );
+  terrainProviderBuilder.levelZeroMaximumGeometricError = TerrainProvider.getEstimatedLevelZeroGeometricErrorForAHeightmap(
+    terrainProviderBuilder.ellipsoid,
+    Math.min(
+      terrainProviderBuilder.heightmapWidth,
+      terrainProviderBuilder.heightmapHeight
+    ),
+    terrainProviderBuilder.tilingScheme.getNumberOfXTilesAtLevel(0)
+  );
+
+  const dataRectangles = xml.getElementsByTagName("DataExtent");
+
+  for (let i = 0; i < dataRectangles.length; ++i) {
+    const dataRectangle = dataRectangles[i];
+
+    const west = CesiumMath.toRadians(
+      parseFloat(dataRectangle.getAttribute("minx"))
+    );
+    const south = CesiumMath.toRadians(
+      parseFloat(dataRectangle.getAttribute("miny"))
+    );
+    const east = CesiumMath.toRadians(
+      parseFloat(dataRectangle.getAttribute("maxx"))
+    );
+    const north = CesiumMath.toRadians(
+      parseFloat(dataRectangle.getAttribute("maxy"))
+    );
+    const maxLevel = parseInt(dataRectangle.getAttribute("maxlevel"), 10);
+
+    terrainProviderBuilder.rectangles.push(
+      new DataRectangle(new Rectangle(west, south, east, north), maxLevel)
+    );
+  }
+}
+
+function metadataFailure(resource, error, provider) {
+  let message = `An error occurred while accessing ${resource.url}`;
+
+  if (defined(error) && defined(error.message)) {
+    message = `${message}: ${error.message}`;
+  }
+
+  TileProviderError.reportError(
+    undefined,
+    provider,
+    defined(provider) ? provider._errorEvent : undefined,
+    message
+  );
+
+  throw new RuntimeError(message);
+}
+
+async function requestMetadata(terrainProviderBuilder, resource, provider) {
+  try {
+    const xml = await resource.fetchXML();
+    metadataSuccess(terrainProviderBuilder, xml);
+  } catch (error) {
+    metadataFailure(resource, error, provider);
+  }
+}
+
+/**
+ * <div class="notice">
+ * To construct a VRTheWorldTerrainProvider, call {@link VRTheWorldTerrainProvider.fromUrl}. Do not call the constructor directly.
+ * </div>
+ *
  * A {@link TerrainProvider} that produces terrain geometry by tessellating height maps
  * retrieved from a {@link http://vr-theworld.com/|VT MÄK VR-TheWorld server}.
  *
  * @alias VRTheWorldTerrainProvider
  * @constructor
  *
- * @param {Object} options Object with the following properties:
- * @param {Resource|String} options.url The URL of the VR-TheWorld TileMap.
- * @param {Ellipsoid} [options.ellipsoid=Ellipsoid.WGS84] The ellipsoid.  If this parameter is not
- *                    specified, the WGS84 ellipsoid is used.
- * @param {Credit|String} [options.credit] A credit for the data source, which is displayed on the canvas.
- *
+ * @param {VRTheWorldTerrainProvider.ConstructorOptions} [options] An object describing initialization options.
  *
  * @example
- * const terrainProvider = new Cesium.VRTheWorldTerrainProvider({
- *   url : 'https://www.vr-theworld.com/vr-theworld/tiles1.0.0/73/'
- * });
+ * const terrainProvider = await Cesium.VRTheWorldTerrainProvider.fromUrl(
+ *   "https://www.vr-theworld.com/vr-theworld/tiles1.0.0/73/"
+ * );
  * viewer.terrainProvider = terrainProvider;
  *
  * @see TerrainProvider
  */
 function VRTheWorldTerrainProvider(options) {
   options = defaultValue(options, defaultValue.EMPTY_OBJECT);
-  //>>includeStart('debug', pragmas.debug);
-  if (!defined(options.url)) {
-    throw new DeveloperError("options.url is required.");
-  }
-  //>>includeEnd('debug');
-
-  const resource = Resource.createIfNeeded(options.url);
-
-  this._resource = resource;
 
   this._errorEvent = new Event();
   this._ready = false;
@@ -76,80 +182,26 @@ function VRTheWorldTerrainProvider(options) {
   this._tilingScheme = undefined;
   this._rectangles = [];
 
-  const that = this;
-  let metadataError;
-  const ellipsoid = defaultValue(options.ellipsoid, Ellipsoid.WGS84);
-
-  function metadataSuccess(xml) {
-    const srs = xml.getElementsByTagName("SRS")[0].textContent;
-    if (srs === "EPSG:4326") {
-      that._tilingScheme = new GeographicTilingScheme({ ellipsoid: ellipsoid });
-    } else {
-      return Promise.reject(new RuntimeError(`SRS ${srs} is not supported.`));
-    }
-
-    const tileFormat = xml.getElementsByTagName("TileFormat")[0];
-    that._heightmapWidth = parseInt(tileFormat.getAttribute("width"), 10);
-    that._heightmapHeight = parseInt(tileFormat.getAttribute("height"), 10);
-    that._levelZeroMaximumGeometricError = TerrainProvider.getEstimatedLevelZeroGeometricErrorForAHeightmap(
-      ellipsoid,
-      Math.min(that._heightmapWidth, that._heightmapHeight),
-      that._tilingScheme.getNumberOfXTilesAtLevel(0)
+  if (defined(options.url)) {
+    deprecationWarning(
+      "VRTheWorldTerrainProvider options.url",
+      "options.url was deprecated in CesiumJS 1.104.  It will be in CesiumJS 1.107.  VRTheWorldTerrainProvider.fromUrl instead."
     );
-
-    const dataRectangles = xml.getElementsByTagName("DataExtent");
-
-    for (let i = 0; i < dataRectangles.length; ++i) {
-      const dataRectangle = dataRectangles[i];
-
-      const west = CesiumMath.toRadians(
-        parseFloat(dataRectangle.getAttribute("minx"))
-      );
-      const south = CesiumMath.toRadians(
-        parseFloat(dataRectangle.getAttribute("miny"))
-      );
-      const east = CesiumMath.toRadians(
-        parseFloat(dataRectangle.getAttribute("maxx"))
-      );
-      const north = CesiumMath.toRadians(
-        parseFloat(dataRectangle.getAttribute("maxy"))
-      );
-      const maxLevel = parseInt(dataRectangle.getAttribute("maxlevel"), 10);
-
-      that._rectangles.push(
-        new DataRectangle(new Rectangle(west, south, east, north), maxLevel)
-      );
-    }
-
-    that._ready = true;
-    return Promise.resolve(true);
-  }
-
-  function metadataFailure(e) {
-    const message = defaultValue(
-      defined(e) ? e.message : undefined,
-      `An error occurred while accessing ${that._resource.url}.`
-    );
-    metadataError = TileProviderError.reportError(
-      metadataError,
-      that,
-      that._errorEvent,
-      message
-    );
-    if (metadataError.retry) {
-      return requestMetadata();
-    }
-    return Promise.reject(new RuntimeError(message));
-  }
-
-  function requestMetadata() {
-    return that._resource
-      .fetchXML()
-      .then(metadataSuccess)
-      .catch(metadataFailure);
+    const that = this;
+    const terrainProviderBuilder = new TerrainProviderBuilder(options);
+    const resource = Resource.createIfNeeded(options.url);
+
+    this._resource = resource;
+
+    this._readyPromise = requestMetadata(
+      terrainProviderBuilder,
+      resource,
+      that
+    ).then(() => {
+      terrainProviderBuilder.build(that);
+      return true;
+    });
   }
-
-  this._readyPromise = requestMetadata();
 }
 
 Object.defineProperties(VRTheWorldTerrainProvider.prototype, {
@@ -169,7 +221,7 @@ Object.defineProperties(VRTheWorldTerrainProvider.prototype, {
 
   /**
    * Gets the credit to display when this terrain provider is active.  Typically this is used to credit
-   * the source of the terrain.  This function should not be called before {@link VRTheWorldTerrainProvider#ready} returns true.
+   * the source of the terrain.
    * @memberof VRTheWorldTerrainProvider.prototype
    * @type {Credit}
    * @readonly
@@ -181,22 +233,13 @@ Object.defineProperties(VRTheWorldTerrainProvider.prototype, {
   },
 
   /**
-   * Gets the tiling scheme used by this provider.  This function should
-   * not be called before {@link VRTheWorldTerrainProvider#ready} returns true.
+   * Gets the tiling scheme used by this provider.
    * @memberof VRTheWorldTerrainProvider.prototype
    * @type {GeographicTilingScheme}
    * @readonly
    */
   tilingScheme: {
     get: function () {
-      //>>includeStart('debug', pragmas.debug);
-      if (!this.ready) {
-        throw new DeveloperError(
-          "requestTileGeometry must not be called before ready returns true."
-        );
-      }
-      //>>includeEnd('debug');
-
       return this._tilingScheme;
     },
   },
@@ -204,11 +247,16 @@ Object.defineProperties(VRTheWorldTerrainProvider.prototype, {
   /**
    * Gets a value indicating whether or not the provider is ready for use.
    * @memberof VRTheWorldTerrainProvider.prototype
-   * @type {Boolean}
+   * @type {boolean}
    * @readonly
+   * @deprecated
    */
   ready: {
     get: function () {
+      deprecationWarning(
+        "VRTheWorldTerrainProvider.ready",
+        "VRTheWorldTerrainProvider.ready was deprecated in CesiumJS 1.104.  It will be in CesiumJS 1.107.  Use VRTheWorldTerrainProvider.fromUrl instead."
+      );
       return this._ready;
     },
   },
@@ -216,11 +264,16 @@ Object.defineProperties(VRTheWorldTerrainProvider.prototype, {
   /**
    * Gets a promise that resolves to true when the provider is ready for use.
    * @memberof VRTheWorldTerrainProvider.prototype
-   * @type {Promise.<Boolean>}
+   * @type {Promise<boolean>}
    * @readonly
+   * @deprecated
    */
   readyPromise: {
     get: function () {
+      deprecationWarning(
+        "VRTheWorldTerrainProvider.readyPromise",
+        "VRTheWorldTerrainProvider.readyPromise was deprecated in CesiumJS 1.104.  It will be in CesiumJS 1.107.  Use VRTheWorldTerrainProvider.fromUrl instead."
+      );
       return this._readyPromise;
     },
   },
@@ -228,10 +281,9 @@ Object.defineProperties(VRTheWorldTerrainProvider.prototype, {
   /**
    * Gets a value indicating whether or not the provider includes a water mask.  The water mask
    * indicates which areas of the globe are water rather than land, so they can be rendered
-   * as a reflective surface with animated waves.  This function should not be
-   * called before {@link VRTheWorldTerrainProvider#ready} returns true.
+   * as a reflective surface with animated waves.
    * @memberof VRTheWorldTerrainProvider.prototype
-   * @type {Boolean}
+   * @type {boolean}
    * @readonly
    */
   hasWaterMask: {
@@ -242,9 +294,8 @@ Object.defineProperties(VRTheWorldTerrainProvider.prototype, {
 
   /**
    * Gets a value indicating whether or not the requested tiles include vertex normals.
-   * This function should not be called before {@link VRTheWorldTerrainProvider#ready} returns true.
    * @memberof VRTheWorldTerrainProvider.prototype
-   * @type {Boolean}
+   * @type {boolean}
    * @readonly
    */
   hasVertexNormals: {
@@ -254,8 +305,7 @@ Object.defineProperties(VRTheWorldTerrainProvider.prototype, {
   },
   /**
    * Gets an object that can be used to determine availability of terrain from this provider, such as
-   * at points and in rectangles.  This function should not be called before
-   * {@link TerrainProvider#ready} returns true.  This property may be undefined if availability
+   * at points and in rectangles. This property may be undefined if availability
    * information is not available.
    * @memberof VRTheWorldTerrainProvider.prototype
    * @type {TileAvailability}
@@ -269,15 +319,49 @@ Object.defineProperties(VRTheWorldTerrainProvider.prototype, {
 });
 
 /**
- * Requests the geometry for a given tile.  This function should not be called before
- * {@link VRTheWorldTerrainProvider#ready} returns true.  The result includes terrain
+ * Creates a {@link TerrainProvider} that produces terrain geometry by tessellating height maps
+ * retrieved from a {@link http://vr-theworld.com/|VT MÄK VR-TheWorld server}.
+ *
+ * @param {Resource|String} url The URL of the VR-TheWorld TileMap.
+ * @param {VRTheWorldTerrainProvider.ConstructorOptions} [options] An object describing initialization options.
+ * @returns {Promise<VRTheWorldTerrainProvider>}
+ *
+ * @example
+ * const terrainProvider = await Cesium.VRTheWorldTerrainProvider.fromUrl(
+ *   "https://www.vr-theworld.com/vr-theworld/tiles1.0.0/73/"
+ * );
+ * viewer.terrainProvider = terrainProvider;
+ *
+ * @exception {RuntimeError} metadata specifies and unknown SRS
+ */
+VRTheWorldTerrainProvider.fromUrl = async function (url, options) {
+  //>>includeStart('debug', pragmas.debug);
+  Check.defined("url", url);
+  //>>includeEnd('debug');
+
+  options = defaultValue(options, defaultValue.EMPTY_OBJECT);
+
+  const terrainProviderBuilder = new TerrainProviderBuilder(options);
+  const resource = Resource.createIfNeeded(url);
+
+  await requestMetadata(terrainProviderBuilder, resource);
+
+  const provider = new VRTheWorldTerrainProvider(options);
+  terrainProviderBuilder.build(provider);
+  provider._resource = resource;
+
+  return provider;
+};
+
+/**
+ * Requests the geometry for a given tile. The result includes terrain
  * data and indicates that all child tiles are available.
  *
- * @param {Number} x The X coordinate of the tile for which to request geometry.
- * @param {Number} y The Y coordinate of the tile for which to request geometry.
- * @param {Number} level The level of the tile for which to request geometry.
+ * @param {number} x The X coordinate of the tile for which to request geometry.
+ * @param {number} y The Y coordinate of the tile for which to request geometry.
+ * @param {number} level The level of the tile for which to request geometry.
  * @param {Request} [request] The request object. Intended for internal use only.
- * @returns {Promise.<TerrainData>|undefined} A promise for the requested geometry.  If this method
+ * @returns {Promise<TerrainData>|undefined} A promise for the requested geometry.  If this method
  *          returns undefined instead of a promise, it is an indication that too many requests are already
  *          pending and the request will be retried later.
  */
@@ -287,14 +371,6 @@ VRTheWorldTerrainProvider.prototype.requestTileGeometry = function (
   level,
   request
 ) {
-  //>>includeStart('debug', pragmas.debug);
-  if (!this.ready) {
-    throw new DeveloperError(
-      "requestTileGeometry must not be called before ready returns true."
-    );
-  }
-  //>>includeEnd('debug');
-
   const yTiles = this._tilingScheme.getNumberOfYTilesAtLevel(level);
   const resource = this._resource.getDerivedResource({
     url: `${level}/${x}/${yTiles - y - 1}.tif`,
@@ -325,19 +401,12 @@ VRTheWorldTerrainProvider.prototype.requestTileGeometry = function (
 /**
  * Gets the maximum geometric error allowed in a tile at a given level.
  *
- * @param {Number} level The tile level for which to get the maximum geometric error.
- * @returns {Number} The maximum geometric error.
+ * @param {number} level The tile level for which to get the maximum geometric error.
+ * @returns {number} The maximum geometric error.
  */
 VRTheWorldTerrainProvider.prototype.getLevelMaximumGeometricError = function (
   level
 ) {
-  //>>includeStart('debug', pragmas.debug);
-  if (!this.ready) {
-    throw new DeveloperError(
-      "requestTileGeometry must not be called before ready returns true."
-    );
-  }
-  //>>includeEnd('debug');
   return this._levelZeroMaximumGeometricError / (1 << level);
 };
 
@@ -419,10 +488,10 @@ function isTileInRectangle(tilingScheme, rectangle, x, y, level) {
 /**
  * Determines whether data for a tile is available to be loaded.
  *
- * @param {Number} x The X coordinate of the tile for which to request geometry.
- * @param {Number} y The Y coordinate of the tile for which to request geometry.
- * @param {Number} level The level of the tile for which to request geometry.
- * @returns {Boolean|undefined} Undefined if not supported, otherwise true or false.
+ * @param {number} x The X coordinate of the tile for which to request geometry.
+ * @param {number} y The Y coordinate of the tile for which to request geometry.
+ * @param {number} level The level of the tile for which to request geometry.
+ * @returns {boolean|undefined} Undefined if not supported, otherwise true or false.
  */
 VRTheWorldTerrainProvider.prototype.getTileDataAvailable = function (
   x,
@@ -435,9 +504,9 @@ VRTheWorldTerrainProvider.prototype.getTileDataAvailable = function (
 /**
  * Makes sure we load availability data for a tile
  *
- * @param {Number} x The X coordinate of the tile for which to request geometry.
- * @param {Number} y The Y coordinate of the tile for which to request geometry.
- * @param {Number} level The level of the tile for which to request geometry.
+ * @param {number} x The X coordinate of the tile for which to request geometry.
+ * @param {number} y The Y coordinate of the tile for which to request geometry.
+ * @param {number} level The level of the tile for which to request geometry.
  * @returns {undefined|Promise<void>} Undefined if nothing need to be loaded or a Promise that resolves when all required tiles are loaded
  */
 VRTheWorldTerrainProvider.prototype.loadTileDataAvailability = function (

package/Source/Core/VertexFormat.js

@@ -7,7 +7,7 @@ import DeveloperError from "./DeveloperError.js";
  * to a {@link Geometry} to request that certain properties be computed, e.g., just position,
  * position and normal, etc.
  *
- * @param {Object} [options] An object with boolean properties corresponding to VertexFormat properties as shown in the code example.
+ * @param {object} [options] An object with boolean properties corresponding to VertexFormat properties as shown in the code example.
  *
  * @alias VertexFormat
  * @constructor
@@ -31,7 +31,7 @@ function VertexFormat(options) {
    * 64-bit floating-point (for precision).  3 components per attribute.
    * </p>
    *
-   * @type Boolean
+   * @type {boolean}
    *
    * @default false
    */
@@ -43,7 +43,7 @@ function VertexFormat(options) {
    * 32-bit floating-point.  3 components per attribute.
    * </p>
    *
-   * @type Boolean
+   * @type {boolean}
    *
    * @default false
    */
@@ -55,7 +55,7 @@ function VertexFormat(options) {
    * 32-bit floating-point.  2 components per attribute
    * </p>
    *
-   * @type Boolean
+   * @type {boolean}
    *
    * @default false
    */
@@ -67,7 +67,7 @@ function VertexFormat(options) {
    * 32-bit floating-point.  3 components per attribute.
    * </p>
    *
-   * @type Boolean
+   * @type {boolean}
    *
    * @default false
    */
@@ -79,7 +79,7 @@ function VertexFormat(options) {
    * 32-bit floating-point.  3 components per attribute.
    * </p>
    *
-   * @type Boolean
+   * @type {boolean}
    *
    * @default false
    */
@@ -91,7 +91,7 @@ function VertexFormat(options) {
    * 8-bit unsigned byte.  3 components per attribute.
    * </p>
    *
-   * @type Boolean
+   * @type {boolean}
    *
    * @default false
    */
@@ -220,7 +220,7 @@ VertexFormat.DEFAULT = VertexFormat.POSITION_NORMAL_AND_ST;
 
 /**
  * The number of elements used to pack the object into an array.
- * @type {Number}
+ * @type {number}
  */
 VertexFormat.packedLength = 6;
 
@@ -228,10 +228,10 @@ VertexFormat.packedLength = 6;
  * Stores the provided instance into the provided array.
  *
  * @param {VertexFormat} value The value to pack.
- * @param {Number[]} array The array to pack into.
- * @param {Number} [startingIndex=0] The index into the array at which to start packing the elements.
+ * @param {number[]} array The array to pack into.
+ * @param {number} [startingIndex=0] The index into the array at which to start packing the elements.
  *
- * @returns {Number[]} The array that was packed into
+ * @returns {number[]} The array that was packed into
  */
 VertexFormat.pack = function (value, array, startingIndex) {
   //>>includeStart('debug', pragmas.debug);
@@ -258,8 +258,8 @@ VertexFormat.pack = function (value, array, startingIndex) {
 /**
  * Retrieves an instance from a packed array.
  *
- * @param {Number[]} array The packed array.
- * @param {Number} [startingIndex=0] The starting index of the element to be unpacked.
+ * @param {number[]} array The packed array.
+ * @param {number} [startingIndex=0] The starting index of the element to be unpacked.
  * @param {VertexFormat} [result] The object into which to store the result.
  * @returns {VertexFormat} The modified result parameter or a new VertexFormat instance if one was not provided.
  */

package/Source/Core/VideoSynchronizer.js

@@ -10,11 +10,11 @@ import JulianDate from "./JulianDate.js";
  * @alias VideoSynchronizer
  * @constructor
  *
- * @param {Object} [options] Object with the following properties:
+ * @param {object} [options] Object with the following properties:
  * @param {Clock} [options.clock] The clock instance used to drive the video.
  * @param {HTMLVideoElement} [options.element] The video element to be synchronized.
  * @param {JulianDate} [options.epoch=Iso8601.MINIMUM_VALUE] The simulation time that marks the start of the video.
- * @param {Number} [options.tolerance=1.0] The maximum amount of time, in seconds, that the clock and video can diverge.
+ * @param {number} [options.tolerance=1.0] The maximum amount of time, in seconds, that the clock and video can diverge.
  *
  * @demo {@link https://sandcastle.cesium.com/index.html?src=Video.html|Video Material Demo}
  */
@@ -43,7 +43,7 @@ function VideoSynchronizer(options) {
    * Lower values make the synchronization more accurate but video
    * performance might suffer.  Higher values provide better performance
    * but at the cost of accuracy.
-   * @type {Number}
+   * @type {number}
    * @default 1.0
    */
   this.tolerance = defaultValue(options.tolerance, 1.0);
@@ -134,7 +134,7 @@ VideoSynchronizer.prototype.destroy = function () {
 /**
  * Returns true if this object was destroyed; otherwise, false.
  *
- * @returns {Boolean} True if this object was destroyed; otherwise, false.
+ * @returns {boolean} True if this object was destroyed; otherwise, false.
  */
 VideoSynchronizer.prototype.isDestroyed = function () {
   return false;

package/Source/Core/Visibility.js

@@ -4,13 +4,13 @@
  * it has no visibility, may partially block an occludee from view, or may not block it at all,
  * leading to full visibility.
  *
- * @enum {Number}
+ * @enum {number}
  */
 const Visibility = {
   /**
    * Represents that no part of an object is visible.
    *
-   * @type {Number}
+   * @type {number}
    * @constant
    */
   NONE: -1,
@@ -18,7 +18,7 @@ const Visibility = {
   /**
    * Represents that part, but not all, of an object is visible
    *
-   * @type {Number}
+   * @type {number}
    * @constant
    */
   PARTIAL: 0,
@@ -26,7 +26,7 @@ const Visibility = {
   /**
    * Represents that an object is visible in its entirety.
    *
-   * @type {Number}
+   * @type {number}
    * @constant
    */
   FULL: 1,

package/Source/Core/VulkanConstants.js

@@ -3,7 +3,7 @@
  *
  * These match the constants from the {@link https://www.khronos.org/registry/vulkan/specs/1.2-extensions/html/vkspec.html#formats-definition|Vulkan 1.2 specification}.
  *
- * @enum {Number}
+ * @enum {number}
  * @private
  */
 const VulkanConstants = {