@babylonjs/core 8.37.3 → 8.39.0

package/Particles/solidParticleSystem.d.ts

@@ -3,6 +3,7 @@ import { Vector3 } from "../Maths/math.vector.js";
 import { Color4 } from "../Maths/math.color.js";
 import { Mesh } from "../Meshes/mesh.js";
 import type { Scene, IDisposable } from "../scene.js";
+import type { Observer } from "../Misc/observable.js";
 import { DepthSortedParticle, SolidParticle, ModelShape, SolidParticleVertex } from "./solidParticle.js";
 import type { TargetCamera } from "../Cameras/targetCamera.js";
 import { BoundingInfo } from "../Culling/boundingInfo.js";
@@ -147,6 +148,15 @@ export declare class SolidParticleSystem implements IDisposable {
     protected _autoUpdateSubMeshes: boolean;
     protected _tmpVertex: SolidParticleVertex;
     protected _recomputeInvisibles: boolean;
+    protected _started: boolean;
+    protected _stopped: boolean;
+    protected _onBeforeRenderObserver: Nullable<Observer<Scene>>;
+    /**
+     * The overall motion speed (0.01 is default update speed, faster updates = faster animation)
+     */
+    updateSpeed: number;
+    /** @internal */
+    protected _scaledUpdateSpeed: number;
     /**
      * Creates a SPS (Solid Particle System) object.
      * @param name (String) is the SPS name, this will be the underlying mesh name.
@@ -601,4 +611,22 @@ export declare class SolidParticleSystem implements IDisposable {
      * @param update the boolean update value actually passed to setParticles()
      */
     afterUpdateParticles(start?: number, stop?: number, update?: boolean): void;
+    /**
+     * 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?: number): void;
+    /**
+     * Stops the particle system.
+     */
+    stop(): void;
+    /**
+     * Gets if the particle system is started
+     */
+    get started(): boolean;
+    /**
+     * Gets if the particle system is stopped
+     */
+    get stopped(): boolean;
 }

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