@cesium/engine 24.0.0 → 26.0.0

package/Source/Scene/AlphaMode.js

@@ -1,3 +1,5 @@
+// @ts-check
+
 /**
  * The alpha rendering mode of the material.
  *
@@ -30,4 +32,6 @@ const AlphaMode = {
   BLEND: "BLEND",
 };
 
-export default Object.freeze(AlphaMode);
+Object.freeze(AlphaMode);
+
+export default AlphaMode;

package/Source/Scene/ArcGisBaseMapType.js

@@ -1,3 +1,5 @@
+// @ts-check
+
 /**
  * ArcGisBaseMapType enumerates the ArcGIS image tile layers that are supported by default.
  *
@@ -9,4 +11,7 @@ const ArcGisBaseMapType = {
   OCEANS: 2,
   HILLSHADE: 3,
 };
-export default Object.freeze(ArcGisBaseMapType);
+
+Object.freeze(ArcGisBaseMapType);
+
+export default ArcGisBaseMapType;

package/Source/Scene/ArcGisMapService.js

@@ -4,7 +4,7 @@ import Resource from "../Core/Resource.js";
 
 let defaultTokenCredit;
 const defaultAccessToken =
-  "AAPTaUFUfciXgT4YKNZew9lUqpQ..yIoArbcKGeWnsxrcf8Sk9LLcQN1dML2469i9e8v1mZyMILiwWzGR3sxU2vr8L749gvuB4ERujd1vMmNwfZTbCPPaJ1vtts4rXZ3DZEhW9L3GKH6KRRfqXy77cdjc7mg3iIVkWEg8yhReRsNIyw-nlzduhCipHDMwkkx-GmOxnsNYE-0CE2uEB9Mm8b6UppjohI1tn864yN1vLTJMP1vCRFD2b0uyE0vqzx-cE12TppkVQQ4Ry9apOVC3AT1_oO2ZY8gh";
+  "AAPTauP-rqeCeHTtrSMga9XbPxQ..ZMIZzf1tcwicoJi5E5T2mG0EO3qlIRkQNe5S-uA95RJKU0YkrwOT0AF-lSIyXXBFakDJIPaxsZ5vpnzlaW3kCYG2Tk53bY6OntMqn1EBYtDPyqz38iM4NU_bbDN3DuxUdkxYDWnxJXxxWe3bEeUANbvhKK76PU7N0wjZgtEYHYocspYXSHxbCEYo_eXrHDkrWpgkzcmQ3WpQqf2XprJ39pbqVSZbxskDh3zBm92XxUaiSmdf7rC1w3VoAT1_UarLJfAQ";
 /**
  * Default options for accessing the ArcGIS image tile service.
  *

package/Source/Scene/AttributeType.js

@@ -197,4 +197,6 @@ AttributeType.getGlslType = function (attributeType) {
   }
 };
 
-export default Object.freeze(AttributeType);
+Object.freeze(AttributeType);
+
+export default AttributeType;

package/Source/Scene/Axis.js

@@ -113,4 +113,6 @@ Axis.fromName = function (name) {
   return Axis[name];
 };
 
-export default Object.freeze(Axis);
+Object.freeze(Axis);
+
+export default Axis;

package/Source/Scene/BingMapsStyle.js

@@ -1,3 +1,5 @@
+// @ts-check
+
 /**
  * The types of imagery provided by Bing Maps.
  *
@@ -90,4 +92,7 @@ const BingMapsStyle = {
    */
   COLLINS_BART: "CollinsBart",
 };
-export default Object.freeze(BingMapsStyle);
+
+Object.freeze(BingMapsStyle);
+
+export default BingMapsStyle;

package/Source/Scene/BlendEquation.js

@@ -1,3 +1,5 @@
+// @ts-check
+
 import WebGLConstants from "../Core/WebGLConstants.js";
 
 /**
@@ -50,4 +52,7 @@ const BlendEquation = {
    */
   MAX: WebGLConstants.MAX,
 };
-export default Object.freeze(BlendEquation);
+
+Object.freeze(BlendEquation);
+
+export default BlendEquation;

package/Source/Scene/BlendFunction.js

@@ -1,3 +1,5 @@
+// @ts-check
+
 import WebGLConstants from "../Core/WebGLConstants.js";
 
 /**
@@ -126,4 +128,7 @@ const BlendFunction = {
    */
   SOURCE_ALPHA_SATURATE: WebGLConstants.SRC_ALPHA_SATURATE,
 };
-export default Object.freeze(BlendFunction);
+
+Object.freeze(BlendFunction);
+
+export default BlendFunction;

package/Source/Scene/BlendOption.js

@@ -1,3 +1,5 @@
+// @ts-check
+
 /**
  * Determines how opaque and translucent parts of billboards, points, and labels are blended with the scene.
  *
@@ -25,4 +27,7 @@ const BlendOption = {
    */
   OPAQUE_AND_TRANSLUCENT: 2,
 };
-export default Object.freeze(BlendOption);
+
+Object.freeze(BlendOption);
+
+export default BlendOption;

package/Source/Scene/BlendingState.js

