@babylonjs/core 8.38.0 → 8.39.0

package/Particles/solidParticleSystem.js

@@ -121,6 +121,13 @@ export class SolidParticleSystem {
         this._materialSortFunction = (p1, p2) => p1.materialIndex - p2.materialIndex;
         this._autoUpdateSubMeshes = false;
         this._recomputeInvisibles = false;
+        this._started = false;
+        this._stopped = false;
+        this._onBeforeRenderObserver = null;
+        /**
+         * The overall motion speed (0.01 is default update speed, faster updates = faster animation)
+         */
+        this.updateSpeed = 0.01;
         this.name = name;
         this._scene = scene || EngineStore.LastCreatedScene;
         this._camera = scene.activeCamera;
@@ -942,8 +949,20 @@ export class SolidParticleSystem {
         const vpos = (index / 3) | 0;
         colorIndex = vpos * 4;
         uvIndex = vpos * 2;
+        // Calculate scaled update speed based on animation ratio (for FPS independence)
+        if (this._started && !this._stopped) {
+            this._scaledUpdateSpeed = this.updateSpeed * (this._scene?.getAnimationRatio() || 1);
+        }
         for (let p = start; p <= end; p++) {
             const particle = this.particles[p];
+            // Update particle age and check lifetime
+            if (this._started && !this._stopped) {
+                particle.age += this._scaledUpdateSpeed;
+                // Only check lifetime if it's finite (Infinity means particle never dies)
+                if (isFinite(particle.lifeTime) && particle.age >= particle.lifeTime) {
+                    particle.alive = false;
+                }
+            }
             // call to custom user function to update the particle properties
             this.updateParticle(particle);
             const shape = particle._model._shape;
@@ -1279,6 +1298,7 @@ export class SolidParticleSystem {
      * Disposes the SPS.
      */
     dispose() {
+        this.stop();
         this.mesh.dispose();
         this.vars = null;
         // drop references to internal big arrays for the GC
@@ -1770,5 +1790,60 @@ export class SolidParticleSystem {
      */
     // eslint-disable-next-line @typescript-eslint/no-unused-vars
     afterUpdateParticles(start, stop, update) { }
+    /**
+     * Starts the particle system and begins to emit.
+     * This will call buildMesh(), initParticles(), setParticles() and register the update loop.
+     * @param delay defines the delay in milliseconds before starting the system (0 by default)
+     */
+    start(delay = 0) {
+        if (this._started) {
+            return;
+        }
+        if (delay > 0) {
+            setTimeout(() => {
+                this.start(0);
+            }, delay);
+            return;
+        }
+        this.buildMesh();
+        this.initParticles();
+        this.setParticles();
+        this._started = true;
+        this._stopped = false;
+        // Register update loop
+        if (this._scene) {
+            this._onBeforeRenderObserver = this._scene.onBeforeRenderObservable.add(() => {
+                if (this._started && !this._stopped) {
+                    this.setParticles();
+                }
+            });
+        }
+    }
+    /**
+     * Stops the particle system.
+     */
+    stop() {
+        if (this._stopped) {
+            return;
+        }
+        this._stopped = true;
+        // Unregister update loop
+        if (this._onBeforeRenderObserver && this._scene) {
+            this._scene.onBeforeRenderObservable.remove(this._onBeforeRenderObserver);
+            this._onBeforeRenderObserver = null;
+        }
+    }
+    /**
+     * Gets if the particle system is started
+     */
+    get started() {
+        return this._started;
+    }
+    /**
+     * Gets if the particle system is stopped
+     */
+    get stopped() {
+        return this._stopped;
+    }
 }
 //# sourceMappingURL=solidParticleSystem.js.map