@cesium/engine 24.0.0 → 25.0.0

package/Source/Scene/GltfBufferViewLoader.js

@@ -92,7 +92,6 @@ class GltfBufferViewLoader extends ResourceLoader {
   /**
    * The cache key of the resource.
    *
-   * @memberof GltfBufferViewLoader.prototype
    *
    * @type {string}
    * @readonly
@@ -105,7 +104,6 @@ class GltfBufferViewLoader extends ResourceLoader {
   /**
    * The typed array containing buffer view data.
    *
-   * @memberof GltfBufferViewLoader.prototype
    *
    * @type {Uint8Array}
    * @readonly

package/Source/Scene/GltfDracoLoader.js

@@ -66,7 +66,6 @@ class GltfDracoLoader extends ResourceLoader {
   /**
    * The cache key of the resource.
    *
-   * @memberof GltfDracoLoader.prototype
    *
    * @type {string}
    * @readonly
@@ -79,7 +78,6 @@ class GltfDracoLoader extends ResourceLoader {
   /**
    * The decoded data.
    *
-   * @memberof GltfDracoLoader.prototype
    *
    * @type {object}
    * @readonly

package/Source/Scene/GltfImageLoader.js

@@ -65,7 +65,6 @@ class GltfImageLoader extends ResourceLoader {
   /**
    * The cache key of the resource.
    *
-   * @memberof GltfImageLoader.prototype
    *
    * @type {string}
    * @readonly
@@ -78,7 +77,6 @@ class GltfImageLoader extends ResourceLoader {
   /**
    * The image.
    *
-   * @memberof GltfImageLoader.prototype
    *
    * @type {Image|ImageBitmap|CompressedTextureBuffer}
    * @readonly
@@ -91,7 +89,6 @@ class GltfImageLoader extends ResourceLoader {
   /**
    * The mip levels. Only defined for KTX2 files containing mip levels.
    *
-   * @memberof GltfImageLoader.prototype
    *
    * @type {Uint8Array[]}
    * @readonly

package/Source/Scene/GltfIndexBufferLoader.js

@@ -88,7 +88,6 @@ class GltfIndexBufferLoader extends ResourceLoader {
   /**
    * The cache key of the resource.
    *
-   * @memberof GltfIndexBufferLoader.prototype
    *
    * @type {string}
    * @readonly
@@ -101,7 +100,6 @@ class GltfIndexBufferLoader extends ResourceLoader {
   /**
    * The index buffer. This is only defined when <code>loadBuffer</code> is true.
    *
-   * @memberof GltfIndexBufferLoader.prototype
    *
    * @type {Buffer}
    * @readonly
@@ -114,7 +112,6 @@ class GltfIndexBufferLoader extends ResourceLoader {
   /**
    * The typed array containing indices. This is only defined when <code>loadTypedArray</code> is true.
    *
-   * @memberof GltfIndexBufferLoader.prototype
    *
    * @type {Uint8Array|Uint16Array|Uint32Array}
    * @readonly
@@ -127,7 +124,6 @@ class GltfIndexBufferLoader extends ResourceLoader {
   /**
    * The index datatype after decode.
    *
-   * @memberof GltfIndexBufferLoader.prototype
    *
    * @type {IndexDatatype}
    * @readonly

package/Source/Scene/GltfJsonLoader.js

@@ -67,7 +67,6 @@ class GltfJsonLoader extends ResourceLoader {
   /**
    * The cache key of the resource.
    *
-   * @memberof GltfJsonLoader.prototype
    *
    * @type {string}
    * @readonly
@@ -80,7 +79,6 @@ class GltfJsonLoader extends ResourceLoader {
   /**
    * The glTF JSON.
    *
-   * @memberof GltfJsonLoader.prototype
    *
    * @type {object}
    * @readonly

package/Source/Scene/GltfLoader.js

@@ -287,7 +287,6 @@ class GltfLoader extends ResourceLoader {
   /**
    * The cache key of the resource.
    *
-   * @memberof GltfLoader.prototype
    *
    * @type {string}
    * @readonly
@@ -300,7 +299,6 @@ class GltfLoader extends ResourceLoader {
   /**
    * The loaded components.
    *
-   * @memberof GltfLoader.prototype
    *
    * @type {ModelComponents.Components}
    * @readonly
@@ -313,7 +311,6 @@ class GltfLoader extends ResourceLoader {
   /**
    * The loaded glTF json.
    *
-   * @memberof GltfLoader.prototype
    *
    * @type {object}
    * @readonly
@@ -329,7 +326,6 @@ class GltfLoader extends ResourceLoader {
   /**
    * Returns true if textures are loaded separately from the other glTF resources.
    *
-   * @memberof GltfLoader.prototype
    *
    * @type {boolean}
    * @readonly
@@ -342,7 +338,6 @@ class GltfLoader extends ResourceLoader {
   /**
    * true if textures are loaded, useful when incrementallyLoadTextures is true
    *
-   * @memberof GltfLoader.prototype
    *
    * @type {boolean}
    * @readonly

package/Source/Scene/GltfLoaderUtil.js

@@ -178,6 +178,20 @@ GltfLoaderUtil.createModelTextureReader = function (options) {
   modelTextureReader.transform = transform;
   modelTextureReader.channels = channels;
 
+  // EXT_textureInfo_constant_lod extension
+  const constantLodExtension =
+    textureInfo.extensions?.EXT_textureInfo_constant_lod;
+  if (defined(constantLodExtension)) {
+    modelTextureReader.constantLod = {
+      repetitions: constantLodExtension.repetitions ?? 1.0,
+      offset: defined(constantLodExtension.offset)
+        ? Cartesian2.unpack(constantLodExtension.offset)
+        : Cartesian2.ZERO,
+      minClampDistance: constantLodExtension.minClampDistance ?? 1.0,
+      maxClampDistance: constantLodExtension.maxClampDistance ?? 4294967296.0,
+    };
+  }
+
   return modelTextureReader;
 };
 

package/Source/Scene/GltfSpzLoader.js

@@ -141,7 +141,6 @@ class GltfSpzLoader extends ResourceLoader {
 
   /**
    * The cache key of the resource.
-   * @memberof GltfSpzLoader.prototype
    * @type {string}
    * @readonly
    * @private
@@ -152,7 +151,6 @@ class GltfSpzLoader extends ResourceLoader {
 
   /**
    * The decoded SPZ data.
-   * @memberof GltfSpzLoader.prototype
    * @type {object}
    * @readonly
    * @private

package/Source/Scene/GltfStructuralMetadataLoader.js

@@ -82,7 +82,6 @@ class GltfStructuralMetadataLoader extends ResourceLoader {
   /**
    * The cache key of the resource.
    *
-   * @memberof GltfStructuralMetadataLoader.prototype
    *
    * @type {string}
    * @readonly
@@ -95,7 +94,6 @@ class GltfStructuralMetadataLoader extends ResourceLoader {
   /**
    * The parsed structural metadata
    *
-   * @memberof GltfStructuralMetadataLoader.prototype
    *
    * @type {StructuralMetadata}
    * @readonly

package/Source/Scene/GltfTextureLoader.js

@@ -83,7 +83,6 @@ class GltfTextureLoader extends ResourceLoader {
   /**
    * The cache key of the resource.
    *
-   * @memberof GltfTextureLoader.prototype
    *
    * @type {string}
    * @readonly
@@ -96,7 +95,6 @@ class GltfTextureLoader extends ResourceLoader {
   /**
    * The texture.
    *
-   * @memberof GltfTextureLoader.prototype
    *
    * @type {Texture}
    * @readonly

package/Source/Scene/GltfVertexBufferLoader.js

@@ -135,7 +135,6 @@ class GltfVertexBufferLoader extends ResourceLoader {
   /**
    * The cache key of the resource.
    *
-   * @memberof GltfVertexBufferLoader.prototype
    *
    * @type {string}
    * @readonly
@@ -148,7 +147,6 @@ class GltfVertexBufferLoader extends ResourceLoader {
   /**
    * The vertex buffer. This is only defined when <code>loadAsTypedArray</code> is false.
    *
-   * @memberof GltfVertexBufferLoader.prototype
    *
    * @type {Buffer}
    * @readonly
@@ -161,7 +159,6 @@ class GltfVertexBufferLoader extends ResourceLoader {
   /**
    * The typed array containing vertex buffer data. This is only defined when <code>loadAsTypedArray</code> is true.
    *
-   * @memberof GltfVertexBufferLoader.prototype
    *
    * @type {Uint8Array}
    * @readonly
@@ -174,7 +171,6 @@ class GltfVertexBufferLoader extends ResourceLoader {
   /**
    * Information about the quantized vertex attribute after Draco decode.
    *
-   * @memberof GltfVertexBufferLoader.prototype
    *
    * @type {ModelComponents.Quantization}
    * @readonly

package/Source/Scene/HeightReference.js

@@ -1,3 +1,5 @@
+// @ts-check
+
 /**
  * Represents the position relative to the terrain.
  *
@@ -54,7 +56,9 @@ const HeightReference = {
   RELATIVE_TO_3D_TILE: 6,
 };
 
-export default Object.freeze(HeightReference);
+Object.freeze(HeightReference);
+
+export default HeightReference;
 
 /**
  * Returns true if the height should be clamped to the surface

package/Source/Scene/HorizontalOrigin.js

@@ -1,3 +1,5 @@
+// @ts-check
+
 /**
  * The horizontal location of an origin relative to an object, e.g., a {@link Billboard}
  * or {@link Label}.  For example, setting the horizontal origin to <code>LEFT</code>
@@ -38,4 +40,7 @@ const HorizontalOrigin = {
    */
   RIGHT: -1,
 };