@@ -1,3 +1,5 @@
+// @ts-check
+
 import BlendEquation from "./BlendEquation.js";
 import BlendFunction from "./BlendFunction.js";
 
@@ -70,4 +72,7 @@ const BlendingState = {
     functionDestinationAlpha: BlendFunction.ONE,
   }),
 };
-export default Object.freeze(BlendingState);
+
+Object.freeze(BlendingState);
+
+export default BlendingState;

package/Source/Scene/BufferLoader.js

@@ -47,7 +47,6 @@ class BufferLoader extends ResourceLoader {
   /**
    * The cache key of the resource.
    *
-   * @memberof BufferLoader.prototype
    *
    * @type {string}
    * @readonly
@@ -60,7 +59,6 @@ class BufferLoader extends ResourceLoader {
   /**
    * The typed array containing the embedded buffer contents.
    *
-   * @memberof BufferLoader.prototype
    *
    * @type {Uint8Array}
    * @readonly

package/Source/Scene/BufferPoint.js

@@ -123,6 +123,7 @@ class BufferPoint extends BufferPrimitive {
     collection._positionView[vertexOffset * 3 + 1] = position.y;
     collection._positionView[vertexOffset * 3 + 2] = position.z;
 
+    this._dirty = true;
     collection._makeDirtyBoundingVolume();
   }
 

package/Source/Scene/BufferPointCollection.js

@@ -7,14 +7,19 @@ import Frozen from "../Core/Frozen.js";
 import renderPoints from "./renderBufferPointCollection.js";
 import BufferPointMaterial from "./BufferPointMaterial.js";
 
+/** @import BlendOption from "./BlendOption.js"; */
+/** @import BoundingSphere from "../Core/BoundingSphere.js"; */
+/** @import ComponentDatatype from "../Core/ComponentDatatype.js"; */
 /** @import Matrix4 from "../Core/Matrix4.js"; */
 /** @import FrameState from "./FrameState.js"; */
 
 /**
  * @typedef {object} BufferPointOptions
- * @property {Matrix4} [options.modelMatrix=Matrix4.IDENTITY] Transforms geometry from model to world coordinates.
+ * @property {Matrix4} [modelMatrix=Matrix4.IDENTITY] Transforms geometry from model to world coordinates.
  * @property {boolean} [show=true]
  * @property {BufferPointMaterial} [material=BufferPointMaterial.DEFAULT_MATERIAL]
+ * @property {number} [featureId]
+ * @property {object} [pickObject]
  * @property {Cartesian3} [position=Cartesian3.ZERO]
  * @experimental This feature is not final and is subject to change without Cesium's standard deprecation policy.
  */
@@ -53,9 +58,18 @@ import BufferPointMaterial from "./BufferPointMaterial.js";
 class BufferPointCollection extends BufferPrimitiveCollection {
   /**
    * @param {object} options
+   * @param {Matrix4} [options.modelMatrix=Matrix4.IDENTITY] Transforms geometry from model to world coordinates.
    * @param {number} [options.primitiveCountMax=BufferPrimitiveCollection.DEFAULT_CAPACITY]
+   * @param {ComponentDatatype} [options.positionDatatype=ComponentDatatype.DOUBLE]
+   * @param {boolean} [options.positionNormalized=false]
    * @param {boolean} [options.show=true]
+   * @param {boolean} [options.allowPicking=false] When <code>true</code>, primitives are pickable with {@link Scene#pick}. When <code>false</code>, memory and initialization cost are lower.
+   * @param {BoundingSphere} [options.boundingVolume] Bounding volume, in world space, for the collection. When
+   *    unspecified, a bounding volume is computed automatically and updated when primitive positions change. When
+   *    specified, users are responsible for updating bounding volume as needed. Pre-computing the bounding volume
+   *    manually, and updating it only as needed, will improve performance for larger dynamic collections.
    * @param {boolean} [options.debugShowBoundingVolume=false]
+   * @param {BlendOption} [options.blendOption=BlendOption.TRANSLUCENT]
    */
   constructor(options = Frozen.EMPTY_OBJECT) {
     super({ ...options, vertexCountMax: options.primitiveCountMax });
@@ -85,6 +99,8 @@ class BufferPointCollection extends BufferPrimitiveCollection {
   static _cloneEmpty(collection) {
     return new BufferPointCollection({
       primitiveCountMax: collection.primitiveCountMax,
+      positionDatatype: collection.positionDatatype,
+      positionNormalized: collection.positionNormalized,
     });
   }
 

package/Source/Scene/BufferPolygon.js

@@ -180,6 +180,7 @@ class BufferPolygon extends BufferPrimitive {
       positionView[(vertexOffset + i) * 3 + 2] = positions[i * 3 + 2];
     }
 
+    this._dirty = true;
     collection._makeDirtyBoundingVolume();
   }
 
@@ -308,7 +309,7 @@ class BufferPolygon extends BufferPrimitive {
       holeIndexView[holeOffset + i] = holes[i];
     }
 
-    collection._makeDirtyBoundingVolume();
+    this._dirty = true;
   }
 
   /**
@@ -489,7 +490,7 @@ class BufferPolygon extends BufferPrimitive {
       dstIndices[(triangleOffset + i) * 3 + 2] = indices[i * 3 + 2];
     }
 
-    collection._makeDirtyBoundingVolume();
+    this._dirty = true;
   }
 
   /////////////////////////////////////////////////////////////////////////////

package/Source/Scene/BufferPolygonCollection.js

@@ -9,6 +9,8 @@ import IndexDatatype from "../Core/IndexDatatype.js";
 import renderPolygons from "./renderBufferPolygonCollection.js";
 import BufferPolygonMaterial from "./BufferPolygonMaterial.js";
 
+/** @import BlendOption from "./BlendOption.js"; */
+/** @import BoundingSphere from "../Core/BoundingSphere.js"; */
 /** @import { TypedArray } from "../Core/globalTypes.js"; */
 /** @import Matrix4 from "../Core/Matrix4.js"; */
 /** @import FrameState from "./FrameState.js" */
@@ -18,9 +20,11 @@ const { ERR_CAPACITY } = BufferPrimitiveCollection.Error;
 
 /**
  * @typedef {object} BufferPolygonOptions
- * @property {Matrix4} [options.modelMatrix=Matrix4.IDENTITY] Transforms geometry from model to world coordinates.
+ * @property {Matrix4} [modelMatrix=Matrix4.IDENTITY] Transforms geometry from model to world coordinates.
  * @property {boolean} [show=true]
  * @property {BufferPolygonMaterial} [material=BufferPolygonMaterial.DEFAULT_MATERIAL]
+ * @property {number} [featureId]
+ * @property {object} [pickObject]
  * @property {TypedArray} [positions]
  * @property {TypedArray} [holes]
  * @property {TypedArray} [triangles]
@@ -78,9 +82,15 @@ class BufferPolygonCollection extends BufferPrimitiveCollection {
    * @param {number} [options.holeCountMax=BufferPrimitiveCollection.DEFAULT_CAPACITY]
    * @param {number} [options.triangleCountMax=BufferPrimitiveCollection.DEFAULT_CAPACITY]
    * @param {ComponentDatatype} [options.positionDatatype=ComponentDatatype.DOUBLE]
+   * @param {boolean} [options.positionNormalized=false]
    * @param {boolean} [options.show=true]
    * @param {boolean} [options.allowPicking=true] When <code>true</code>, primitives are pickable with {@link Scene#pick}. When <code>false</code>, memory and initialization cost are lower.
+   * @param {BoundingSphere} [options.boundingVolume] Bounding volume, in world space, for the collection. When
+   *    unspecified, a bounding volume is computed automatically and updated when primitive positions change. When
+   *    specified, users are responsible for updating bounding volume as needed. Pre-computing the bounding volume
+   *    manually, and updating it only as needed, will improve performance for larger dynamic collections.
    * @param {boolean} [options.debugShowBoundingVolume=false]
+   * @param {BlendOption} [options.blendOption=BlendOption.TRANSLUCENT]
    */
   constructor(options = Frozen.EMPTY_OBJECT) {
     super(options);
@@ -223,6 +233,8 @@ class BufferPolygonCollection extends BufferPrimitiveCollection {
       vertexCountMax: collection.vertexCountMax,
       holeCountMax: collection.holeCountMax,
       triangleCountMax: collection.triangleCountMax,
+      positionDatatype: collection.positionDatatype,
+      positionNormalized: collection.positionNormalized,
     });
   }
 

package/Source/Scene/BufferPolyline.js

@@ -160,6 +160,7 @@ class BufferPolyline extends BufferPrimitive {
       positionView[(vertexOffset + i) * 3 + 2] = positions[i * 3 + 2];
     }
 
+    this._dirty = true;
     collection._makeDirtyBoundingVolume();
   }
 

package/Source/Scene/BufferPolylineCollection.js

@@ -12,9 +12,11 @@ import BufferPolylineMaterial from "./BufferPolylineMaterial.js";
 
 /**
  * @typedef {object} BufferPolylineOptions
- * @property {Matrix4} [options.modelMatrix=Matrix4.IDENTITY] Transforms geometry from model to world coordinates.
+ * @property {Matrix4} [modelMatrix=Matrix4.IDENTITY] Transforms geometry from model to world coordinates.
  * @property {boolean} [show=true]
  * @property {BufferPolylineMaterial} [material=BufferPolylineMaterial.DEFAULT_MATERIAL]
+ * @property {number} [featureId]
+ * @property {object} [pickObject]
  * @property {TypedArray} [positions]
  * @experimental This feature is not final and is subject to change without Cesium's standard deprecation policy.
  */
@@ -80,6 +82,8 @@ class BufferPolylineCollection extends BufferPrimitiveCollection {
     return new BufferPolylineCollection({
       primitiveCountMax: collection.primitiveCountMax,
       vertexCountMax: collection.vertexCountMax,
+      positionDatatype: collection.positionDatatype,
+      positionNormalized: collection.positionNormalized,
     });
   }