@woosh/meep-engine 3.8.0 → 3.10.0

package/src/engine/graphics/ecs/sprite/SpriteSystemPE.js

@@ -1,132 +1,135 @@
-import { float_to_uint8 } from "../../../../core/binary/float_to_uint8.js";
-import { SerializationMetadata } from "../../../ecs/components/SerializationMetadata.js";
-import Entity from "../../../ecs/Entity.js";
-import { AbstractContextSystem } from "../../../ecs/system/AbstractContextSystem.js";
-import { SystemEntityContext } from "../../../ecs/system/SystemEntityContext.js";
-import { Transform } from "../../../ecs/transform/Transform.js";
-import {
-    PARTICLE_ATTRIBUTE_COLOR,
-    PARTICLE_ATTRIBUTE_POSITION
-} from "../../particles/particular/engine/emitter/PARTICLE_ATTRIBUTES.js";
-import { ParticleEmitter } from "../../particles/particular/engine/emitter/ParticleEmitter.js";
-import { ParticleEmitterFlag } from "../../particles/particular/engine/emitter/ParticleEmitterFlag.js";
-import { ParticleLayer } from "../../particles/particular/engine/emitter/ParticleLayer.js";
-import { Sprite } from "./Sprite.js";
-
-class Context extends SystemEntityContext {
-    constructor() {
-        super();
-
-        this.__emitter = new ParticleEmitter();
-        this.__layer = new ParticleLayer();
-
-        this.__layer.emissionRate = 0;
-        this.__layer.emissionImmediate = 1;
-        this.__layer.steps.reset();
-        this.__layer.particleLife.set(999999999, 999999999);
-
-        this.__emitter.addLayer(this.__layer);
-
-        this.__emitter_entity = new Entity()
-            .add(this.__emitter)
-            .add(new Transform())
-            .add(SerializationMetadata.Transient);
-    }
-
-    __copy_transform() {
-
-        /**
-         *
-         * @type {Transform}
-         */
-        const transform = this.components[1];
-
-        this.__emitter_entity.getComponent(Transform).copy(transform);
-
-        const emitter = this.__emitter;
-
-
-        emitter.particles?.writeAttributeVector3(0, PARTICLE_ATTRIBUTE_POSITION, transform.position.x, transform.position.y, transform.position.z);
-
-        emitter.setFlag(ParticleEmitterFlag.ParticleBoundsNeedUpdate);
-
-    }
-
-    link() {
-        if (this.__is_linked) {
-            return;
-        }
-
-        super.link();
-
-
-        /**
-         *
-         * @type {Transform}
-         */
-        const transform = this.components[1];
-
-        transform.position.onChanged.add(this.__copy_transform, this);
-        transform.scale.onChanged.add(this.__copy_transform, this);
-
-        /**
-         *
-         * @type {Sprite}
-         */
-        const sprite = this.components[0];
-
-        this.__layer.imageURL = sprite.url;
-        this.__layer.particleSize.set(sprite.size, sprite.size);
-
-        const emitter = this.__emitter;
-
-        if (!emitter.getFlag(ParticleEmitterFlag.Built)) {
-            //particle pool needs to be set up first
-            emitter.build();
-        }
-
-        if (!emitter.getFlag(ParticleEmitterFlag.Initialized)) {
-            //particles are not initialized, do that
-            emitter.initialize();
-        }
-
-        emitter.particles?.writeAttributeVector4(
-            0, PARTICLE_ATTRIBUTE_COLOR,
-            float_to_uint8(sprite.color.r), float_to_uint8(sprite.color.g), float_to_uint8(sprite.color.b), float_to_uint8(sprite.opacity.getValue())
-        );
-
-
-        this.__copy_transform();
-
-        emitter.computeBoundingBox();
-
-        this.__emitter_entity.build(this.getDataset());
-    }
-
-    unlink() {
-        if (!this.__is_linked) {
-            return;
-        }
-
-        /**
-         *
-         * @type {Transform}
-         */
-        const transform = this.components[1];
-
-        transform.position.onChanged.remove(this.__copy_transform, this);
-        transform.scale.onChanged.remove(this.__copy_transform, this);
-
-        super.unlink();
-
-        this.__emitter_entity.destroy();
-    }
-}
-
-export class SpriteSystemPE extends AbstractContextSystem {
-    dependencies = [Sprite, Transform];
-
-    constructor() {
-        super(Context);
-    }
-}
+import { float_to_uint8 } from "../../../../core/binary/float_to_uint8.js";
+import { SerializationMetadata } from "../../../ecs/components/SerializationMetadata.js";
+import Entity from "../../../ecs/Entity.js";
+import { AbstractContextSystem } from "../../../ecs/system/AbstractContextSystem.js";
+import { SystemEntityContext } from "../../../ecs/system/SystemEntityContext.js";
+import { Transform } from "../../../ecs/transform/Transform.js";
+import {
+    PARTICLE_ATTRIBUTE_COLOR,
+    PARTICLE_ATTRIBUTE_POSITION
+} from "../../particles/particular/engine/emitter/PARTICLE_ATTRIBUTES.js";
+import { ParticleEmitter } from "../../particles/particular/engine/emitter/ParticleEmitter.js";
+import { ParticleEmitterFlag } from "../../particles/particular/engine/emitter/ParticleEmitterFlag.js";
+import { ParticleLayer } from "../../particles/particular/engine/emitter/ParticleLayer.js";
+import { Sprite } from "./Sprite.js";
+
+class Context extends SystemEntityContext {
+    constructor() {
+        super();
+
+        this.__emitter = new ParticleEmitter();
+        this.__layer = new ParticleLayer();
+
+        this.__layer.emissionRate = 0;
+        this.__layer.emissionImmediate = 1;
+        this.__layer.steps.reset();
+        this.__layer.particleLife.set(999999999, 999999999);
+
+        this.__emitter.addLayer(this.__layer);
+
+        this.__emitter_entity = new Entity()
+            .add(this.__emitter)
+            .add(new Transform())
+            .add(SerializationMetadata.Transient);
+    }
+
+    __copy_transform() {
+
+        /**
+         *
+         * @type {Transform}
+         */
+        const transform = this.components[1];
+
+        this.__emitter_entity.getComponent(Transform).copy(transform);
+
+        const emitter = this.__emitter;
+
+
+        emitter.particles?.writeAttributeVector3(0, PARTICLE_ATTRIBUTE_POSITION, transform.position.x, transform.position.y, transform.position.z);
+
+        emitter.setFlag(ParticleEmitterFlag.ParticleBoundsNeedUpdate);
+
+    }
+
+    link() {
+        if (this.__is_linked) {
+            return;
+        }
+
+        super.link();
+
+
+        /**
+         *
+         * @type {Transform}
+         */
+        const transform = this.components[1];
+
+        /**
+         *
+         * @type {Sprite}
+         */
+        const sprite = this.components[0];
+
+        this.__layer.imageURL = sprite.url;
+        this.__layer.particleSize.set(sprite.size, sprite.size);
+
+        const emitter = this.__emitter;
+
+        if (!emitter.getFlag(ParticleEmitterFlag.Built)) {
+            //particle pool needs to be set up first
+            emitter.build();
+        }
+
+        if (!emitter.getFlag(ParticleEmitterFlag.Initialized)) {
+            //particles are not initialized, do that
+            emitter.initialize();
+        }
+
+        emitter.particles?.writeAttributeVector4(
+            0, PARTICLE_ATTRIBUTE_COLOR,
+            float_to_uint8(sprite.color.r), float_to_uint8(sprite.color.g), float_to_uint8(sprite.color.b), float_to_uint8(sprite.opacity.getValue())
+        );
+
+
+        this.__copy_transform();
+
+        // subscribed only once the emitter is built and seeded: a throw above this point would
+        // otherwise leave the callback wired to a live transform whose every move re-throws, and
+        // Signal swallows handler errors, so it would never surface as anything but log noise
+        transform.position.onChanged.add(this.__copy_transform, this);
+        transform.scale.onChanged.add(this.__copy_transform, this);
+
+        emitter.computeBoundingBox();
+
+        this.__emitter_entity.build(this.getDataset());
+    }
+
+    unlink() {
+        if (!this.__is_linked) {
+            return;
+        }
+
+        /**
+         *
+         * @type {Transform}
+         */
+        const transform = this.components[1];
+
+        transform.position.onChanged.remove(this.__copy_transform, this);
+        transform.scale.onChanged.remove(this.__copy_transform, this);
+
+        super.unlink();
+
+        this.__emitter_entity.destroy();
+    }
+}
+
+export class SpriteSystemPE extends AbstractContextSystem {
+    dependencies = [Sprite, Transform];
+
+    constructor() {
+        super(Context);
+    }
+}