-export default Object.freeze(HorizontalOrigin);
+
+Object.freeze(HorizontalOrigin);
+
+export default HorizontalOrigin;

package/Source/Scene/ImageryProvider.js

@@ -5,7 +5,7 @@ import loadKTX2 from "../Core/loadKTX2.js";
 import Resource from "../Core/Resource.js";
 
 /**
- * @typedef {HTMLImageElement|HTMLCanvasElement|ImageBitmap} ImageryTypes
+ * @typedef {HTMLImageElement|HTMLCanvasElement|ImageBitmap|OffscreenCanvas} ImageryTypes
  *
  * The format in which {@link ImageryProvider} methods return an image may
  * vary by provider, configuration, or server settings.  Most common are

package/Source/Scene/ImageryState.js

@@ -1,3 +1,5 @@
+// @ts-check
+
 /**
  * @private
  */
@@ -11,4 +13,7 @@ const ImageryState = {
   INVALID: 6,
   PLACEHOLDER: 7,
 };
-export default Object.freeze(ImageryState);
+
+Object.freeze(ImageryState);
+
+export default ImageryState;

package/Source/Scene/ImplicitSubdivisionScheme.js

@@ -45,4 +45,6 @@ ImplicitSubdivisionScheme.getBranchingFactor = function (subdivisionScheme) {
   }
 };
 
