@cesium/engine 23.0.1 → 25.0.0

package/Source/Renderer/MipmapHint.js

@@ -1,6 +1,7 @@
 import WebGLConstants from "../Core/WebGLConstants.js";
 
 /**
+ * @enum {number}
  * @private
  */
 const MipmapHint = {
@@ -16,4 +17,7 @@ const MipmapHint = {
     );
   },
 };
-export default Object.freeze(MipmapHint);
+
+Object.freeze(MipmapHint);
+
+export default MipmapHint;

package/Source/Renderer/Pass.js

@@ -1,6 +1,9 @@
+// @ts-check
+
 /**
  * The render pass for a command.
  *
+ * @enum {number}
  * @private
  */
 const Pass = {
@@ -26,4 +29,7 @@ const Pass = {
   OVERLAY: 12,
   NUMBER_OF_PASSES: 13,
 };
-export default Object.freeze(Pass);
+
+Object.freeze(Pass);
+
+export default Pass;

package/Source/Renderer/PickId.js

@@ -0,0 +1,44 @@
+// @ts-check
+
+/** @import Color from "../Core/Color.js"; */
+/** @import {Destroyable} from "../Core/globalTypes.js"; */
+
+/**
+ * Represents a pickable object with a unique integer ID and picking color.
+ *
+ * @implements {Destroyable}
+ * @ignore
+ */
+class PickId {
+  /**
+   * @param {Map<number, object>} pickObjects
+   * @param {number} key
+   * @param {Color} color
+   */
+  constructor(pickObjects, key, color) {
+    this._pickObjects = pickObjects;
+
+    /** @type {number} */
+    this.key = key;
+
+    /** @type {Color} */
+    this.color = color;
+  }
+
+  /** @type {object} */
+  get object() {
+    return this._pickObjects.get(this.key);
+  }
+
+  set object(value) {
+    this._pickObjects.set(this.key, value);
+  }
+
+  /** @returns {void} */
+  destroy() {
+    this._pickObjects.delete(this.key);
+    return undefined;
+  }
+}
+
+export default PickId;

package/Source/Renderer/PixelDatatype.js

@@ -118,4 +118,6 @@ PixelDatatype.getTypedArrayConstructor = function (pixelDatatype) {
   return Uint32Array;
 };
 
-export default Object.freeze(PixelDatatype);
+Object.freeze(PixelDatatype);
+
+export default PixelDatatype;

package/Source/Renderer/RenderState.js

@@ -456,7 +456,7 @@ let renderStateCache = {};
  * @see DrawCommand
  * @see ClearCommand
  *
- * @private
+ * @ignore
  */
 RenderState.fromCache = function (renderState) {
   const partialKey = JSON.stringify(renderState);
@@ -496,7 +496,7 @@ RenderState.fromCache = function (renderState) {
 };
 
 /**
- * @private
+ * @ignore
  */
 RenderState.removeFromCache = function (renderState) {
   const states = new RenderState(renderState);

package/Source/Renderer/RenderbufferFormat.js

@@ -1,6 +1,7 @@
 import WebGLConstants from "../Core/WebGLConstants.js";
 
 /**
+ * @enum {number}
  * @private
  */
 const RenderbufferFormat = {
@@ -39,4 +40,7 @@ const RenderbufferFormat = {
     return RenderbufferFormat.RGBA8;
   },
 };
-export default Object.freeze(RenderbufferFormat);
+
+Object.freeze(RenderbufferFormat);
+
+export default RenderbufferFormat;

package/Source/Renderer/ShaderDestination.js

@@ -5,6 +5,7 @@ import DeveloperError from "../Core/DeveloperError.js";
  * A bit flag describing whether a variable should be added to the
  * vertex shader, the fragment shader, or both (or none).
  *
+ * @enum {number}
  * @private
  */
 const ShaderDestination = {
@@ -89,4 +90,6 @@ ShaderDestination.intersection = function (...destinations) {
   return result;
 };
 
-export default Object.freeze(ShaderDestination);
+Object.freeze(ShaderDestination);
+
+export default ShaderDestination;

package/Source/Renderer/TextureMagnificationFilter.js

@@ -38,4 +38,6 @@ TextureMagnificationFilter.validate = function (textureMagnificationFilter) {
   );
 };
 
-export default Object.freeze(TextureMagnificationFilter);
+Object.freeze(TextureMagnificationFilter);
+
+export default TextureMagnificationFilter;

package/Source/Renderer/TextureMinificationFilter.js

@@ -91,4 +91,6 @@ TextureMinificationFilter.validate = function (textureMinificationFilter) {
   );
 };
 
-export default Object.freeze(TextureMinificationFilter);
+Object.freeze(TextureMinificationFilter);
+
+export default TextureMinificationFilter;

package/Source/Renderer/TextureWrap.js

@@ -1,6 +1,7 @@
 import WebGLConstants from "../Core/WebGLConstants.js";
 
 /**
+ * @enum {number}
  * @private
  */
 const TextureWrap = {
@@ -16,4 +17,7 @@ const TextureWrap = {
     );
   },
 };
-export default Object.freeze(TextureWrap);
+
+Object.freeze(TextureWrap);
+
+export default TextureWrap;

package/Source/Renderer/VertexArray.js

@@ -12,6 +12,9 @@ import Buffer from "./Buffer.js";
 import BufferUsage from "./BufferUsage.js";
 import ContextLimits from "./ContextLimits.js";
 import AttributeType from "../Scene/AttributeType.js";
+import assert from "../Core/assert.js";
+
+/** @import {TypedArray, TypedArrayConstructor} from "../Core/globalTypes.js"; */
 
 function addAttribute(attributes, attribute, index, context) {
   const hasVertexBuffer = defined(attribute.vertexBuffer);
@@ -801,6 +804,83 @@ function setConstantAttributes(vertexArray, gl) {
   }
 }
 
+/**
+ * Copies into a vertex attribute buffer from the given array, at a given
+ * range specified as offset and count, in number of (VECN) vertices. Array
+ * and vertex attribute must have the same length, which can be larger
+ * than the specified range to update.
+ * @param {number} attributeIndex
+ * @param {TypedArray} array
+ * @param {number} vertexOffset
+ * @param {number} vertexCount
+ */
+VertexArray.prototype.copyAttributeFromRange = function (
+  attributeIndex,
+  array,
+  vertexOffset,
+  vertexCount,
+) {
+  const attribute = this.getAttribute(attributeIndex);
+  const buffer = /** @type {Buffer} */ (attribute.vertexBuffer);
+  const elementsPerVertex = attribute.componentsPerAttribute;
+
+  //>>includeStart('debug', pragmas.debug);
+  assert(buffer.sizeInBytes === array.byteLength, "Invalid buffer length");
+  //>>includeEnd('debug');
+
+  const ArrayConstructor = /** @type {TypedArrayConstructor} */ (
+    array.constructor
+  );
+
+  const byteOffset =
+    vertexOffset * elementsPerVertex * ArrayConstructor.BYTES_PER_ELEMENT;
+
+  // Create a zero-copy ArrayView onto the specified range of the source array.
+  const rangeArrayView = new ArrayConstructor(
+    /** @type {ArrayBuffer} */ (array.buffer),
+    array.byteOffset + byteOffset,
+    vertexCount * elementsPerVertex,
+  );
+
+  buffer.copyFromArrayView(rangeArrayView, byteOffset);
+};
+
+/**
+ * Copies into the index buffer from the given array, at a given range
+ * specified as offset and count, in number of (uint) indices. Array
+ * and index buffer must have the same length, which can be larger
+ * than the specified range to update.
+ * @param {TypedArray} array
+ * @param {number} indexOffset
+ * @param {number} indexCount
+ */
+VertexArray.prototype.copyIndexFromRange = function (
+  array,
+  indexOffset,
+  indexCount,
+) {
+  const buffer = /** @type {Buffer} */ (this._indexBuffer);
+
+  //>>includeStart('debug', pragmas.debug);
+  assert(buffer.sizeInBytes === array.byteLength, "Invalid buffer length");
+  //>>includeEnd('debug');
+
+  const ArrayConstructor = /** @type {TypedArrayConstructor} */ (
+    array.constructor
+  );
+
+  const byteOffset = indexOffset * ArrayConstructor.BYTES_PER_ELEMENT;
+
+  // Create a zero-copy ArrayView onto the specified range of the source array.
+  const rangeArrayView = new ArrayConstructor(
+    /** @type {ArrayBuffer} */ (array.buffer),
+    array.byteOffset + byteOffset,
+    indexCount,
+  );
+
+  buffer.copyFromArrayView(rangeArrayView, byteOffset);
+};
+
 VertexArray.prototype._bind = function () {
   if (defined(this._vao)) {
     this._context.glBindVertexArray(this._vao);

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 =
-  "AAPTahokHpH_PEeQIduLwb1A8ZA..rA8bGH-48FscqzwJpCALUEqt2P_mHiflgl0WkBvCxPJzsFMRqAukz-mcG8oZ3eKnfk4MHGvCFMNsNrxXb2fGxfKH-3TQxCZVkCycztIPWRM5OIQ7pzTZIBOO9D7N8VXXpyPtp2bSsxWp5dUpv8qsgrfMHU4IXWGiiKWELBnANXn1QgzyLKngOHAgYWUq2OQ2XuULOpwJwOEWpyX5KvoLavJP0LFJdjB08Mmz-wCvnFqwr8CZjFpKaVSbAT1_aZs2dlMP";
+  "AAPTarorp_WgBbyDABMqDfNsSWg..ykf3buvvbFduVL73NrRrnqBR8lO4ndPrO94nF7-3rfUWF5n3sbUe2Xe0d4rhAGa-sOTDpE-AI5kom4O4ixK3QFkTnjaGpFtDOxyrPXZUj1vRmsZAaIMZlzC5TWfBDr-RYeD9NCRMq8JwaP2Fp9blpXTqYVCWpENJLiCJ3pUlQ7XSrnJYNlPwph4B3k1FAK_j3DTlLDd2xbHwcMRbVYq8iJqt7vGuWHw3otSkmltdnNAgMaVQ366Rf0YUAT1_Hbd2aXK9";
 /**
  * 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;