babylon.quarks 0.18.0 → 0.18.1

package/dist/types/index.d.ts

@@ -2645,6 +2645,8 @@ declare class ParticleSystem implements IParticleSystem {
     private materialRef;
     private qualityFactor;
     private useFastTrailHistory;
+    private simulationAccumulator;
+    private destroyed;
     /** @internal **/
     _renderer?: BatchedRenderer;
     set time(time: number);
@@ -2699,6 +2701,8 @@ declare class ParticleSystem implements IParticleSystem {
     private firstTimeUpdate;
     /** @internal */
     update(delta: number): void;
+    /** Advances emission, behaviors, motion and culling by one fixed timestep. */
+    private simulateStep;
     private notifyFinished;
     emit(delta: number, emissionState: EmissionState, emitterMatrix: Matrix4): void;
     toJSON(metaData?: BabylonMetaData | string, _options?: SerializationOptions): ParticleSystemJSONParameters;
@@ -2749,6 +2753,13 @@ declare class QuarksLoader {
     private extractInterleavedAttribute;
     private int32ArrayToFloat32;
     private parseImages;
+    /**
+     * `img.url` is already absolute for data/blob URIs and full http(s) URLs — common for
+     * "portable" exports that embed textures as base64 (see ensurePortableTextureUrl in
+     * babylon.quarks-editor). Prepending baseUrl to those turns e.g.
+     * "data:image/png;base64,AAAA" into an invalid path like "/some/dir/data:image/png;base64,AAAA".
+     */
+    private resolveImageUrl;
     private parseTextures;
     private mapWrapMode;
     private parseMaterials;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "babylon.quarks",
-  "version": "0.18.0",
+  "version": "0.18.1",
   "description": "A High-Performance Particle System for Babylon.js",
   "type": "module",
   "types": "./dist/types/index.d.ts",

package/src/ParticleSystem.ts

@@ -56,6 +56,8 @@ const tempQ = new Quaternion();
 const tempV = new Vector3();
 const tempV2 = new Vector3();
 const PREWARM_FPS = 60;
+const SIMULATION_STEP = 1 / PREWARM_FPS;
+const MAX_SIMULATION_STEPS_PER_FRAME = 8;
 
 const DEFAULT_POSITIONS = new Float32Array([
     -0.5, -0.5, 0,
@@ -217,6 +219,8 @@ export class ParticleSystem implements IParticleSystem {
     private materialRef: any = null;
     private qualityFactor = 1;
     private useFastTrailHistory = true;
+    private simulationAccumulator = 0;
+    private destroyed = false;
     /** @internal **/
     _renderer?: BatchedRenderer;
 
@@ -784,6 +788,10 @@ export class ParticleSystem implements IParticleSystem {
     }
 
     dispose() {
+        if (this.destroyed) {
+            return;
+        }
+        this.destroyed = true;
         if (this._renderer) this._renderer.deleteSystem(this);
         this.emitter.dispose();
         this.fire({type: 'destroy', particleSystem: this});
@@ -809,6 +817,8 @@ export class ParticleSystem implements IParticleSystem {
         this.startDelayTimeLeft = this.startDelay.genValue(this.memory, 0);
         this.previousEmitterPos = undefined;
         this.emitterVelocity.set(0, 0, 0);
+        this.simulationAccumulator = 0;
+        this.destroyed = false;
     }
 
     private firstTimeUpdate = true;
@@ -862,6 +872,19 @@ export class ParticleSystem implements IParticleSystem {
             this.startDelayTimeLeft = 0;
         }
 
+        this.simulationAccumulator += delta;
+        const stepsToRun = Math.min(
+            MAX_SIMULATION_STEPS_PER_FRAME,
+            Math.floor((this.simulationAccumulator + 1e-9) / SIMULATION_STEP)
+        );
+        for (let i = 0; i < stepsToRun; i++) {
+            this.simulateStep(SIMULATION_STEP);
+        }
+        this.simulationAccumulator -= stepsToRun * SIMULATION_STEP;
+    }
+
+    /** Advances emission, behaviors, motion and culling by one fixed timestep. */
+    private simulateStep(delta: number): void {
         if (!this.onlyUsedByOther) {
             this.emit(delta, this.emissionState, this.emitter.matrixWorld);
         }
@@ -961,12 +984,6 @@ export class ParticleSystem implements IParticleSystem {
         const emissionBurstCount = emissionBursts.length;
         const qualityFactor = this.qualityFactor;
 
-        const totalSpawn = Math.floor(emissionState.waitEmiting);
-        if (totalSpawn > 0) {
-            this.spawn(totalSpawn, emissionState, emitterMatrix);
-            emissionState.waitEmiting -= totalSpawn;
-        }
-
         while (
             emissionState.burstIndex < emissionBurstCount &&
             emissionBursts[emissionState.burstIndex].time <= emissionState.time
@@ -999,6 +1016,15 @@ export class ParticleSystem implements IParticleSystem {
                 }
             }
         }
+
+        // Accrue before spawning so replacement particles can appear on the same
+        // frame an old one dies (rate * lifetime ≈ 1 would otherwise flicker).
+        const totalSpawn = Math.floor(emissionState.waitEmiting);
+        if (totalSpawn > 0) {
+            this.spawn(totalSpawn, emissionState, emitterMatrix);
+            emissionState.waitEmiting -= totalSpawn;
+        }
+
         if (emissionState.previousWorldPos === undefined) emissionState.previousWorldPos = new Vector3();
         emissionState.previousWorldPos.set(emitterMatrix.elements[12], emitterMatrix.elements[13], emitterMatrix.elements[14]);
         emissionState.time += delta;

package/src/QuarksLoader.ts

@@ -255,10 +255,23 @@ export class QuarksLoader {
     private parseImages(images: any[], baseUrl: string, _meta: LoadedMeta): void {
         (this as any)._images = {};
         for (const img of images) {
-            (this as any)._images[img.uuid] = img.url ? baseUrl + img.url : null;
+            (this as any)._images[img.uuid] = img.url ? this.resolveImageUrl(baseUrl, img.url) : null;
         }
     }
 
+    /**
+     * `img.url` is already absolute for data/blob URIs and full http(s) URLs — common for
+     * "portable" exports that embed textures as base64 (see ensurePortableTextureUrl in
+     * babylon.quarks-editor). Prepending baseUrl to those turns e.g.
+     * "data:image/png;base64,AAAA" into an invalid path like "/some/dir/data:image/png;base64,AAAA".
+     */
+    private resolveImageUrl(baseUrl: string, url: string): string {
+        if (/^(data|blob):/i.test(url) || /^[a-z][a-z0-9+.-]*:\/\//i.test(url) || url.startsWith('/')) {
+            return url;
+        }
+        return baseUrl + url;
+    }
+
     private parseTextures(textures: any[], meta: LoadedMeta): void {
         const images = (this as any)._images || {};
         for (const texDef of textures) {