-export default Object.freeze(ImplicitSubdivisionScheme);
+Object.freeze(ImplicitSubdivisionScheme);
+
+export default ImplicitSubdivisionScheme;

package/Source/Scene/InstanceAttributeSemantic.js

@@ -76,4 +76,6 @@ InstanceAttributeSemantic.fromGltfSemantic = function (gltfSemantic) {
   return undefined;
 };
 
-export default Object.freeze(InstanceAttributeSemantic);
+Object.freeze(InstanceAttributeSemantic);
+
+export default InstanceAttributeSemantic;

package/Source/Scene/IonWorldImageryStyle.js

@@ -1,3 +1,5 @@
+// @ts-check
+
 // Note, these values map directly to ion asset ids.
 
 /**
@@ -30,4 +32,7 @@ const IonWorldImageryStyle = {
    */
   ROAD: 4,
 };
-export default Object.freeze(IonWorldImageryStyle);
+
+Object.freeze(IonWorldImageryStyle);
+
+export default IonWorldImageryStyle;

package/Source/Scene/JobType.js

@@ -1,3 +1,5 @@
+// @ts-check
+
 /**
  * @private
  */
@@ -7,4 +9,7 @@ const JobType = {
   BUFFER: 2,
   NUMBER_OF_JOB_TYPES: 3,
 };
-export default Object.freeze(JobType);
+
+Object.freeze(JobType);
+
+export default JobType;

package/Source/Scene/LabelStyle.js

@@ -1,3 +1,5 @@
+// @ts-check
+
 /**
  * Describes how to draw a label.
  *
@@ -30,4 +32,7 @@ const LabelStyle = {
    */
   FILL_AND_OUTLINE: 2,
 };