package/src/engine/graphics/particles/particular/engine/emitter/ParticleEmitter.d.ts

@@ -109,12 +109,20 @@ export class ParticleEmitter {
     toJSON(): {
         position: {
             x: number;
-            y: number;
+            y: number; /**
+             * @private
+             * @param {int} layerIndex
+             * @param {number} timeDelta period over which particles are being spawned, this will ensure that spawned particles have different initial age
+             */
             z: number;
         };
         scale: {
             x: number;
-            y: number;
+            y: number; /**
+             * @private
+             * @param {int} layerIndex
+             * @param {number} timeDelta period over which particles are being spawned, this will ensure that spawned particles have different initial age
+             */
             z: number;
         };
         rotation: {
@@ -214,7 +222,12 @@ export class ParticleEmitter {
      */
     private emit;
     /**
-     * Cleanup used resources
+     * Cleanup used resources, returning the emitter to its pre-{@link build} state.
+     *
+     * The pool and the parameter tracks are what `build` produces, so dropping them has to drop
+     * the flags that say they exist as well - a disposed emitter that still reads as `Built` gets
+     * written into by whoever picks it up next, and the pool it writes into has no attributes left.
+     * {@link ParticleEmitterSystem3#rebuild} clears the same pair before building again.
      */
     dispose(): void;
     #private;

package/src/engine/graphics/particles/particular/engine/emitter/ParticleEmitter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ParticleEmitter.d.ts","sourceRoot":"","sources":["../../../../../../../../src/engine/graphics/particles/particular/engine/emitter/ParticleEmitter.js"],"names":[],"mappings":"AAuFA;IAqgCI;;;;OAIG;IACH,4BAFa,eAAe,CAM3B;IA7gCD;;OAEG;IACH,IAFU,MAAM,CAEE;IAElB;;;;OAIG;IACH,wBAAoB;IAEpB;;;OAGG;IACH,UAFU,OAAO,CAEe;IAChC,eAA6B;IAC7B,qBAAsC;IAEtC;;;;;OAKG;IACH,qCAA2C;IAE3C;;;;OAIG;IACH,WAFU,MAAM,CAEF;IAEd;;;OAGG;IACH,cAFU,YAAY,GAAC,MAAM,CAEM;IAEnC;;;OAGG;IACH,WAFU,YAAY,GAAC,IAAI,CAEV;IAEjB;;;OAGG;IACH,mBAFU,SAAS,CAEQ;IAG3B;;;;OAIG;IACH,yBAFU,KAAK,CAE2E;IAE1F;;;OAGG;IACH,yBAFU,KAAK,CAE8B;IAG7C;;;OAGG;IACH,OAFU,MAAM,CAE6F;IAE7G;;;;OAIG;IACH,eAAW;IAGX;;;OAGG;IACH,qBAFU,YAAY,CAEU;IAWhC,wBAIC;IAED;;;;OAIG;IACH,cAHW,MAAM,GAAC,mBAAmB,GACxB,IAAI,CAIhB;IAED;;;;OAIG;IACH,gBAHW,MAAM,GAAC,mBAAmB,GACxB,IAAI,CAIhB;IAED;;;;OAIG;IACH,gBAHW,MAAM,GAAC,mBAAmB,SAC1B,OAAO,QAQjB;IAED;;;;OAIG;IACH,cAHW,MAAM,GAAC,mBAAmB,GACxB,OAAO,CAInB;IAED;;OAEG;IACH,gCAaC;IAED;;;;;;;;;;;;;;;;;;;;;;;;;;MAeC;IAED,0BAkEC;IAGD;;;OAGG;IACH,gBAFW,aAAa,QASvB;IAED;;;;OAIG;IACH,gCAHmB,aAAa,SAAS,MAAM,KAAK,IAAI,uBAavD;IAED;;;;OAIG;IACH,iCAHW,aAAa,GACZ,MAAM,CA2CjB;IAED,8BA0DC;IAED,8BAiBC;IAED,2BAmBC;IAED;;;OAGG;IACH,uCAHW,MAAM,GACJ,MAAM,CA+BlB;IAED,cAoBC;IAED,mBA6BC;IAuBD,eAOC;IAED;;;;OAIG;IACH,cAHW,eAAe,GACb,OAAO,CASnB;IAED;;;;;;;;;;;;;;;OAeG;IACH,kBAJW,MAAM,eACN,MAAM,eACN,MAAM,QA4FhB;IAED,eAOC;IAED;;;OAGG;IACH,4BAFY,MAAM,CAejB;IAED;;;OAGG;IACH,mBAFW,MAAM,QAMhB;IAiCD;;;;OAIG;IACH,sCA+GC;IAED;;;;OAIG;IACH,qCA6GC;IAED;;;OAGG;IACH,aA4CC;IAGD;;OAEG;IACH,gBAIC;;CAYJ;;;;;;;;;;;;;;;;oBA3lCmB,wCAAwC;uBAFrC,2CAA2C;6BAMrC,6CAA6C;6BAqB7C,mBAAmB;0BAnCtB,+CAA+C;sBAInD,8CAA8C;6BAWvC,8BAA8B;oCAiBvB,0BAA0B;8BAChC,oBAAoB;uCAF3C,0BAA0B;6CAA1B,0BAA0B;kDAA1B,0BAA0B;4CAA1B,0BAA0B;4CAA1B,0BAA0B;kDAA1B,0BAA0B;wCAA1B,0BAA0B;sCAA1B,0BAA0B;4CAA1B,0BAA0B;AASjC,yCAKC"}
+{"version":3,"file":"ParticleEmitter.d.ts","sourceRoot":"","sources":["../../../../../../../../src/engine/graphics/particles/particular/engine/emitter/ParticleEmitter.js"],"names":[],"mappings":"AAuFA;IA6gCI;;;;OAIG;IACH,4BAFa,eAAe,CAM3B;IArhCD;;OAEG;IACH,IAFU,MAAM,CAEE;IAElB;;;;OAIG;IACH,wBAAoB;IAEpB;;;OAGG;IACH,UAFU,OAAO,CAEe;IAChC,eAA6B;IAC7B,qBAAsC;IAEtC;;;;;OAKG;IACH,qCAA2C;IAE3C;;;;OAIG;IACH,WAFU,MAAM,CAEF;IAEd;;;OAGG;IACH,cAFU,YAAY,GAAC,MAAM,CAEM;IAEnC;;;OAGG;IACH,WAFU,YAAY,GAAC,IAAI,CAEV;IAEjB;;;OAGG;IACH,mBAFU,SAAS,CAEQ;IAG3B;;;;OAIG;IACH,yBAFU,KAAK,CAE2E;IAE1F;;;OAGG;IACH,yBAFU,KAAK,CAE8B;IAG7C;;;OAGG;IACH,OAFU,MAAM,CAE6F;IAE7G;;;;OAIG;IACH,eAAW;IAGX;;;OAGG;IACH,qBAFU,YAAY,CAEU;IAWhC,wBAIC;IAED;;;;OAIG;IACH,cAHW,MAAM,GAAC,mBAAmB,GACxB,IAAI,CAIhB;IAED;;;;OAIG;IACH,gBAHW,MAAM,GAAC,mBAAmB,GACxB,IAAI,CAIhB;IAED;;;;OAIG;IACH,gBAHW,MAAM,GAAC,mBAAmB,SAC1B,OAAO,QAQjB;IAED;;;;OAIG;IACH,cAHW,MAAM,GAAC,mBAAmB,GACxB,OAAO,CAInB;IAED;;OAEG;IACH,gCAaC;IAED;;;uBA6jBA;;;;eAIG;;;;;uBAJH;;;;eAIG;;;;;;;;;;;;;;;;;;MAljBF;IAED,0BAkEC;IAGD;;;OAGG;IACH,gBAFW,aAAa,QASvB;IAED;;;;OAIG;IACH,gCAHmB,aAAa,SAAS,MAAM,KAAK,IAAI,uBAavD;IAED;;;;OAIG;IACH,iCAHW,aAAa,GACZ,MAAM,CA2CjB;IAED,8BA0DC;IAED,8BAiBC;IAED,2BAmBC;IAED;;;OAGG;IACH,uCAHW,MAAM,GACJ,MAAM,CA+BlB;IAED,cAoBC;IAED,mBA6BC;IAuBD,eAOC;IAED;;;;OAIG;IACH,cAHW,eAAe,GACb,OAAO,CASnB;IAED;;;;;;;;;;;;;;;OAeG;IACH,kBAJW,MAAM,eACN,MAAM,eACN,MAAM,QA4FhB;IAED,eAOC;IAED;;;OAGG;IACH,4BAFY,MAAM,CAejB;IAED;;;OAGG;IACH,mBAFW,MAAM,QAMhB;IAiCD;;;;OAIG;IACH,sCA+GC;IAED;;;;OAIG;IACH,qCA6GC;IAED;;;OAGG;IACH,aA4CC;IAGD;;;;;;;OAOG;IACH,gBAOC;;CAYJ;;;;;;;;;;;;;;;;oBAnmCmB,wCAAwC;uBAFrC,2CAA2C;6BAMrC,6CAA6C;6BAqB7C,mBAAmB;0BAnCtB,+CAA+C;sBAInD,8CAA8C;6BAWvC,8BAA8B;oCAiBvB,0BAA0B;8BAChC,oBAAoB;uCAF3C,0BAA0B;6CAA1B,0BAA0B;kDAA1B,0BAA0B;4CAA1B,0BAA0B;4CAA1B,0BAA0B;kDAA1B,0BAA0B;wCAA1B,0BAA0B;sCAA1B,0BAA0B;4CAA1B,0BAA0B;AASjC,yCAKC"}