@cesium/engine 1.1.0 → 2.1.0

package/Source/Core/binarySearch.js

@@ -8,7 +8,7 @@ import Check from "./Check.js";
  * @param {*} itemToFind The item to find in the array.
  * @param {binarySearchComparator} comparator The function to use to compare the item to
  *        elements in the array.
- * @returns {Number} The index of <code>itemToFind</code> in the array, if it exists.  If <code>itemToFind</code>
+ * @returns {number} The index of <code>itemToFind</code> in the array, if it exists.  If <code>itemToFind</code>
  *        does not exist, the return value is a negative number which is the bitwise complement (~)
  *        of the index before which the itemToFind should be inserted in order to maintain the
  *        sorted order of the array.
@@ -55,7 +55,7 @@ function binarySearch(array, itemToFind, comparator) {
  *
  * @param {*} a An item in the array.
  * @param {*} b The item being searched for.
- * @returns {Number} Returns a negative value if <code>a</code> is less than <code>b</code>,
+ * @returns {number} Returns a negative value if <code>a</code> is less than <code>b</code>,
  *          a positive value if <code>a</code> is greater than <code>b</code>, or
  *          0 if <code>a</code> is equal to <code>b</code>.
  *

package/Source/Core/buildModuleUrl.js

@@ -93,8 +93,8 @@ let implementation;
  * Given a relative URL under the Cesium base URL, returns an absolute URL.
  * @function
  *
- * @param {String} relativeUrl The relative path.
- * @returns {String} The absolutely URL representation of the provided path.
+ * @param {string} relativeUrl The relative path.
+ * @returns {string} The absolutely URL representation of the provided path.
  *
  * @example
  * const viewer = new Cesium.Viewer("cesiumContainer", {
@@ -132,7 +132,7 @@ buildModuleUrl._clearBaseResource = function () {
 
 /**
  * Sets the base URL for resolving modules.
- * @param {String} value The new base URL.
+ * @param {string} value The new base URL.
  */
 buildModuleUrl.setBaseUrl = function (value) {
   baseResource = Resource.DEFAULT.getDerivedResource({
@@ -144,7 +144,7 @@ buildModuleUrl.setBaseUrl = function (value) {
  * Gets the base URL for resolving modules.
  *
  * @function
- * @returns {String} The configured base URL
+ * @returns {string} The configured base URL
  */
 buildModuleUrl.getCesiumBaseUrl = getCesiumBaseUrl;
 

package/Source/Core/clone.js

@@ -5,9 +5,9 @@ import defaultValue from "./defaultValue.js";
  *
  * @function
  *
- * @param {Object} object The object to clone.
- * @param {Boolean} [deep=false] If true, all properties will be deep cloned recursively.
- * @returns {Object} The cloned object.
+ * @param {object} object The object to clone.
+ * @param {boolean} [deep=false] If true, all properties will be deep cloned recursively.
+ * @returns {object} The cloned object.
  */
 function clone(object, deep) {
   if (object === null || typeof object !== "object") {

package/Source/Core/combine.js

@@ -25,10 +25,10 @@ import defined from "./defined.js";
  * //     }
  * // }
  *
- * @param {Object} [object1] The first object to merge.
- * @param {Object} [object2] The second object to merge.
- * @param {Boolean} [deep=false] Perform a recursive merge.
- * @returns {Object} The combined object containing all properties from both objects.
+ * @param {object} [object1] The first object to merge.
+ * @param {object} [object2] The second object to merge.
+ * @param {boolean} [deep=false] Perform a recursive merge.
+ * @returns {object} The combined object containing all properties from both objects.
  *
  * @function
  */

package/Source/Core/createGuid.js

@@ -3,7 +3,7 @@
  *
  * @function
  *
- * @returns {String}
+ * @returns {string}
  *
  *
  * @example

package/Source/Core/createWorldTerrain.js

@@ -7,9 +7,9 @@ import IonResource from "./IonResource.js";
  *
  * @function
  *
- * @param {Object} [options] Object with the following properties:
- * @param {Boolean} [options.requestVertexNormals=false] Flag that indicates if the client should request additional lighting information from the server if available.
- * @param {Boolean} [options.requestWaterMask=false] Flag that indicates if the client should request per tile water masks from the server if available.
+ * @param {object} [options] Object with the following properties:
+ * @param {boolean} [options.requestVertexNormals=false] Flag that indicates if the client should request additional lighting information from the server if available.
+ * @param {boolean} [options.requestWaterMask=false] Flag that indicates if the client should request per tile water masks from the server if available.
  * @returns {CesiumTerrainProvider}
  *
  * @see Ion

package/Source/Core/defaultValue.js

@@ -21,7 +21,7 @@ function defaultValue(a, b) {
 /**
  * A frozen empty object that can be used as the default value for options passed as
  * an object literal.
- * @type {Object}
+ * @type {object}
  * @memberof defaultValue
  */
 defaultValue.EMPTY_OBJECT = Object.freeze({});

package/Source/Core/defer.js

@@ -15,7 +15,7 @@
 /**
  * An object which contains a promise object, and functions to resolve or reject the promise.
  *
- * @typedef {Object} defer.deferred
+ * @typedef {object} defer.deferred
  * @property {defer.resolve} resolve Resolves the promise when called.
  * @property {defer.reject} reject Rejects the promise when called.
  * @property {Promise} promise Promise object.

package/Source/Core/defined.js

@@ -2,7 +2,7 @@
  * @function
  *
  * @param {*} value The object.
- * @returns {Boolean} Returns true if the object is defined, returns false otherwise.
+ * @returns {boolean} Returns true if the object is defined, returns false otherwise.
  *
  * @example
  * if (Cesium.defined(positions)) {

package/Source/Core/deprecationWarning.js

@@ -9,8 +9,8 @@ import oneTimeWarning from "./oneTimeWarning.js";
  *
  * @function deprecationWarning
  *
- * @param {String} identifier The unique identifier for this deprecated API.
- * @param {String} message The message to log to the console.
+ * @param {string} identifier The unique identifier for this deprecated API.
+ * @param {string} message The message to log to the console.
  *
  * @example
  * // Deprecated function or class

package/Source/Core/destroyObject.js

@@ -18,8 +18,8 @@ function returnTrue() {
  *
  * @function
  *
- * @param {Object} object The object to destroy.
- * @param {String} [message] The message to include in the exception that is thrown if
+ * @param {object} object The object to destroy.
+ * @param {string} [message] The message to include in the exception that is thrown if
  *                           a destroyed object's function is called.
  *
  *

package/Source/Core/formatError.js

@@ -7,7 +7,7 @@ import defined from "./defined.js";
  * @function
  *
  * @param {*} object The item to find in the array.
- * @returns {String} A string containing the formatted error.
+ * @returns {string} A string containing the formatted error.
  */
 function formatError(object) {
   let result;

package/Source/Core/getAbsoluteUri.js

@@ -7,9 +7,9 @@ import DeveloperError from "./DeveloperError.js";
  * Given a relative Uri and a base Uri, returns the absolute Uri of the relative Uri.
  * @function
  *
- * @param {String} relative The relative Uri.
- * @param {String} [base] The base Uri.
- * @returns {String} The absolute Uri of the given relative Uri.
+ * @param {string} relative The relative Uri.
+ * @param {string} [base] The base Uri.
+ * @returns {string} The absolute Uri of the given relative Uri.
  *
  * @example
  * //absolute Uri will be "https://test.com/awesome.png";

package/Source/Core/getBaseUri.js

@@ -6,9 +6,9 @@ import DeveloperError from "./DeveloperError.js";
  * Given a URI, returns the base path of the URI.
  * @function
  *
- * @param {String} uri The Uri.
- * @param {Boolean} [includeQuery = false] Whether or not to include the query string and fragment form the uri
- * @returns {String} The base path of the Uri.
+ * @param {string} uri The Uri.
+ * @param {boolean} [includeQuery = false] Whether or not to include the query string and fragment form the uri
+ * @returns {string} The base path of the Uri.
  *
  * @example
  * // basePath will be "/Gallery/";

package/Source/Core/getExtensionFromUri.js

@@ -6,8 +6,8 @@ import DeveloperError from "./DeveloperError.js";
  * Given a URI, returns the extension of the URI.
  * @function getExtensionFromUri
  *
- * @param {String} uri The Uri.
- * @returns {String} The extension of the Uri.
+ * @param {string} uri The Uri.
+ * @returns {string} The extension of the Uri.
  *
  * @example
  * //extension will be "czml";

package/Source/Core/getFilenameFromUri.js

@@ -6,8 +6,8 @@ import DeveloperError from "./DeveloperError.js";
  * Given a URI, returns the last segment of the URI, removing any path or query information.
  * @function getFilenameFromUri
  *
- * @param {String} uri The Uri.
- * @returns {String} The last segment of the Uri.
+ * @param {string} uri The Uri.
+ * @returns {string} The last segment of the Uri.
  *
  * @example
  * //fileName will be"simple.czml";

package/Source/Core/getImageFromTypedArray.js

@@ -2,8 +2,8 @@
  * Constructs an image from a TypedArray of pixel values
  *
  * @param {Uint8Array} typedArray The array of pixel values
- * @param {Number} width The width of the image to create
- * @param {Number} height The height of the image to create
+ * @param {number} width The width of the image to create
+ * @param {number} height The height of the image to create
  * @returns {HTMLCanvasElement} A new canvas containing the constructed image
  *
  * @private

package/Source/Core/getImagePixels.js

@@ -9,8 +9,8 @@ const context2DsByWidthAndHeight = {};
  * @function getImagePixels
  *
  * @param {HTMLImageElement|ImageBitmap} image The image to extract pixels from.
- * @param {Number} width The width of the image. If not defined, then image.width is assigned.
- * @param {Number} height The height of the image. If not defined, then image.height is assigned.
+ * @param {number} width The width of the image. If not defined, then image.width is assigned.
+ * @param {number} height The height of the image. If not defined, then image.height is assigned.
  * @returns {ImageData} The pixels of the image.
  */
 function getImagePixels(image, width, height) {
@@ -32,7 +32,8 @@ function getImagePixels(image, width, height) {
     const canvas = document.createElement("canvas");
     canvas.width = width;
     canvas.height = height;
-    context2d = canvas.getContext("2d");
+    // Since we re-use contexts, use the willReadFrequently option – See https://html.spec.whatwg.org/multipage/canvas.html#concept-canvas-will-read-frequently
+    context2d = canvas.getContext("2d", { willReadFrequently: true });
     context2d.globalCompositeOperation = "copy";
     context2DsByHeight[height] = context2d;
   }

package/Source/Core/getJsonFromTypedArray.js

@@ -6,9 +6,9 @@ import getStringFromTypedArray from "./getStringFromTypedArray.js";
  * @function
  *
  * @param {Uint8Array} uint8Array The Uint8Array to read from.
- * @param {Number} [byteOffset=0] The byte offset to start reading from.
- * @param {Number} [byteLength] The byte length to read. If byteLength is omitted the remainder of the buffer is read.
- * @returns {Object} An object containing the parsed JSON.
+ * @param {number} [byteOffset=0] The byte offset to start reading from.
+ * @param {number} [byteLength] The byte length to read. If byteLength is omitted the remainder of the buffer is read.
+ * @returns {object} An object containing the parsed JSON.
  *
  * @private
  */

package/Source/Core/getStringFromTypedArray.js

@@ -9,9 +9,9 @@ import RuntimeError from "./RuntimeError.js";
  * @function
  *
  * @param {Uint8Array} uint8Array The Uint8Array to read from.
- * @param {Number} [byteOffset=0] The byte offset to start reading from.
- * @param {Number} [byteLength] The byte length to read. If byteLength is omitted the remainder of the buffer is read.
- * @returns {String} The string.
+ * @param {number} [byteOffset=0] The byte offset to start reading from.
+ * @param {number} [byteLength] The byte length to read. If byteLength is omitted the remainder of the buffer is read.
+ * @returns {string} The string.
  *
  * @private
  */

package/Source/Core/getTimestamp.js

@@ -6,7 +6,7 @@
  *
  * @function getTimestamp
  *
- * @returns {Number} The timestamp in milliseconds since some unspecified reference time.
+ * @returns {number} The timestamp in milliseconds since some unspecified reference time.
  */
 let getTimestamp;
 

package/Source/Core/isBlobUri.js

@@ -7,8 +7,8 @@ const blobUriRegex = /^blob:/i;
  *
  * @function isBlobUri
  *
- * @param {String} uri The uri to test.
- * @returns {Boolean} true when the uri is a blob uri; otherwise, false.
+ * @param {string} uri The uri to test.
+ * @returns {boolean} true when the uri is a blob uri; otherwise, false.
  *
  * @private
  */

package/Source/Core/isDataUri.js

@@ -7,8 +7,8 @@ const dataUriRegex = /^data:/i;
  *
  * @function isDataUri
  *
- * @param {String} uri The uri to test.
- * @returns {Boolean} true when the uri is a data uri; otherwise, false.
+ * @param {string} uri The uri to test.
+ * @returns {boolean} true when the uri is a data uri; otherwise, false.
  *
  * @private
  */

package/Source/Core/isLeapYear.js

@@ -5,8 +5,8 @@ import DeveloperError from "./DeveloperError.js";
  *
  * @function isLeapYear
  *
- * @param {Number} year The year to be tested.
- * @returns {Boolean} True if <code>year</code> is a leap year.
+ * @param {number} year The year to be tested.
+ * @returns {boolean} True if <code>year</code> is a leap year.
  *
  * @example
  * const leapYear = Cesium.isLeapYear(2000); // true

package/Source/Core/loadKTX2.js

@@ -5,12 +5,12 @@ import KTX2Transcoder from "./KTX2Transcoder.js";
 /**
  * Stores the supported formats that KTX2 can transcode to. Called during context creation.
  *
- * @param {Boolean} s3tc Whether or not S3TC is supported
- * @param {Boolean} pvrtc Whether or not PVRTC is supported
- * @param {Boolean} astc Whether or not ASTC is supported
- * @param {Boolean} etc Whether or not ETC is supported
- * @param {Boolean} etc1 Whether or not ETC1 is supported
- * @param {Boolean} bc7 Whether or not BC7 is supported
+ * @param {boolean} s3tc Whether or not S3TC is supported
+ * @param {boolean} pvrtc Whether or not PVRTC is supported
+ * @param {boolean} astc Whether or not ASTC is supported
+ * @param {boolean} etc Whether or not ETC is supported
+ * @param {boolean} etc1 Whether or not ETC1 is supported
+ * @param {boolean} bc7 Whether or not BC7 is supported
  * @private
  */
 let supportedTranscoderFormats;
@@ -51,8 +51,8 @@ loadKTX2.setKTX2SupportedFormats = function (
  *
  * @function loadKTX2
  *
- * @param {Resource|String|ArrayBuffer} resourceOrUrlOrBuffer The URL of the binary data or an ArrayBuffer.
- * @returns {Promise.<CompressedTextureBuffer>|undefined} A promise that will resolve to the requested data when loaded. Returns undefined if <code>request.throttle</code> is true and the request does not have high enough priority.
+ * @param {Resource|string|ArrayBuffer} resourceOrUrlOrBuffer The URL of the binary data or an ArrayBuffer.
+ * @returns {Promise<CompressedTextureBuffer>|undefined} A promise that will resolve to the requested data when loaded. Returns undefined if <code>request.throttle</code> is true and the request does not have high enough priority.
  *
  * @exception {RuntimeError} Invalid KTX2 file.
  * @exception {RuntimeError} KTX2 texture arrays are not supported.

package/Source/Core/mergeSort.js

@@ -99,7 +99,7 @@ function mergeSort(array, comparator, userDefinedObject) {
  * @param {*} a An item in the array.
  * @param {*} b An item in the array.
  * @param {*} [userDefinedObject] An object that was passed to {@link mergeSort}.
- * @returns {Number} Returns a negative value if <code>a</code> is less than <code>b</code>,
+ * @returns {number} Returns a negative value if <code>a</code> is less than <code>b</code>,
  *          a positive value if <code>a</code> is greater than <code>b</code>, or
  *          0 if <code>a</code> is equal to <code>b</code>.
  *

package/Source/Core/objectToQuery.js

@@ -7,8 +7,8 @@ import DeveloperError from "./DeveloperError.js";
  * will produce multiple values with the same name.
  * @function objectToQuery
  *
- * @param {Object} obj The object containing data to encode.
- * @returns {String} An encoded query string.
+ * @param {object} obj The object containing data to encode.
+ * @returns {string} An encoded query string.
  *
  *
  * @example

package/Source/Core/oneTimeWarning.js

@@ -11,8 +11,8 @@ const warnings = {};
  *
  * @function oneTimeWarning
  *
- * @param {String} identifier The unique identifier for this warning.
- * @param {String} [message=identifier] The message to log to the console.
+ * @param {string} identifier The unique identifier for this warning.
+ * @param {string} [message=identifier] The message to log to the console.
  *
  * @example
  * for(let i=0;i<foo.length;++i) {

package/Source/Core/parseResponseHeaders.js

@@ -4,9 +4,9 @@
  *
  * @function parseResponseHeaders
  *
- * @param {String} headerString The header string returned by getAllResponseHeaders().  The format is
+ * @param {string} headerString The header string returned by getAllResponseHeaders().  The format is
  *                 described here: http://www.w3.org/TR/XMLHttpRequest/#the-getallresponseheaders()-method
- * @returns {Object} A dictionary of key/value pairs, where each key is the name of a header and the corresponding value
+ * @returns {object} A dictionary of key/value pairs, where each key is the name of a header and the corresponding value
  *                   is that header's value.
  *
  * @private

package/Source/Core/pointInsideTriangle.js

@@ -13,7 +13,7 @@ const scratchBarycentricCoords = new Cartesian3();
  * @param {Cartesian2|Cartesian3} p0 The first point of the triangle.
  * @param {Cartesian2|Cartesian3} p1 The second point of the triangle.
  * @param {Cartesian2|Cartesian3} p2 The third point of the triangle.
- * @returns {Boolean} <code>true</code> if the point is inside the triangle; otherwise, <code>false</code>.
+ * @returns {boolean} <code>true</code> if the point is inside the triangle; otherwise, <code>false</code>.
  *
  * @example
  * // Returns true

package/Source/Core/queryToObject.js

@@ -7,8 +7,8 @@ import DeveloperError from "./DeveloperError.js";
  * the value in the object will be an array of values.
  * @function queryToObject
  *
- * @param {String} queryString The query string.
- * @returns {Object} An object containing the parameters parsed from the query string.
+ * @param {string} queryString The query string.
+ * @returns {object} An object containing the parameters parsed from the query string.
  *
  *
  * @example

package/Source/Core/sampleTerrain.js

@@ -1,4 +1,5 @@
 import Check from "./Check.js";
+import defined from "./defined.js";
 
 /**
  * Initiates a terrain height query for an array of {@link Cartographic} positions by
@@ -17,9 +18,9 @@ import Check from "./Check.js";
  * @function sampleTerrain
  *
  * @param {TerrainProvider} terrainProvider The terrain provider from which to query heights.
- * @param {Number} level The terrain level-of-detail from which to query terrain heights.
+ * @param {number} level The terrain level-of-detail from which to query terrain heights.
  * @param {Cartographic[]} positions The positions to update with terrain heights.
- * @returns {Promise.<Cartographic[]>} A promise that resolves to the provided list of positions when terrain the query has completed.
+ * @returns {Promise<Cartographic[]>} A promise that resolves to the provided list of positions when terrain the query has completed.
  *
  * @see sampleTerrainMostDetailed
  *
@@ -49,8 +50,8 @@ function sampleTerrain(terrainProvider, level, positions) {
 }
 
 /**
- * @param {Array.<Object>} tileRequests The mutated list of requests, the first one will be attempted
- * @param {Array.<Promise<void>>} results The list to put the result promises into
+ * @param {object[]} tileRequests The mutated list of requests, the first one will be attempted
+ * @param {Array<Promise<void>>} results The list to put the result promises into
  * @returns {boolean} true if the request was made, and we are okay to attempt the next item immediately,
  *  or false if we were throttled and should wait awhile before retrying.
  *
@@ -96,8 +97,8 @@ function delay(ms) {
 /**
  * Recursively consumes all the tileRequests until the list has been emptied
  *  and a Promise of each result has been put into the results list
- * @param {Array.<Object>} tileRequests The list of requests desired to be made
- * @param {Array.<Promise<void>>} results The list to put all the result promises into
+ * @param {object[]} tileRequests The list of requests desired to be made
+ * @param {Array<Promise<void>>} results The list to put all the result promises into
  * @returns {Promise<void>} A promise which resolves once all requests have been started
  *
  * @private
@@ -132,6 +133,10 @@ function doSampling(terrainProvider, level, positions) {
   const tileRequestSet = {}; // A unique set
   for (i = 0; i < positions.length; ++i) {
     const xy = tilingScheme.positionToTileXY(positions[i], level);
+    if (!defined(xy)) {
+      continue;
+    }
+
     const key = xy.toString();
 
     if (!tileRequestSet.hasOwnProperty(key)) {
@@ -171,7 +176,7 @@ function doSampling(terrainProvider, level, positions) {
  * @param {Cartographic} position The position to interpolate for and assign the height value to
  * @param {TerrainData} terrainData
  * @param {Rectangle} rectangle
- * @returns {Boolean} If the height was actually interpolated and assigned
+ * @returns {boolean} If the height was actually interpolated and assigned
  * @private
  */
 function interpolateAndAssignHeight(position, terrainData, rectangle) {

package/Source/Core/sampleTerrainMostDetailed.js

@@ -12,7 +12,7 @@ const scratchCartesian2 = new Cartesian2();
  *
  * @param {TerrainProvider} terrainProvider The terrain provider from which to query heights.
  * @param {Cartographic[]} positions The positions to update with terrain heights.
- * @returns {Promise.<Cartographic[]>} A promise that resolves to the provided list of positions when terrain the query has completed.  This
+ * @returns {Promise<Cartographic[]>} A promise that resolves to the provided list of positions when terrain the query has completed.  This
  *                                     promise will reject if the terrain provider's `availability` property is undefined.
  *
  * @example

package/Source/Core/scaleToGeodeticSurface.js

@@ -14,7 +14,7 @@ const scaleToGeodeticSurfaceGradient = new Cartesian3();
  * @param {Cartesian3} cartesian The Cartesian position to scale.
  * @param {Cartesian3} oneOverRadii One over radii of the ellipsoid.
  * @param {Cartesian3} oneOverRadiiSquared One over radii squared of the ellipsoid.
- * @param {Number} centerToleranceSquared Tolerance for closeness to the center.
+ * @param {number} centerToleranceSquared Tolerance for closeness to the center.
  * @param {Cartesian3} [result] The object onto which to store the result.
  * @returns {Cartesian3} The modified result parameter, a new Cartesian3 instance if none was provided, or undefined if the position is at the center.
  *

package/Source/Core/subdivideArray.js

@@ -7,7 +7,7 @@ import DeveloperError from "./DeveloperError.js";
  * @function subdivideArray
  *
  * @param {Array} array The array to divide.
- * @param {Number} numberOfArrays The number of arrays to divide the provided array into.
+ * @param {number} numberOfArrays The number of arrays to divide the provided array into.
  *
  * @exception {DeveloperError} numberOfArrays must be greater than 0.
  */

package/Source/Core/writeTextToCanvas.js

@@ -101,17 +101,17 @@ let imageSmoothingEnabledName;
  * Writes the given text into a new canvas.  The canvas will be sized to fit the text.
  * If text is blank, returns undefined.
  *
- * @param {String} text The text to write.
- * @param {Object} [options] Object with the following properties:
- * @param {String} [options.font='10px sans-serif'] The CSS font to use.
- * @param {String} [options.textBaseline='bottom'] The baseline of the text.
- * @param {Boolean} [options.fill=true] Whether to fill the text.
- * @param {Boolean} [options.stroke=false] Whether to stroke the text.
+ * @param {string} text The text to write.
+ * @param {object} [options] Object with the following properties:
+ * @param {string} [options.font='10px sans-serif'] The CSS font to use.
+ * @param {string} [options.textBaseline='bottom'] The baseline of the text.
+ * @param {boolean} [options.fill=true] Whether to fill the text.
+ * @param {boolean} [options.stroke=false] Whether to stroke the text.
  * @param {Color} [options.fillColor=Color.WHITE] The fill color.
  * @param {Color} [options.strokeColor=Color.BLACK] The stroke color.
- * @param {Number} [options.strokeWidth=1] The stroke width.
+ * @param {number} [options.strokeWidth=1] The stroke width.
  * @param {Color} [options.backgroundColor=Color.TRANSPARENT] The background color of the canvas.
- * @param {Number} [options.padding=0] The pixel size of the padding to add around the text.
+ * @param {number} [options.padding=0] The pixel size of the padding to add around the text.
  * @returns {HTMLCanvasElement|undefined} A new canvas with the given text drawn into it.  The dimensions object
  *                   from measureText will also be added to the returned canvas. If text is
  *                   blank, returns undefined.
@@ -143,7 +143,8 @@ function writeTextToCanvas(text, options) {
   canvas.width = 1;
   canvas.height = 1;
   canvas.style.font = font;
-  const context2D = canvas.getContext("2d");
+  // Since multiple read-back operations are expected for labels, use the willReadFrequently option – See https://html.spec.whatwg.org/multipage/canvas.html#concept-canvas-will-read-frequently
+  const context2D = canvas.getContext("2d", { willReadFrequently: true });
 
   if (!defined(imageSmoothingEnabledName)) {
     if (defined(context2D.imageSmoothingEnabled)) {

package/Source/DataSources/BillboardGraphics.js

@@ -5,7 +5,7 @@ import Event from "../Core/Event.js";
 import createPropertyDescriptor from "./createPropertyDescriptor.js";
 
 /**
- * @typedef {Object} BillboardGraphics.ConstructorOptions
+ * @typedef {object} BillboardGraphics.ConstructorOptions
  *
  * Initialization options for the BillboardGraphics constructor
  *

package/Source/DataSources/BillboardVisualizer.js

@@ -75,7 +75,7 @@ function BillboardVisualizer(entityCluster, entityCollection) {
  * Entity counterpart at the given time.
  *
  * @param {JulianDate} time The time to update to.
- * @returns {Boolean} This function always returns true.
+ * @returns {boolean} This function always returns true.
  */
 BillboardVisualizer.prototype.update = function (time) {
   //>>includeStart('debug', pragmas.debug);
@@ -274,7 +274,7 @@ BillboardVisualizer.prototype.getBoundingSphere = function (entity, result) {
 /**
  * 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.
  */
 BillboardVisualizer.prototype.isDestroyed = function () {
   return false;

package/Source/DataSources/BoundingSphereState.js

@@ -1,6 +1,6 @@
 /**
  * The state of a BoundingSphere computation being performed by a {@link Visualizer}.
- * @enum {Number}
+ * @enum {number}
  * @private
  */
 const BoundingSphereState = {

package/Source/DataSources/BoxGraphics.js

@@ -6,7 +6,7 @@ import createMaterialPropertyDescriptor from "./createMaterialPropertyDescriptor
 import createPropertyDescriptor from "./createPropertyDescriptor.js";
 
 /**
- * @typedef {Object} BoxGraphics.ConstructorOptions
+ * @typedef {object} BoxGraphics.ConstructorOptions
  *
  * Initialization options for the BoxGraphics constructor
  *