@babylonjs/core 9.6.1 → 9.7.0

package/Particles/thinParticleSystem.js

@@ -72,21 +72,6 @@ export class ThinParticleSystem extends BaseParticleSystem {
         }
         this._onDisposeObserver = this.onDisposeObservable.add(callback);
     }
-    /**
-     * Gets or sets a boolean indicating that the particle system should always render at full capacity.
-     * When enabled, the draw call always emits `getCapacity()` quads/instances and inactive slots are zero-filled in the
-     * vertex buffer (collapsing them to degenerate triangles that produce no fragments).
-     * This makes the particle system compatible with FAST snapshot rendering, where the recorded draw call parameters
-     * are baked into the GPU bundle. Activate via `SnapshotRenderingHelper.fixParticleSystem(ps)`.
-     * Note: vertex shader cost scales with capacity rather than the live particle count, so size capacity realistically.
-     * This property is runtime-only and is not persisted by `serialize()` / `Parse()`.
-     */
-    get useFixedCapacityForSnapshot() {
-        return this._useFixedCapacityForSnapshot;
-    }
-    set useFixedCapacityForSnapshot(value) {
-        this._useFixedCapacityForSnapshot = value;
-    }
     /**
      * Gets a boolean indicating that the particle system was disposed
      */
@@ -334,6 +319,7 @@ export class ThinParticleSystem extends BaseParticleSystem {
         this._scaledGravity = Vector3.Zero();
         this._currentRenderId = -1;
         this._useInstancing = false;
+        /** @internal */
         this._useFixedCapacityForSnapshot = false;
         this._fixedCapacityHighWaterMark = 0;
         this._isDisposed = false;
@@ -1605,17 +1591,12 @@ export class ThinParticleSystem extends BaseParticleSystem {
                 if (this._useFixedCapacityForSnapshot) {
                     // The vertex buffer is uploaded at full capacity so the FAST-snapshot bundle's draw call stays valid.
                     // Inactive slots must be zeroed so they collapse to degenerate (size=0) quads that emit no fragments.
-                    // Float32Array starts zeroed and `_appendParticleVertices` overwrites only the active range, so we
-                    // only need to clear slots that were active in a previous frame and aren't anymore — i.e. the range
-                    // [currentCount, highWaterMark). When the active count grows we just bump the high-water mark.
                     const stride = this._vertexBufferSize * (this._useInstancing ? 1 : 4);
                     const currentCount = this._particles.length;
                     if (currentCount < this._fixedCapacityHighWaterMark) {
                         this._vertexData.fill(0, currentCount * stride, this._fixedCapacityHighWaterMark * stride);
                     }
-                    if (currentCount > this._fixedCapacityHighWaterMark) {
-                        this._fixedCapacityHighWaterMark = currentCount;
-                    }
+                    this._fixedCapacityHighWaterMark = currentCount;
                     this._vertexBuffer.updateDirectly(this._vertexData, 0, this._capacity);
                 }
                 else {
@@ -1627,6 +1608,27 @@ export class ThinParticleSystem extends BaseParticleSystem {
             this.stop();
         }
     }
+    /** @internal */
+    _initFixedCapacitySnapshotData() {
+        if (this._useFixedCapacityForSnapshot) {
+            return false;
+        }
+        this._useFixedCapacityForSnapshot = true;
+        this._vertexData.fill(0);
+        this._fixedCapacityHighWaterMark = 0;
+        this._vertexBuffer?.updateDirectly(this._vertexData, 0, this._capacity);
+        return true;
+    }
+    /** @internal */
+    _clearFixedCapacitySnapshotData() {
+        if (!this._useFixedCapacityForSnapshot || !this._vertexBuffer || this._fixedCapacityHighWaterMark === 0) {
+            return;
+        }
+        const stride = this._vertexBufferSize * (this._useInstancing ? 1 : 4);
+        this._vertexData.fill(0, 0, this._fixedCapacityHighWaterMark * stride);
+        this._fixedCapacityHighWaterMark = 0;
+        this._vertexBuffer.updateDirectly(this._vertexData, 0, this._capacity);
+    }
     /**
      * Internal only. Calculates the current emit rate based on the gradients if any.
      * @returns The emit rate