-export default Object.freeze(LabelStyle);
+
+Object.freeze(LabelStyle);
+
+export default LabelStyle;

package/Source/Scene/MapMode2D.js

@@ -1,3 +1,5 @@
+// @ts-check
+
 /**
  * Describes how the map will operate in 2D.
  *
@@ -20,4 +22,7 @@ const MapMode2D = {
    */
   INFINITE_SCROLL: 1,
 };
-export default Object.freeze(MapMode2D);
+
+Object.freeze(MapMode2D);
+
+export default MapMode2D;

package/Source/Scene/MetadataComponentType.js

@@ -593,4 +593,6 @@ MetadataComponentType.getDataViewAccessors = function (view, componentType) {
   return accessors[componentType];
 };
 
-export default Object.freeze(MetadataComponentType);
+Object.freeze(MetadataComponentType);
+
+export default MetadataComponentType;

package/Source/Scene/MetadataSchemaLoader.js

@@ -51,7 +51,6 @@ class MetadataSchemaLoader extends ResourceLoader {
   /**
    * The cache key of the resource.
    *
-   * @memberof MetadataSchemaLoader.prototype
    *
    * @type {string}
    * @readonly
@@ -64,7 +63,6 @@ class MetadataSchemaLoader extends ResourceLoader {
   /**
    * The metadata schema object.
    *
-   * @memberof MetadataSchemaLoader.prototype
    *
    * @type {MetadataSchema}
    * @readonly

package/Source/Scene/MetadataSemantic.js

@@ -1,7 +1,9 @@
+// @ts-check
+
 /**
  * An enum of built-in semantics.
  *
- * @enum MetadataSemantic
+ * @enum {string}
  *
  * @private
  * @experimental This feature is using part of the 3D Tiles spec that is not final and is subject to change without Cesium's standard deprecation policy.
@@ -150,4 +152,6 @@ const MetadataSemantic = {
   CONTENT_HORIZON_OCCLUSION_POINT: "CONTENT_HORIZON_OCCLUSION_POINT",
 };
 
-export default Object.freeze(MetadataSemantic);
+Object.freeze(MetadataSemantic);
+
+export default MetadataSemantic;

package/Source/Scene/MetadataType.js

@@ -217,4 +217,6 @@ MetadataType.getMathType = function (type) {
   }
 };
 
-export default Object.freeze(MetadataType);
+Object.freeze(MetadataType);
+
+export default MetadataType;

package/Source/Scene/Model/B3dmLoader.js

@@ -118,7 +118,6 @@ class B3dmLoader extends ResourceLoader {
   /**
    * true if textures are loaded, useful when incrementallyLoadTextures is true
    *
-   * @memberof B3dmLoader.prototype
    *
    * @type {boolean}
    * @readonly
@@ -131,7 +130,6 @@ class B3dmLoader extends ResourceLoader {
   /**
    * The cache key of the resource
    *
-   * @memberof B3dmLoader.prototype
    *
    * @type {string}
    * @readonly
@@ -144,7 +142,6 @@ class B3dmLoader extends ResourceLoader {
   /**
    * The loaded components.
    *
-   * @memberof B3dmLoader.prototype
    *
    * @type {ModelComponents.Components}
    * @readonly

package/Source/Scene/Model/CustomShaderMode.js

@@ -37,4 +37,6 @@ CustomShaderMode.getDefineName = function (customShaderMode) {
   return `CUSTOM_SHADER_${customShaderMode}`;
 };
 
-export default Object.freeze(CustomShaderMode);
+Object.freeze(CustomShaderMode);
+
+export default CustomShaderMode;

package/Source/Scene/Model/CustomShaderTranslucencyMode.js

@@ -1,3 +1,5 @@
+// @ts-check
+
 /**
  * An enum for controling how {@link CustomShader} handles translucency compared with the original
  * primitive.
@@ -32,4 +34,6 @@ const CustomShaderTranslucencyMode = {
   TRANSLUCENT: 2,
 };
 
-export default Object.freeze(CustomShaderTranslucencyMode);
+Object.freeze(CustomShaderTranslucencyMode);
+
+export default CustomShaderTranslucencyMode;

package/Source/Scene/Model/EdgeVisibilityPipelineStage.js

@@ -5,9 +5,7 @@ import defined from "../../Core/defined.js";
 import IndexDatatype from "../../Core/IndexDatatype.js";
 import ComponentDatatype from "../../Core/ComponentDatatype.js";
 import PrimitiveType from "../../Core/PrimitiveType.js";
-import Cartesian2 from "../../Core/Cartesian2.js";
 import Cartesian3 from "../../Core/Cartesian3.js";
-import AttributeCompression from "../../Core/AttributeCompression.js";
 import Pass from "../../Renderer/Pass.js";
 import ShaderDestination from "../../Renderer/ShaderDestination.js";
 import EdgeVisibilityStageFS from "../../Shaders/Model/EdgeVisibilityStageFS.js";
@@ -358,7 +356,22 @@ function buildTriangleAdjacency(primitive) {
     Cartesian3.subtract(scratchP1, scratchP0, scratchE1);
     Cartesian3.subtract(scratchP2, scratchP0, scratchE2);
     Cartesian3.cross(scratchE1, scratchE2, scratchCross);
-    Cartesian3.normalize(scratchCross, scratchCross);
+
+    // Skip degenerate triangles: a zero or non-finite cross product cannot be
+    // safely normalized and would produce invalid face normals.
+    const crossMagnitudeSquared = Cartesian3.magnitudeSquared(scratchCross);
+    if (
+      crossMagnitudeSquared === 0.0 ||
+      !Number.isFinite(crossMagnitudeSquared)
+    ) {
+      continue;
+    }
+
+    Cartesian3.multiplyByScalar(
+      scratchCross,
+      1.0 / Math.sqrt(crossMagnitudeSquared),
+      scratchCross,
+    );
 
     faceNormals[base] = scratchCross.x;
     faceNormals[base + 1] = scratchCross.y;
@@ -397,58 +410,34 @@ function generateEdgeFaceNormals(
 
   const hasGLBSilhouetteNormals =
     defined(edgeVisibility) && defined(edgeVisibility.silhouetteNormals);
-  let silhouetteNormalsUint32 = null;
-  const scratchDecodedA = new Cartesian3();
-  const scratchDecodedB = new Cartesian3();
 
-  if (hasGLBSilhouetteNormals) {
-    // GLB stores VEC3 BYTE as normalized normal vectors (signed bytes).
-    // Decode from signed bytes to normalized vectors, then re-encode to 16-bit octahedral format.
-    const decodeSignedByte = (val) => 2 * ((val + 128) / 255) - 1;
+  // Decode GLB silhouette normals from signed-byte VEC3 to a flat Float32Array
+  // (3 floats per normal) to avoid per-normal object allocation and GC pressure.
+  let silhouetteNormalsFloat = null;
 
-    // Re-encode each VEC3 BYTE to 16-bit oct-encoded normal using AttributeCompression
-    const uint16Normals = new Uint16Array(
-      edgeVisibility.silhouetteNormals.length,
-    );
+  if (hasGLBSilhouetteNormals) {
+    const raw = edgeVisibility.silhouetteNormals;
+    silhouetteNormalsFloat = new Float32Array(raw.length * 3);
     const scratchNormal = new Cartesian3();
-    const scratchEncoded = new Cartesian2();
 
-    for (let i = 0; i < edgeVisibility.silhouetteNormals.length; i++) {
-      const vec3 = edgeVisibility.silhouetteNormals[i];
+    for (let i = 0; i < raw.length; i++) {
+      const vec3 = raw[i];
+      // Signed byte → float: map [-128,127] → [-1,1] via [0,255]
+      scratchNormal.x = 2 * ((vec3.x + 128) / 255) - 1;
+      scratchNormal.y = 2 * ((vec3.y + 128) / 255) - 1;
+      scratchNormal.z = 2 * ((vec3.z + 128) / 255) - 1;
 
-      // Decode from signed byte to normal vector
-      scratchNormal.x = decodeSignedByte(vec3.x);
-      scratchNormal.y = decodeSignedByte(vec3.y);
-      scratchNormal.z = decodeSignedByte(vec3.z);
-
-      // Normalize to unit vector
-      const magnitude = Cartesian3.magnitude(scratchNormal);
-      if (magnitude > 0) {
+      if (Cartesian3.magnitudeSquared(scratchNormal) > 0) {
         Cartesian3.normalize(scratchNormal, scratchNormal);
       } else {
-        // Handle zero vector - use default up vector
         scratchNormal.x = 0;
         scratchNormal.y = 0;
         scratchNormal.z = 1;
       }
 
-      // Use Cesium's octahedral encoding (returns 0-255 integers)
-      AttributeCompression.octEncodeInRange(scratchNormal, 255, scratchEncoded);
-
-      // Convert to 16-bit integer: (y << 8) | x
-      const byteX = scratchEncoded.x & 0xff;
-      const byteY = scratchEncoded.y & 0xff;
-      uint16Normals[i] = (byteY << 8) | byteX;
-    }
-
-    // Pack pairs into Uint32Array (little-endian: normalA|normalB<<16)
-    const numPairs = Math.floor(uint16Normals.length / 2);
-    silhouetteNormalsUint32 = new Uint32Array(numPairs);
-
-    for (let i = 0; i < numPairs; i++) {
-      const normalA = uint16Normals[i * 2];
-      const normalB = uint16Normals[i * 2 + 1];
-      silhouetteNormalsUint32[i] = normalA | (normalB << 16);
+      silhouetteNormalsFloat[i * 3] = scratchNormal.x;
+      silhouetteNormalsFloat[i * 3 + 1] = scratchNormal.y;
+      silhouetteNormalsFloat[i * 3 + 2] = scratchNormal.z;
     }
   }
 
@@ -466,37 +455,21 @@ function generateEdgeFaceNormals(
     // Use GLB silhouetteNormals for type=1 (SILHOUETTE) edges if available
     if (
       hasGLBSilhouetteNormals &&
-      silhouetteNormalsUint32 &&
+      silhouetteNormalsFloat &&
       edgeType === 1 &&
       mateVertexIndex >= 0
     ) {
-      // Each OctEncodedNormalPair is stored as one Uint32 value
-      // Uint32 contains 4 bytes: [byte0, byte1, byte2, byte3]
-      // normalA = byte0 | (byte1 << 8)  - little endian
-      // normalB = byte2 | (byte3 << 8)  - little endian
-
-      if (mateVertexIndex < silhouetteNormalsUint32.length) {
-        const uint32Value = silhouetteNormalsUint32[mateVertexIndex];
-
-        // Uint32 contains 4 bytes: [xA, yA, xB, yB]
-        // Extract and decode using octDecode (rangeMax=255)
-        AttributeCompression.octDecode(
-          uint32Value & 0xff, // xA
-          (uint32Value >> 8) & 0xff, // yA
-          scratchDecodedA,
-        );
-        AttributeCompression.octDecode(
-          (uint32Value >> 16) & 0xff, // xB
-          (uint32Value >> 24) & 0xff, // yB
-          scratchDecodedB,
-        );
-
-        nAx = scratchDecodedA.x;
-        nAy = scratchDecodedA.y;
-        nAz = scratchDecodedA.z;
-        nBx = scratchDecodedB.x;
-        nBy = scratchDecodedB.y;
-        nBz = scratchDecodedB.z;
+      const pairBase = mateVertexIndex * 2;
+      if ((pairBase + 1) * 3 + 2 < silhouetteNormalsFloat.length) {
+        const baseA = pairBase * 3;
+        const baseB = (pairBase + 1) * 3;
+
+        nAx = silhouetteNormalsFloat[baseA];
+        nAy = silhouetteNormalsFloat[baseA + 1];
+        nAz = silhouetteNormalsFloat[baseA + 2];
+        nBx = silhouetteNormalsFloat[baseB];
+        nBy = silhouetteNormalsFloat[baseB + 1];
+        nBz = silhouetteNormalsFloat[baseB + 2];
 
         usedGLBNormals = true;
       }

package/Source/Scene/Model/Extensions/Gpm/PpeSource.js

@@ -1,3 +1,5 @@
+// @ts-check
+
 /**
  * An enum of per-point error sources.
  *
@@ -72,4 +74,6 @@ const PpeSource = {
   SIGR: "VARZ",
 };
 
-export default Object.freeze(PpeSource);
+Object.freeze(PpeSource);
+
+export default PpeSource;