@hztxi/cesium-engine 25.0.6 → 26.2.1

package/Source/Renderer/DrawCommand.js

@@ -47,6 +47,7 @@ const Flags = {
  * @property {Pass} [pass]
  * @property {object} [owner]
  * @property {string} [pickId]
+ * @property {string} [snapId]
  * @property {boolean} [pickMetadataAllowed=false]
  * @property {boolean} [cull=true]
  * @property {boolean} [occlude=true]
@@ -102,6 +103,7 @@ class DrawCommand {
     this._debugOverlappingFrustums = 0;
     /** @private */
     this._pickId = options.pickId;
+    this._snapId = options.snapId;
     /** @private */
     this._pickMetadataAllowed = options.pickMetadataAllowed === true;
     /**
@@ -532,6 +534,25 @@ class DrawCommand {
     }
   }
 
+  /**
+   * A GLSL string that will evaluate to the float snap payload written during
+   * a snapping pass (see {@link Scene#snap}). When <code>undefined</code>, the
+   * command does not render during a snapping pass.
+   *
+   * @type {string|undefined}
+   * @default undefined
+   */
+  get snapId() {
+    return this._snapId;
+  }
+
+  set snapId(value) {
+    if (this._snapId !== value) {
+      this._snapId = value;
+      this.dirty = true;
+    }
+  }
+
   /**
    * Whether metadata picking is allowed.
    *
@@ -628,6 +649,7 @@ class DrawCommand {
     result._owner = command._owner;
     result._debugOverlappingFrustums = command._debugOverlappingFrustums;
     result._pickId = command._pickId;
+    result._snapId = command._snapId;
     result._pickMetadataAllowed = command._pickMetadataAllowed;
     result._pickedMetadataInfo = command._pickedMetadataInfo;
     result._flags = command._flags;

package/Source/Renderer/Framebuffer.js

@@ -287,6 +287,10 @@ function Framebuffer(options) {
   }
 
   this._unBind();
+
+  // _bind and _unBind bypass the context's framebuffer binding cache. The GL
+  // binding is now the default framebuffer; update the cache to match.
+  context._currentFramebuffer = undefined;
 }
 
 Object.defineProperties(Framebuffer.prototype, {

package/Source/Renderer/Pass.js

@@ -19,15 +19,17 @@ const Pass = {
   GLOBE: 2,
   TERRAIN_CLASSIFICATION: 3,
   CESIUM_3D_TILE_EDGES: 4,
-  CESIUM_3D_TILE: 5,
-  CESIUM_3D_TILE_CLASSIFICATION: 6,
-  CESIUM_3D_TILE_CLASSIFICATION_IGNORE_SHOW: 7,
-  OPAQUE: 8,
-  TRANSLUCENT: 9,
-  VOXELS: 10,
-  GAUSSIAN_SPLATS: 11,
-  OVERLAY: 12,
-  NUMBER_OF_PASSES: 13,
+  CESIUM_3D_TILE_PLANAR_FILL_ID: 5,
+  CESIUM_3D_TILE: 6,
+  CESIUM_3D_TILE_CLASSIFICATION: 7,
+  CESIUM_3D_TILE_CLASSIFICATION_IGNORE_SHOW: 8,
+  OPAQUE: 9,
+  TRANSLUCENT: 10,
+  VOXELS: 11,
+  GAUSSIAN_SPLATS: 12,
+  CESIUM_3D_TILE_EDGES_DIRECT: 13,
+  OVERLAY: 14,
+  NUMBER_OF_PASSES: 15,
 };
 
 Object.freeze(Pass);

package/Source/Renderer/Texture.js

@@ -1,5 +1,6 @@
 import Cartesian2 from "../Core/Cartesian2.js";
 import Check from "../Core/Check.js";
+import Color from "../Core/Color.js";
 import createGuid from "../Core/createGuid.js";
 import Frozen from "../Core/Frozen.js";
 import defined from "../Core/defined.js";
@@ -576,7 +577,7 @@ function loadNull(texture) {
 /**
  * This function is identical to using the Texture constructor except that it can be
  * replaced with a mock/spy in tests.
- * @private
+ * @ignore
  */
 Texture.create = function (options) {
   return new Texture(options);
@@ -1123,4 +1124,14 @@ Texture.prototype.destroy = function () {
   this._context._gl.deleteTexture(this._texture);
   return destroyObject(this);
 };
+
+/**
+ * The default color used as a placeholder texture while other textures are downloaded.
+ * This can be changed globally to customize the placeholder appearance.
+ *
+ * @type {Color}
+ * @default Color.WHITE
+ */
+Texture.defaultColor = Color.WHITE;
+
 export default Texture;

package/Source/Renderer/UniformState.js

@@ -37,6 +37,13 @@ function UniformState() {
    * @type {Texture}
    */
   this.edgeDepthTexture = undefined; // packed depth color attachment from edge pass
+  /**
+   * Texture written by the planar fill feature-ID pre-pass.
+   * Contains per-pixel feature IDs for non-behind planar fill geometry.
+   * Sampled by behind fills to test same-object coplanarity.
+   * @type {Texture}
+   */
+  this.planarFillIdTexture = undefined;
   /**
    * @type {number}
    */

package/Source/Renderer/VertexArray.js

@@ -16,6 +16,7 @@ import assert from "../Core/assert.js";
 
 /** @import {TypedArray, TypedArrayConstructor} from "../Core/globalTypes.js"; */
 
+/** @ignore */
 function addAttribute(attributes, attribute, index, context) {
   const hasVertexBuffer = defined(attribute.vertexBuffer);
   const hasValue = defined(attribute.value);
@@ -644,7 +645,6 @@ VertexArray.fromGeometry = function (options) {
         }
 
         let attrProps = {};
-        vertexBuffer = undefined;
         if (defined(attribute.values)) {
           vertexBuffer = Buffer.createVertexBuffer({
             context: context,