@cesium/engine 2.0.0 → 2.2.0

package/Source/Scene/OpenStreetMapImageryProvider.js

@@ -12,17 +12,17 @@ const defaultCredit = new Credit(
 );
 
 /**
- * @typedef {Object} OpenStreetMapImageryProvider.ConstructorOptions
+ * @typedef {object} OpenStreetMapImageryProvider.ConstructorOptions
  *
  * Initialization options for the OpenStreetMapImageryProvider constructor
  *
- * @property {String} [url='https://a.tile.openstreetmap.org'] The OpenStreetMap server url.
- * @property {String} [fileExtension='png'] The file extension for images on the server.
+ * @property {string} [url='https://a.tile.openstreetmap.org'] The OpenStreetMap server url.
+ * @property {string} [fileExtension='png'] The file extension for images on the server.
  * @property {Rectangle} [rectangle=Rectangle.MAX_VALUE] The rectangle of the layer.
- * @property {Number} [minimumLevel=0] The minimum level-of-detail supported by the imagery provider.
- * @property {Number} [maximumLevel] The maximum level-of-detail supported by the imagery provider, or undefined if there is no limit.
+ * @property {number} [minimumLevel=0] The minimum level-of-detail supported by the imagery provider.
+ * @property {number} [maximumLevel] The maximum level-of-detail supported by the imagery provider, or undefined if there is no limit.
  * @property {Ellipsoid} [ellipsoid] The ellipsoid.  If not specified, the WGS84 ellipsoid is used.
- * @property {Credit|String} [credit='MapQuest, Open Street Map and contributors, CC-BY-SA'] A credit for the data source, which is displayed on the canvas.
+ * @property {Credit|string} [credit='MapQuest, Open Street Map and contributors, CC-BY-SA'] A credit for the data source, which is displayed on the canvas.
  */
 
 /**

package/Source/Scene/OrderedGroundPrimitiveCollection.js

@@ -23,7 +23,7 @@ Object.defineProperties(OrderedGroundPrimitiveCollection.prototype, {
    *
    * @memberof OrderedGroundPrimitiveCollection.prototype
    *
-   * @type {Number}
+   * @type {number}
    * @readonly
    */
   length: {
@@ -37,7 +37,7 @@ Object.defineProperties(OrderedGroundPrimitiveCollection.prototype, {
  * Adds a primitive to the collection.
  *
  * @param {GroundPrimitive} primitive The primitive to add.
- * @param {Number} [zIndex = 0] The index of the primitive
+ * @param {number} [zIndex = 0] The index of the primitive
  * @returns {GroundPrimitive} The primitive added to the collection.
  */
 OrderedGroundPrimitiveCollection.prototype.add = function (primitive, zIndex) {
@@ -72,7 +72,7 @@ OrderedGroundPrimitiveCollection.prototype.add = function (primitive, zIndex) {
 /**
  * Adjusts the z-index
  * @param {GroundPrimitive} primitive
- * @param {Number} zIndex
+ * @param {number} zIndex
  */
 OrderedGroundPrimitiveCollection.prototype.set = function (primitive, zIndex) {
   //>>includeStart('debug', pragmas.debug);
@@ -93,9 +93,9 @@ OrderedGroundPrimitiveCollection.prototype.set = function (primitive, zIndex) {
 /**
  * Removes a primitive from the collection.
  *
- * @param {Object} primitive The primitive to remove.
- * @param {Boolean} [doNotDestroy = false]
- * @returns {Boolean} <code>true</code> if the primitive was removed; <code>false</code> if the primitive is <code>undefined</code> or was not found in the collection.
+ * @param {object} primitive The primitive to remove.
+ * @param {boolean} [doNotDestroy = false]
+ * @returns {boolean} <code>true</code> if the primitive was removed; <code>false</code> if the primitive is <code>undefined</code> or was not found in the collection.
  */
 OrderedGroundPrimitiveCollection.prototype.remove = function (
   primitive,
@@ -153,8 +153,8 @@ OrderedGroundPrimitiveCollection.prototype.removeAll = function () {
 /**
  * Determines if this collection contains a primitive.
  *
- * @param {Object} primitive The primitive to check for.
- * @returns {Boolean} <code>true</code> if the primitive is in the collection; <code>false</code> if the primitive is <code>undefined</code> or was not found in the collection.
+ * @param {object} primitive The primitive to check for.
+ * @returns {boolean} <code>true</code> if the primitive is in the collection; <code>false</code> if the primitive is <code>undefined</code> or was not found in the collection.
  */
 OrderedGroundPrimitiveCollection.prototype.contains = function (primitive) {
   if (!defined(primitive)) {
@@ -184,7 +184,7 @@ OrderedGroundPrimitiveCollection.prototype.update = function (frameState) {
  * If this object was destroyed, it should not be used; calling any function other than
  * <code>isDestroyed</code> will result in a {@link DeveloperError} exception.
  *
- * @returns {Boolean} True if this object was destroyed; otherwise, false.
+ * @returns {boolean} True if this object was destroyed; otherwise, false.
  *
  * @see OrderedGroundPrimitiveCollection#destroy
  */

package/Source/Scene/Particle.js

@@ -12,16 +12,16 @@ const defaultSize = new Cartesian2(1.0, 1.0);
  * @alias Particle
  * @constructor
  *
- * @param {Object} options An object with the following properties:
- * @param {Number} [options.mass=1.0] The mass of the particle in kilograms.
+ * @param {object} options An object with the following properties:
+ * @param {number} [options.mass=1.0] The mass of the particle in kilograms.
  * @param {Cartesian3} [options.position=Cartesian3.ZERO] The initial position of the particle in world coordinates.
  * @param {Cartesian3} [options.velocity=Cartesian3.ZERO] The velocity vector of the particle in world coordinates.
- * @param {Number} [options.life=Number.MAX_VALUE] The life of the particle in seconds.
- * @param {Object} [options.image] The URI, HTMLImageElement, or HTMLCanvasElement to use for the billboard.
+ * @param {number} [options.life=Number.MAX_VALUE] The life of the particle in seconds.
+ * @param {object} [options.image] The URI, HTMLImageElement, or HTMLCanvasElement to use for the billboard.
  * @param {Color} [options.startColor=Color.WHITE] The color of a particle when it is born.
  * @param {Color} [options.endColor=Color.WHITE] The color of a particle when it dies.
- * @param {Number} [options.startScale=1.0] The scale of the particle when it is born.
- * @param {Number} [options.endScale=1.0] The scale of the particle when it dies.
+ * @param {number} [options.startScale=1.0] The scale of the particle when it is born.
+ * @param {number} [options.endScale=1.0] The scale of the particle when it dies.
  * @param {Cartesian2} [options.imageSize=new Cartesian2(1.0, 1.0)] The dimensions, width by height, to scale the particle image in pixels.
  */
 function Particle(options) {
@@ -29,7 +29,7 @@ function Particle(options) {
 
   /**
    * The mass of the particle in kilograms.
-   * @type {Number}
+   * @type {number}
    * @default 1.0
    */
   this.mass = defaultValue(options.mass, 1.0);
@@ -51,13 +51,13 @@ function Particle(options) {
   );
   /**
    * The life of the particle in seconds.
-   * @type {Number}
+   * @type {number}
    * @default Number.MAX_VALUE
    */
   this.life = defaultValue(options.life, Number.MAX_VALUE);
   /**
    * The image to use for the particle.
-   * @type {Object}
+   * @type {object}
    * @default undefined
    */
   this.image = options.image;
@@ -75,13 +75,13 @@ function Particle(options) {
   this.endColor = Color.clone(defaultValue(options.endColor, Color.WHITE));
   /**
    * the scale of the particle when it is born.
-   * @type {Number}
+   * @type {number}
    * @default 1.0
    */
   this.startScale = defaultValue(options.startScale, 1.0);
   /**
    * The scale of the particle when it dies.
-   * @type {Number}
+   * @type {number}
    * @default 1.0
    */
   this.endScale = defaultValue(options.endScale, 1.0);
@@ -105,7 +105,7 @@ Object.defineProperties(Particle.prototype, {
   /**
    * Gets the age of the particle in seconds.
    * @memberof Particle.prototype
-   * @type {Number}
+   * @type {number}
    */
   age: {
     get: function () {
@@ -115,7 +115,7 @@ Object.defineProperties(Particle.prototype, {
   /**
    * Gets the age normalized to a value in the range [0.0, 1.0].
    * @memberof Particle.prototype
-   * @type {Number}
+   * @type {number}
    */
   normalizedAge: {
     get: function () {

package/Source/Scene/ParticleBurst.js

@@ -6,29 +6,29 @@ import defaultValue from "../Core/defaultValue.js";
  * @alias ParticleBurst
  * @constructor
  *
- * @param {Object} [options] An object with the following properties:
- * @param {Number} [options.time=0.0] The time in seconds after the beginning of the particle system's lifetime that the burst will occur.
- * @param {Number} [options.minimum=0.0] The minimum number of particles emmitted in the burst.
- * @param {Number} [options.maximum=50.0] The maximum number of particles emitted in the burst.
+ * @param {object} [options] An object with the following properties:
+ * @param {number} [options.time=0.0] The time in seconds after the beginning of the particle system's lifetime that the burst will occur.
+ * @param {number} [options.minimum=0.0] The minimum number of particles emmitted in the burst.
+ * @param {number} [options.maximum=50.0] The maximum number of particles emitted in the burst.
  */
 function ParticleBurst(options) {
   options = defaultValue(options, defaultValue.EMPTY_OBJECT);
 
   /**
    * The time in seconds after the beginning of the particle system's lifetime that the burst will occur.
-   * @type {Number}
+   * @type {number}
    * @default 0.0
    */
   this.time = defaultValue(options.time, 0.0);
   /**
    * The minimum number of particles emitted.
-   * @type {Number}
+   * @type {number}
    * @default 0.0
    */
   this.minimum = defaultValue(options.minimum, 0.0);
   /**
    * The maximum number of particles emitted.
-   * @type {Number}
+   * @type {number}
    * @default 50.0
    */
   this.maximum = defaultValue(options.maximum, 50.0);
@@ -40,7 +40,7 @@ Object.defineProperties(ParticleBurst.prototype, {
   /**
    * <code>true</code> if the burst has been completed; <code>false</code> otherwise.
    * @memberof ParticleBurst.prototype
-   * @type {Boolean}
+   * @type {boolean}
    */
   complete: {
     get: function () {

package/Source/Scene/ParticleSystem.js

@@ -21,36 +21,36 @@ const defaultImageSize = new Cartesian2(1.0, 1.0);
  * @alias ParticleSystem
  * @constructor
  *
- * @param {Object} [options] Object with the following properties:
- * @param {Boolean} [options.show=true] Whether to display the particle system.
+ * @param {object} [options] Object with the following properties:
+ * @param {boolean} [options.show=true] Whether to display the particle system.
  * @param {ParticleSystem.updateCallback} [options.updateCallback] The callback function to be called each frame to update a particle.
  * @param {ParticleEmitter} [options.emitter=new CircleEmitter(0.5)] The particle emitter for this system.
  * @param {Matrix4} [options.modelMatrix=Matrix4.IDENTITY] The 4x4 transformation matrix that transforms the particle system from model to world coordinates.
  * @param {Matrix4} [options.emitterModelMatrix=Matrix4.IDENTITY] The 4x4 transformation matrix that transforms the particle system emitter within the particle systems local coordinate system.
- * @param {Number} [options.emissionRate=5] The number of particles to emit per second.
+ * @param {number} [options.emissionRate=5] The number of particles to emit per second.
  * @param {ParticleBurst[]} [options.bursts] An array of {@link ParticleBurst}, emitting bursts of particles at periodic times.
- * @param {Boolean} [options.loop=true] Whether the particle system should loop its bursts when it is complete.
- * @param {Number} [options.scale=1.0] Sets the scale to apply to the image of the particle for the duration of its particleLife.
- * @param {Number} [options.startScale] The initial scale to apply to the image of the particle at the beginning of its life.
- * @param {Number} [options.endScale] The final scale to apply to the image of the particle at the end of its life.
+ * @param {boolean} [options.loop=true] Whether the particle system should loop its bursts when it is complete.
+ * @param {number} [options.scale=1.0] Sets the scale to apply to the image of the particle for the duration of its particleLife.
+ * @param {number} [options.startScale] The initial scale to apply to the image of the particle at the beginning of its life.
+ * @param {number} [options.endScale] The final scale to apply to the image of the particle at the end of its life.
  * @param {Color} [options.color=Color.WHITE] Sets the color of a particle for the duration of its particleLife.
  * @param {Color} [options.startColor] The color of the particle at the beginning of its life.
  * @param {Color} [options.endColor] The color of the particle at the end of its life.
- * @param {Object} [options.image] The URI, HTMLImageElement, or HTMLCanvasElement to use for the billboard.
+ * @param {object} [options.image] The URI, HTMLImageElement, or HTMLCanvasElement to use for the billboard.
  * @param {Cartesian2} [options.imageSize=new Cartesian2(1.0, 1.0)] If set, overrides the minimumImageSize and maximumImageSize inputs that scale the particle image's dimensions in pixels.
  * @param {Cartesian2} [options.minimumImageSize] Sets the minimum bound, width by height, above which to randomly scale the particle image's dimensions in pixels.
  * @param {Cartesian2} [options.maximumImageSize] Sets the maximum bound, width by height, below which to randomly scale the particle image's dimensions in pixels.
- * @param {Boolean} [options.sizeInMeters] Sets if the size of particles is in meters or pixels. <code>true</code> to size the particles in meters; otherwise, the size is in pixels.
- * @param {Number} [options.speed=1.0] If set, overrides the minimumSpeed and maximumSpeed inputs with this value.
- * @param {Number} [options.minimumSpeed] Sets the minimum bound in meters per second above which a particle's actual speed will be randomly chosen.
- * @param {Number} [options.maximumSpeed] Sets the maximum bound in meters per second below which a particle's actual speed will be randomly chosen.
- * @param {Number} [options.lifetime=Number.MAX_VALUE] How long the particle system will emit particles, in seconds.
- * @param {Number} [options.particleLife=5.0] If set, overrides the minimumParticleLife and maximumParticleLife inputs with this value.
- * @param {Number} [options.minimumParticleLife] Sets the minimum bound in seconds for the possible duration of a particle's life above which a particle's actual life will be randomly chosen.
- * @param {Number} [options.maximumParticleLife] Sets the maximum bound in seconds for the possible duration of a particle's life below which a particle's actual life will be randomly chosen.
- * @param {Number} [options.mass=1.0] Sets the minimum and maximum mass of particles in kilograms.
- * @param {Number} [options.minimumMass] Sets the minimum bound for the mass of a particle in kilograms. A particle's actual mass will be chosen as a random amount above this value.
- * @param {Number} [options.maximumMass] Sets the maximum mass of particles in kilograms. A particle's actual mass will be chosen as a random amount below this value.
+ * @param {boolean} [options.sizeInMeters] Sets if the size of particles is in meters or pixels. <code>true</code> to size the particles in meters; otherwise, the size is in pixels.
+ * @param {number} [options.speed=1.0] If set, overrides the minimumSpeed and maximumSpeed inputs with this value.
+ * @param {number} [options.minimumSpeed] Sets the minimum bound in meters per second above which a particle's actual speed will be randomly chosen.
+ * @param {number} [options.maximumSpeed] Sets the maximum bound in meters per second below which a particle's actual speed will be randomly chosen.
+ * @param {number} [options.lifetime=Number.MAX_VALUE] How long the particle system will emit particles, in seconds.
+ * @param {number} [options.particleLife=5.0] If set, overrides the minimumParticleLife and maximumParticleLife inputs with this value.
+ * @param {number} [options.minimumParticleLife] Sets the minimum bound in seconds for the possible duration of a particle's life above which a particle's actual life will be randomly chosen.
+ * @param {number} [options.maximumParticleLife] Sets the maximum bound in seconds for the possible duration of a particle's life below which a particle's actual life will be randomly chosen.
+ * @param {number} [options.mass=1.0] Sets the minimum and maximum mass of particles in kilograms.
+ * @param {number} [options.minimumMass] Sets the minimum bound for the mass of a particle in kilograms. A particle's actual mass will be chosen as a random amount above this value.
+ * @param {number} [options.maximumMass] Sets the maximum mass of particles in kilograms. A particle's actual mass will be chosen as a random amount below this value.
  * @demo {@link https://cesium.com/learn/cesiumjs-learn/cesiumjs-particle-systems/|Particle Systems Tutorial}
  * @demo {@link https://sandcastle.cesium.com/?src=Particle%20System.html&label=Showcases|Particle Systems Tutorial Demo}
  * @demo {@link https://sandcastle.cesium.com/?src=Particle%20System%20Fireworks.html&label=Showcases|Particle Systems Fireworks Demo}
@@ -60,7 +60,7 @@ function ParticleSystem(options) {
 
   /**
    * Whether to display the particle system.
-   * @type {Boolean}
+   * @type {boolean}
    * @default true
    */
   this.show = defaultValue(options.show, true);
@@ -74,14 +74,14 @@ function ParticleSystem(options) {
 
   /**
    * Whether the particle system should loop it's bursts when it is complete.
-   * @type {Boolean}
+   * @type {boolean}
    * @default true
    */
   this.loop = defaultValue(options.loop, true);
 
   /**
    * The URI, HTMLImageElement, or HTMLCanvasElement to use for the billboard.
-   * @type {Object}
+   * @type {object}
    * @default undefined
    */
   this.image = defaultValue(options.image, undefined);
@@ -290,7 +290,7 @@ Object.defineProperties(ParticleSystem.prototype, {
   /**
    * The initial scale to apply to the image of the particle at the beginning of its life.
    * @memberof ParticleSystem.prototype
-   * @type {Number}
+   * @type {number}
    * @default 1.0
    */
   startScale: {
@@ -307,7 +307,7 @@ Object.defineProperties(ParticleSystem.prototype, {
   /**
    * The final scale to apply to the image of the particle at the end of its life.
    * @memberof ParticleSystem.prototype
-   * @type {Number}
+   * @type {number}
    * @default 1.0
    */
   endScale: {
@@ -324,7 +324,7 @@ Object.defineProperties(ParticleSystem.prototype, {
   /**
    * The number of particles to emit per second.
    * @memberof ParticleSystem.prototype
-   * @type {Number}
+   * @type {number}
    * @default 5
    */
   emissionRate: {
@@ -342,7 +342,7 @@ Object.defineProperties(ParticleSystem.prototype, {
   /**
    * Sets the minimum bound in meters per second above which a particle's actual speed will be randomly chosen.
    * @memberof ParticleSystem.prototype
-   * @type {Number}
+   * @type {number}
    * @default 1.0
    */
   minimumSpeed: {
@@ -359,7 +359,7 @@ Object.defineProperties(ParticleSystem.prototype, {
   /**
    * Sets the maximum bound in meters per second below which a particle's actual speed will be randomly chosen.
    * @memberof ParticleSystem.prototype
-   * @type {Number}
+   * @type {number}
    * @default 1.0
    */
   maximumSpeed: {
@@ -376,7 +376,7 @@ Object.defineProperties(ParticleSystem.prototype, {
   /**
    * Sets the minimum bound in seconds for the possible duration of a particle's life above which a particle's actual life will be randomly chosen.
    * @memberof ParticleSystem.prototype
-   * @type {Number}
+   * @type {number}
    * @default 5.0
    */
   minimumParticleLife: {
@@ -393,7 +393,7 @@ Object.defineProperties(ParticleSystem.prototype, {
   /**
    * Sets the maximum bound in seconds for the possible duration of a particle's life below which a particle's actual life will be randomly chosen.
    * @memberof ParticleSystem.prototype
-   * @type {Number}
+   * @type {number}
    * @default 5.0
    */
   maximumParticleLife: {
@@ -411,7 +411,7 @@ Object.defineProperties(ParticleSystem.prototype, {
   /**
    * Sets the minimum mass of particles in kilograms.
    * @memberof ParticleSystem.prototype
-   * @type {Number}
+   * @type {number}
    * @default 1.0
    */
   minimumMass: {
@@ -428,7 +428,7 @@ Object.defineProperties(ParticleSystem.prototype, {
   /**
    * Sets the maximum mass of particles in kilograms.
    * @memberof ParticleSystem.prototype
-   * @type {Number}
+   * @type {number}
    * @default 1.0
    */
   maximumMass: {
@@ -483,7 +483,7 @@ Object.defineProperties(ParticleSystem.prototype, {
   /**
    * Gets or sets if the particle size is in meters or pixels. <code>true</code> to size particles in meters; otherwise, the size is in pixels.
    * @memberof ParticleSystem.prototype
-   * @type {Boolean}
+   * @type {boolean}
    * @default false
    */
   sizeInMeters: {
@@ -500,7 +500,7 @@ Object.defineProperties(ParticleSystem.prototype, {
   /**
    * How long the particle system will emit particles, in seconds.
    * @memberof ParticleSystem.prototype
-   * @type {Number}
+   * @type {number}
    * @default Number.MAX_VALUE
    */
   lifetime: {
@@ -527,7 +527,7 @@ Object.defineProperties(ParticleSystem.prototype, {
   /**
    * When <code>true</code>, the particle system has reached the end of its lifetime; <code>false</code> otherwise.
    * @memberof ParticleSystem.prototype
-   * @type {Boolean}
+   * @type {boolean}
    */
   isComplete: {
     get: function () {
@@ -564,6 +564,11 @@ function updateParticlePool(system) {
     const particle = new Particle();
     particle._billboard = billboardCollection.add({
       image: image,
+      // Make the newly added billboards invisible when updating the particle pool
+      // to prevent the billboards from being displayed when the particles
+      // are not created. The billboard will always be set visible in
+      // updateBillboard function when its corresponding particle update.
+      show: false,
     });
     particlePool.push(particle);
   }
@@ -864,7 +869,7 @@ ParticleSystem.prototype.update = function (frameState) {
  * If this object was destroyed, it should not be used; calling any function other than
  * <code>isDestroyed</code> will result in a {@link DeveloperError} exception.
  *
- * @returns {Boolean} <code>true</code> if this object was destroyed; otherwise, <code>false</code>.
+ * @returns {boolean} <code>true</code> if this object was destroyed; otherwise, <code>false</code>.
  *
  * @see ParticleSystem#destroy
  */
@@ -897,7 +902,7 @@ ParticleSystem.prototype.destroy = function () {
  * @callback ParticleSystem.updateCallback
  *
  * @param {Particle} particle The particle being updated.
- * @param {Number} dt The time in seconds since the last update.
+ * @param {number} dt The time in seconds since the last update.
  *
  * @example
  * function applyGravity(particle, dt) {

package/Source/Scene/PerInstanceColorAppearance.js

@@ -14,14 +14,14 @@ import Appearance from "./Appearance.js";
  * @alias PerInstanceColorAppearance
  * @constructor
  *
- * @param {Object} [options] Object with the following properties:
- * @param {Boolean} [options.flat=false] When <code>true</code>, flat shading is used in the fragment shader, which means lighting is not taking into account.
- * @param {Boolean} [options.faceForward=!options.closed] When <code>true</code>, the fragment shader flips the surface normal as needed to ensure that the normal faces the viewer to avoid dark spots.  This is useful when both sides of a geometry should be shaded like {@link WallGeometry}.
- * @param {Boolean} [options.translucent=true] When <code>true</code>, the geometry is expected to appear translucent so {@link PerInstanceColorAppearance#renderState} has alpha blending enabled.
- * @param {Boolean} [options.closed=false] When <code>true</code>, the geometry is expected to be closed so {@link PerInstanceColorAppearance#renderState} has backface culling enabled.
- * @param {String} [options.vertexShaderSource] Optional GLSL vertex shader source to override the default vertex shader.
- * @param {String} [options.fragmentShaderSource] Optional GLSL fragment shader source to override the default fragment shader.
- * @param {Object} [options.renderState] Optional render state to override the default render state.
+ * @param {object} [options] Object with the following properties:
+ * @param {boolean} [options.flat=false] When <code>true</code>, flat shading is used in the fragment shader, which means lighting is not taking into account.
+ * @param {boolean} [options.faceForward=!options.closed] When <code>true</code>, the fragment shader flips the surface normal as needed to ensure that the normal faces the viewer to avoid dark spots.  This is useful when both sides of a geometry should be shaded like {@link WallGeometry}.
+ * @param {boolean} [options.translucent=true] When <code>true</code>, the geometry is expected to appear translucent so {@link PerInstanceColorAppearance#renderState} has alpha blending enabled.
+ * @param {boolean} [options.closed=false] When <code>true</code>, the geometry is expected to be closed so {@link PerInstanceColorAppearance#renderState} has backface culling enabled.
+ * @param {string} [options.vertexShaderSource] Optional GLSL vertex shader source to override the default vertex shader.
+ * @param {string} [options.fragmentShaderSource] Optional GLSL fragment shader source to override the default fragment shader.
+ * @param {object} [options.renderState] Optional render state to override the default render state.
  *
  * @example
  * // A solid white line segment
@@ -97,7 +97,7 @@ function PerInstanceColorAppearance(options) {
    * When <code>true</code>, the geometry is expected to appear translucent so
    * {@link PerInstanceColorAppearance#renderState} has alpha blending enabled.
    *
-   * @type {Boolean}
+   * @type {boolean}
    *
    * @default true
    */
@@ -125,7 +125,7 @@ Object.defineProperties(PerInstanceColorAppearance.prototype, {
    *
    * @memberof PerInstanceColorAppearance.prototype
    *
-   * @type {String}
+   * @type {string}
    * @readonly
    */
   vertexShaderSource: {
@@ -139,7 +139,7 @@ Object.defineProperties(PerInstanceColorAppearance.prototype, {
    *
    * @memberof PerInstanceColorAppearance.prototype
    *
-   * @type {String}
+   * @type {string}
    * @readonly
    */
   fragmentShaderSource: {
@@ -158,7 +158,7 @@ Object.defineProperties(PerInstanceColorAppearance.prototype, {
    *
    * @memberof PerInstanceColorAppearance.prototype
    *
-   * @type {Object}
+   * @type {object}
    * @readonly
    */
   renderState: {
@@ -174,7 +174,7 @@ Object.defineProperties(PerInstanceColorAppearance.prototype, {
    *
    * @memberof PerInstanceColorAppearance.prototype
    *
-   * @type {Boolean}
+   * @type {boolean}
    * @readonly
    *
    * @default false
@@ -207,7 +207,7 @@ Object.defineProperties(PerInstanceColorAppearance.prototype, {
    *
    * @memberof PerInstanceColorAppearance.prototype
    *
-   * @type {Boolean}
+   * @type {boolean}
    * @readonly
    *
    * @default false
@@ -226,7 +226,7 @@ Object.defineProperties(PerInstanceColorAppearance.prototype, {
    *
    * @memberof PerInstanceColorAppearance.prototype
    *
-   * @type {Boolean}
+   * @type {boolean}
    * @readonly
    *
    * @default true
@@ -267,7 +267,7 @@ PerInstanceColorAppearance.FLAT_VERTEX_FORMAT = VertexFormat.POSITION_ONLY;
  *
  * @function
  *
- * @returns {String} The full GLSL fragment shader source.
+ * @returns {string} The full GLSL fragment shader source.
  */
 PerInstanceColorAppearance.prototype.getFragmentShaderSource =
   Appearance.prototype.getFragmentShaderSource;
@@ -277,7 +277,7 @@ PerInstanceColorAppearance.prototype.getFragmentShaderSource =
  *
  * @function
  *
- * @returns {Boolean} <code>true</code> if the appearance is translucent.
+ * @returns {boolean} <code>true</code> if the appearance is translucent.
  */
 PerInstanceColorAppearance.prototype.isTranslucent =
   Appearance.prototype.isTranslucent;
@@ -289,7 +289,7 @@ PerInstanceColorAppearance.prototype.isTranslucent =
  *
  * @function
  *
- * @returns {Object} The render state.
+ * @returns {object} The render state.
  */
 PerInstanceColorAppearance.prototype.getRenderState =
   Appearance.prototype.getRenderState;

package/Source/Scene/PerformanceDisplay.js

@@ -52,7 +52,7 @@ Object.defineProperties(PerformanceDisplay.prototype, {
    * The display should indicate the FPS is being throttled.
    * @memberof PerformanceDisplay.prototype
    *
-   * @type {Boolean}
+   * @type {boolean}
    */
   throttled: {
     get: function () {
@@ -78,7 +78,7 @@ Object.defineProperties(PerformanceDisplay.prototype, {
  * Update the display.  This function should only be called once per frame, because
  * each call records a frame in the internal buffer and redraws the display.
  *
- * @param {Boolean} [renderedThisFrame=true] If provided, the FPS count will only update and display if true.
+ * @param {boolean} [renderedThisFrame=true] If provided, the FPS count will only update and display if true.
  */
 PerformanceDisplay.prototype.update = function (renderedThisFrame) {
   const time = getTimestamp();

package/Source/Scene/PntsParser.js

@@ -28,7 +28,7 @@ const sizeOfUint32 = Uint32Array.BYTES_PER_ELEMENT;
  *
  * @param {*} arrayBuffer The array buffer containing the pnts
  * @param {*} [byteOffset=0] The byte offset of the beginning of the pnts in the array buffer
- * @returns {Object} An object containing a parsed representation of the point cloud
+ * @returns {object} An object containing a parsed representation of the point cloud
  */
 PntsParser.parse = function (arrayBuffer, byteOffset) {
   byteOffset = defaultValue(byteOffset, 0);

package/Source/Scene/PointCloud.js

@@ -156,9 +156,8 @@ function PointCloud(options) {
   );
   this._splittingEnabled = false;
 
-  this._resolveReadyPromise = undefined;
-  this._rejectReadyPromise = undefined;
-  this._readyPromise = initialize(this, options);
+  this._error = undefined;
+  initialize(this, options);
 }
 
 Object.defineProperties(PointCloud.prototype, {
@@ -180,12 +179,6 @@ Object.defineProperties(PointCloud.prototype, {
     },
   },
 
-  readyPromise: {
-    get: function () {
-      return this._readyPromise;
-    },
-  },
-
   color: {
     get: function () {
       return Color.clone(this._highlightColor);
@@ -283,14 +276,6 @@ function initialize(pointCloud, options) {
   }
 
   pointCloud._pointsLength = parsedContent.pointsLength;
-
-  return new Promise(function (resolve, reject) {
-    pointCloud._resolveReadyPromise = function () {
-      pointCloud._ready = true;
-      resolve(pointCloud);
-    };
-    pointCloud._rejectReadyPromise = reject;
-  });
 }
 
 const scratchMin = new Cartesian3();
@@ -1280,7 +1265,7 @@ function decodeDraco(pointCloud, context) {
         })
         .catch(function (error) {
           pointCloud._decodingState = DecodingState.FAILED;
-          pointCloud._rejectReadyPromise(error);
+          pointCloud._error = error;
         });
     }
   }
@@ -1292,6 +1277,13 @@ const scratchScale = new Cartesian3();
 
 PointCloud.prototype.update = function (frameState) {
   const context = frameState.context;
+
+  if (defined(this._error)) {
+    const error = this._error;
+    this._error = undefined;
+    throw error;
+  }
+
   const decoding = decodeDraco(this, context);
   if (decoding) {
     return;
@@ -1309,7 +1301,7 @@ PointCloud.prototype.update = function (frameState) {
     createResources(this, frameState);
     modelMatrixDirty = true;
     shadersDirty = true;
-    this._resolveReadyPromise();
+    this._ready = true;
     this._parsedContent = undefined; // Unload
   }
 

package/Source/Scene/PointCloudEyeDomeLighting.js

@@ -254,7 +254,7 @@ PointCloudEyeDomeLighting.prototype.update = function (
  * If this object was destroyed, it should not be used; calling any function other than
  * <code>isDestroyed</code> will result in a {@link DeveloperError} exception.
  *
- * @returns {Boolean} <code>true</code> if this object was destroyed; otherwise, <code>false</code>.
+ * @returns {boolean} <code>true</code> if this object was destroyed; otherwise, <code>false</code>.
  *
  * @see PointCloudEyeDomeLighting#destroy
  */