@woosh/meep-engine 3.32.0 → 3.34.0

package/src/engine/animation/removeEntityWithMeshParticlesEffect.js

@@ -1,194 +0,0 @@
-import { SGMesh } from "../graphics/ecs/mesh-v2/aggregate/SGMesh.js";
-import { SerializationMetadata } from "../ecs/components/SerializationMetadata.js";
-import { removeComponentsExcept } from "../ecs/util/removeComponentsExcept.js";
-import { ParticleEmitter } from "../graphics/particles/particular/engine/emitter/ParticleEmitter.js";
-import Trail2D from "../graphics/ecs/trail2d/Trail2D.js";
-import { Transform64 } from "../ecs/transform/Transform64.js";
-import Entity from "../ecs/Entity.js";
-import { stopEntityAndNotifyWhenStopped } from "./AnimatedActions.js";
-
-const lib = {
-    'mesh-cloud-puff-0': {
-        "position": {
-            "x": 9.17416,
-            "y": -1.90031,
-            "z": 12.06082
-        },
-        "scale": {
-            "x": 1,
-            "y": 1,
-            "z": 1
-        },
-        "rotation": {
-            "x": 0,
-            "y": 0,
-            "z": 0,
-            "w": 1
-        },
-        "parameters": [
-            {
-                "name": "scale",
-                "itemSize": 1,
-                "defaultTrackValue": {
-                    "itemSize": 1,
-                    "data": [
-                        1
-                    ],
-                    "positions": [
-                        0
-                    ]
-                }
-            },
-            {
-                "name": "color",
-                "itemSize": 4,
-                "defaultTrackValue": {
-                    "itemSize": 4,
-                    "data": [
-                        1,
-                        1,
-                        1,
-                        1
-                    ],
-                    "positions": [
-                        0
-                    ]
-                }
-            }
-        ],
-        "preWarm": false,
-        "readDepth": true,
-        "softDepth": true,
-        "blendingMode": 0,
-        "layers": [
-            {
-                "imageURL": "data/textures/particle/smokeparticle.png",
-                "particleLife": {
-                    "min": 0.6,
-                    "max": 1.2
-                },
-                "particleSize": {
-                    "min": 0.2,
-                    "max": 0.3
-                },
-                "particleRotation": {
-                    "min": 0,
-                    "max": 0
-                },
-                "particleRotationSpeed": {
-                    "min": 0,
-                    "max": 0
-                },
-                "emissionShape": 1,
-                "emissionFrom": 1,
-                "emissionRate": 0,
-                "emissionImmediate": 1200,
-                "parameterTracks": [
-                    {
-                        "name": "color",
-                        "track": {
-                            "itemSize": 4,
-                            "data": [
-                                0.9803921568627451,
-                                0.9803921568627451,
-                                0.9803921568627451,
-                                0.3,
-                                0.9882352941176471,
-                                0.9882352941176471,
-                                0.9882352941176471,
-                                0.265,
-                                0.9882352941176471,
-                                0.9882352941176471,
-                                0.9882352941176471,
-                                0
-                            ],
-                            "positions": [
-                                0,
-                                0.7957639171068672,
-                                1
-                            ]
-                        }
-                    }
-                ],
-                "position": {
-                    "x": 0,
-                    "y": 0.6,
-                    "z": 0
-                },
-                "scale": {
-                    "x": 0.9,
-                    "y": 0.5,
-                    "z": 0.65
-                },
-                "particleVelocityDirection": {
-                    "direction": {
-                        "x": 0,
-                        "y": 1,
-                        "z": 0
-                    },
-                    "angle": 0
-                },
-                "particleSpeed": {
-                    "min": 0.6,
-                    "max": 1.1
-                }
-            }
-        ]
-    }
-};
-
-/**
- *
- * @param {Object} options
- * @param {EntityManager} options.entityManager
- * @param {EntityComponentDataset} options.ecd
- * @param {number} options.entity
- * @param {string} options.particles
- * @returns {Promise<any>}
- */
-export function removeEntityWithMeshParticlesEffect(
-    {
-        entityManager,
-        ecd,
-        entity,
-        particles = 'mesh-cloud-puff-0'
-    }
-) {
-
-    const emitter = ParticleEmitter.fromJSON(lib[particles]);
-
-    //prevent further interactions
-    removeComponentsExcept(ecd, entity, [SGMesh, ParticleEmitter, Trail2D, Transform64]);
-
-    //make entity volatile so it does not end up in game saves. The entity is mid-death here;
-    //without this a save taken during the effect would restore a corpse that never finishes dying.
-    ecd.addComponentToEntity(entity, SerializationMetadata.Transient);
-
-    /**
-     *
-     * @type {Transform64}
-     */
-    const originalTransform = ecd.getComponent(entity, Transform64);
-
-    if (originalTransform === undefined) {
-        throw new Error(`entity ${entity} doesn't have Transform`);
-    }
-
-    //create particle emitter
-    const effectBuilder = new Entity();
-    const effectEntity = effectBuilder
-        .add(emitter)
-        .add(originalTransform.clone())
-        .build(ecd);
-
-    Promise.all([
-        stopEntityAndNotifyWhenStopped(effectEntity, ecd)
-    ])
-        .then(() => effectBuilder.destroy());
-
-    return stopEntityAndNotifyWhenStopped(entity, ecd)
-        .then(() => {
-            ecd.removeEntity(entity);
-        });
-
-}

package/src/engine/graphics/ecs/sprite/Sprite.d.ts

@@ -1,12 +0,0 @@
-export class Sprite {
-    size: number;
-    url: string;
-    opacity: Vector1;
-    color: Color;
-}
-export namespace Sprite {
-    let typeName: string;
-}
-import Vector1 from "../../../../core/geom/Vector1.js";
-import { Color } from "../../../../core/color/Color.js";
-//# sourceMappingURL=Sprite.d.ts.map

package/src/engine/graphics/ecs/sprite/Sprite.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"Sprite.d.ts","sourceRoot":"","sources":["../../../../../../src/engine/graphics/ecs/sprite/Sprite.js"],"names":[],"mappings":"AAGA;IACI,aAAS;IACT,YAAS;IACT,iBAAyB;IACzB,aAA2B;CAC9B;;;;oBARmB,kCAAkC;sBAChC,iCAAiC"}

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

@@ -1,11 +0,0 @@
-import Vector1 from "../../../../core/geom/Vector1.js";
-import { Color } from "../../../../core/color/Color.js";
-
-export class Sprite {
-    size = 1;
-    url = "";
-    opacity = new Vector1(1);
-    color = new Color(1, 1, 1);
-}
-
-Sprite.typeName = "Sprite";

package/src/engine/graphics/ecs/sprite/SpriteSystemPE.d.ts

@@ -1,8 +0,0 @@
-export class SpriteSystemPE extends AbstractContextSystem<any> {
-    constructor();
-    dependencies: (typeof Transform64 | typeof Sprite)[];
-}
-import { AbstractContextSystem } from "../../../ecs/system/AbstractContextSystem.js";
-import { Transform64 } from "../../../ecs/transform/Transform64.js";
-import { Sprite } from "./Sprite.js";
-//# sourceMappingURL=SpriteSystemPE.d.ts.map

package/src/engine/graphics/ecs/sprite/SpriteSystemPE.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"SpriteSystemPE.d.ts","sourceRoot":"","sources":["../../../../../../src/engine/graphics/ecs/sprite/SpriteSystemPE.js"],"names":[],"mappings":"AAsIA;IAGI,cAEC;IAJD,qDAAqC;CAKxC;sCAzIqC,8CAA8C;4BAGxD,uCAAuC;uBAQ5C,aAAa"}

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

@@ -1,141 +0,0 @@
-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 { TRANSFORM64_EVENT_CHANGE } from "../../../ecs/transform/TRANSFORM64_EVENT_CHANGE.js";
-import { Transform64 } from "../../../ecs/transform/Transform64.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 Transform64())
-            .add(SerializationMetadata.Transient);
-    }
-
-    __copy_transform() {
-
-        /**
-         *
-         * @type {Transform64}
-         */
-        const transform = this.components[1];
-
-        this.__emitter_entity.getComponent(Transform64).copy(transform);
-
-        const emitter = this.__emitter;
-
-
-        emitter.particles?.writeAttributeVector3(0, PARTICLE_ATTRIBUTE_POSITION, transform.translation_x, transform.translation_y, transform.translation_z);
-
-        emitter.setFlag(ParticleEmitterFlag.ParticleBoundsNeedUpdate);
-
-    }
-
-    link() {
-        if (this.__is_linked) {
-            return;
-        }
-
-        super.link();
-
-
-        /**
-         *
-         * @type {Transform64}
-         */
-        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 entity whose every move re-throws, and
-        // Signal swallows handler errors, so it would never surface as anything but log noise.
-        //
-        // One listener where there were two, because a Transform64 announces itself whole rather
-        // than through a sub-object per component.
-        this.__on_transform_changed = () => this.__copy_transform();
-
-        this.getDataset().addEntityEventListener(
-            this.entity, TRANSFORM64_EVENT_CHANGE, this.__on_transform_changed
-        );
-
-        emitter.computeBoundingBox();
-
-        this.__emitter_entity.build(this.getDataset());
-    }
-
-    unlink() {
-        if (!this.__is_linked) {
-            return;
-        }
-
-        if (this.__on_transform_changed !== undefined) {
-            this.getDataset().removeEntityEventListener(
-                this.entity, TRANSFORM64_EVENT_CHANGE, this.__on_transform_changed
-            );
-
-            this.__on_transform_changed = undefined;
-        }
-
-        super.unlink();
-
-        this.__emitter_entity.destroy();
-    }
-}
-
-export class SpriteSystemPE extends AbstractContextSystem {
-    dependencies = [Sprite, Transform64];
-
-    constructor() {
-        super(Context);
-    }
-}

package/src/engine/graphics/particles/particular/engine/MovingBoundingBox.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"MovingBoundingBox.d.ts","sourceRoot":"","sources":["../../../../../../../src/engine/graphics/particles/particular/engine/MovingBoundingBox.js"],"names":[],"mappings":"AAcA;;GAEG;AACH;IACI;;;OAGG;IACH,QAFU,MAAM,CAEL;IAEX;;;OAGG;IACH,cAFU,KAAK,CAE4B;IAE3C;;;OAGG;IACH,aAFU,KAAK,CAE2B;IAE1C;;;OAGG;IACH,kBAFU,aAAa,CAEoC;IAE3D;;;OAGG;IACH,UAFU,OAAO,CAEQ;IAEzB;;;OAGG;IACH,MAFU,MAAM,CAEP;IAET;;;OAGG;IACH,kBAFW,MAAM,QAKhB;IAED,uBAwBC;IAED,2BAgCC;IAED;;;;;OAKG;IACH,QAJW,MAAM,KACN,MAAM,KACN,MAAM,QAyBhB;CACJ;sBAtJqB,2CAA2C;8BAFnC,uDAAuD;oBAGjE,qCAAqC"}

package/src/engine/graphics/particles/particular/engine/ParticularEngine.d.ts

@@ -1,61 +0,0 @@
-export class ParticularEngine {
-    /**
-     *
-     * @param {AssetManager} assetManager
-     * @constructor
-     */
-    constructor(assetManager: AssetManager);
-    /**
-     * Managed emitters
-     * @type {List.<ParticleEmitter>}
-     */
-    emitters: List<ParticleEmitter>;
-    /**
-     * @readonly
-     * @type {BVH}
-     */
-    readonly bvh: BVH;
-    /**
-     *
-     * @type {AbstractSimulationStep[]}
-     */
-    steps: AbstractSimulationStep[];
-    shaderManager: ShaderManager;
-    /**
-     *
-     * @param {ParticleEmitter} emitter
-     */
-    add(emitter: ParticleEmitter): void;
-    /**
-     *
-     * @param {ParticleEmitter} emitter
-     * @returns {boolean}
-     */
-    remove(emitter: ParticleEmitter): boolean;
-    /**
-     * Hand back the resources held on behalf of the managed emitters. Emitters themselves are owned by
-     * their components and are disposed by {@link ParticleEmitter#dispose} as they are removed.
-     */
-    dispose(): void;
-    /**
-     * @private
-     * @param {ParticleEmitter} emitter
-     * @param {number} timeDelta
-     */
-    private advanceEmitter;
-    /**
-     * @private
-     * @param {ParticleEmitter} emitter
-     * @param {number} timeDelta
-     */
-    private updateEmitter;
-    /**
-     *
-     * @param {number} timeDelta
-     */
-    advance(timeDelta: number): void;
-}
-import List from "../../../../../core/collection/list/List.js";
-import { BVH } from "../../../../../core/bvh2/bvh3/BVH.js";
-import { ShaderManager } from "./shader/ShaderManager.js";
-//# sourceMappingURL=ParticularEngine.d.ts.map

package/src/engine/graphics/particles/particular/engine/ParticularEngine.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"ParticularEngine.d.ts","sourceRoot":"","sources":["../../../../../../../src/engine/graphics/particles/particular/engine/ParticularEngine.js"],"names":[],"mappings":"AAUA;IAyBI;;;;OAIG;IACH,wCAEC;IA/BD;;;OAGG;IACH,UAFU,qBAAsB,CAEV;IAEtB;;;OAGG;IACH,cAFU,GAAG,CAEG;IAGhB;;;OAGG;IACH,OAFU,wBAAwB,CAOhC;IAQE,6BAAoD;IAGxD;;;OAGG;IACH,oCAaC;IAED;;;;OAIG;IACH,kCAFa,OAAO,CAenB;IAED;;;OAGG;IACH,gBAEC;IAED;;;;OAIG;IACH,uBAsEC;IAED;;;;OAIG;IACH,sBAuCC;IAED;;;OAGG;IACH,mBAFW,MAAM,QAWhB;CACJ;iBAnOgB,6CAA6C;oBAD1C,sCAAsC;8BAG5B,2BAA2B"}

package/src/engine/graphics/particles/particular/engine/ParticularEngine.js

@@ -1,229 +0,0 @@
-import { BVH } from "../../../../../core/bvh2/bvh3/BVH.js";
-import List from "../../../../../core/collection/list/List.js";
-import { ParticleEmitterFlag } from "./emitter/ParticleEmitterFlag.js";
-import { ShaderManager } from "./shader/ShaderManager.js";
-import { SimulationStepApplyForce } from "./simulator/SimulationStepApplyForce.js";
-import { SimulationStepCurlNoiseAcceleration } from "./simulator/SimulationStepCurlNoiseAcceleration.js";
-import { SimulationStepCurlNoiseVelocity } from "./simulator/SimulationStepCurlNoiseVelocity.js";
-import { SimulationStepFixedPhysics } from "./simulator/SimulationStepFixedPhysics.js";
-
-
-export class ParticularEngine {
-    /**
-     * Managed emitters
-     * @type {List.<ParticleEmitter>}
-     */
-    emitters = new List();
-
-    /**
-     * @readonly
-     * @type {BVH}
-     */
-    bvh = new BVH();
-
-
-    /**
-     *
-     * @type {AbstractSimulationStep[]}
-     */
-    steps = [
-        new SimulationStepFixedPhysics(),
-        new SimulationStepCurlNoiseAcceleration(),
-        new SimulationStepCurlNoiseVelocity(),
-        new SimulationStepApplyForce()
-    ];
-
-    /**
-     *
-     * @param {AssetManager} assetManager
-     * @constructor
-     */
-    constructor(assetManager) {
-        this.shaderManager = new ShaderManager(assetManager);
-    }
-
-    /**
-     *
-     * @param {ParticleEmitter} emitter
-     */
-    add(emitter) {
-        if (!emitter.getFlag(ParticleEmitterFlag.Built)) {
-            emitter.build();
-        }
-
-        //mark sprites for update as their UVs might have changed since last usage
-        emitter.setFlag(ParticleEmitterFlag.SpritesNeedUpdate);
-
-        this.emitters.add(emitter);
-
-        this.shaderManager.register(emitter);
-
-        emitter.bvh_leaf.link(this.bvh, emitter.id);
-    }
-
-    /**
-     *
-     * @param {ParticleEmitter} emitter
-     * @returns {boolean}
-     */
-    remove(emitter) {
-
-        const removed = this.emitters.removeOneOf(emitter);
-
-        if (!removed) {
-            return false;
-        }
-
-        this.shaderManager.deregister(emitter);
-
-        emitter.bvh_leaf.unlink();
-
-        return true;
-    }
-
-    /**
-     * Hand back the resources held on behalf of the managed emitters. Emitters themselves are owned by
-     * their components and are disposed by {@link ParticleEmitter#dispose} as they are removed.
-     */
-    dispose() {
-        this.shaderManager.dispose();
-    }
-
-    /**
-     * @private
-     * @param {ParticleEmitter} emitter
-     * @param {number} timeDelta
-     */
-    advanceEmitter(emitter, timeDelta) {
-        let i, j;
-
-
-        /**
-         *
-         * @type {List<ParticleLayer>}
-         */
-        const layers = emitter.layers;
-
-        const layer_count = layers.length;
-
-        let step_mask = 0;
-
-        const steps = this.steps;
-
-        for (j = 0; j < layer_count; j++) {
-            const particleLayer = layers.get(j);
-
-            const simulationStepDefinitions = particleLayer.steps;
-
-            const n = simulationStepDefinitions.length;
-
-            for (i = 0; i < n; i++) {
-                /**
-                 *
-                 * @type {SimulationStepDefinition}
-                 */
-                const stepDefinition = simulationStepDefinitions.get(i);
-
-                const type = stepDefinition.type;
-
-                step_mask |= 1 << type;
-
-                const step = steps[type];
-
-                if (step === undefined) {
-                    // no step definition
-                    continue;
-                }
-
-                step.emitter = emitter;
-                step.timeDelta = timeDelta;
-                step.particles = emitter.particles;
-                step.layer_parameters[j] = stepDefinition.parameters;
-                step.includeLayer(j);
-
-            }
-        }
-
-        // apply simulation steps
-        const step_index_limit = steps.length;
-
-        for (i = 0; i < step_index_limit; i++) {
-            const m = 1 << i;
-            const is_used = (step_mask & m) !== 0;
-
-            if (is_used) {
-                const step = steps[i];
-
-                step.layer_count = layer_count;
-
-                step.execute();
-
-                step.clear();
-            }
-        }
-
-        emitter.advance(timeDelta);
-
-    }
-
-    /**
-     * @private
-     * @param {ParticleEmitter} emitter
-     * @param {number} timeDelta
-     */
-    updateEmitter(emitter, timeDelta) {
-        if (emitter.getFlag(ParticleEmitterFlag.Sleeping)) {
-            emitter.sleepTime += timeDelta;
-        } else {
-
-            if (!emitter.getFlag(ParticleEmitterFlag.Initialized)) {
-                emitter.initialize();
-            }
-
-            if (emitter.sleepTime > 0) {
-                //emitter was sleeping, need to catch up the simulation
-                const maxParticleLife = emitter.computeMaxEmittingParticleLife();
-
-                let wakingTime = Math.min(emitter.sleepTime, maxParticleLife - timeDelta);
-
-                const minWakingIncrement = 0.15;
-
-                const maxWakingSteps = 10;
-
-                const wakingIncrement = Math.max(wakingTime / maxWakingSteps, minWakingIncrement);
-
-                while (wakingTime > 0) {
-                    const wakingStep = Math.min(wakingIncrement, wakingTime);
-
-                    this.advanceEmitter(emitter, wakingStep);
-
-                    wakingTime -= wakingStep;
-                }
-
-                //consume the sleep time
-                emitter.sleepTime = 0;
-            }
-
-            //advance simulation
-            this.advanceEmitter(emitter, timeDelta);
-
-            //update bounding box
-            emitter.computeBoundingBox();
-        }
-    }
-
-    /**
-     *
-     * @param {number} timeDelta
-     */
-    advance(timeDelta) {
-        const emitters = this.emitters;
-
-        const numEmitters = emitters.length;
-
-        for (let i = 0; i < numEmitters; i++) {
-            const emitter = emitters.get(i);
-            this.updateEmitter(emitter, timeDelta);
-        }
-    }
-}

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

@@ -1,6 +0,0 @@
-export type EmissionFromType = number;
-export namespace EmissionFromType {
-    let Shell: number;
-    let Volume: number;
-}
-//# sourceMappingURL=EmissionFromType.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"EmissionFromType.d.ts","sourceRoot":"","sources":["../../../../../../../../src/engine/graphics/particles/particular/engine/emitter/EmissionFromType.js"],"names":[],"mappings":"+BAEU,MAAM"}

package/src/engine/graphics/particles/particular/engine/emitter/EmissionFromType.js

@@ -1,8 +0,0 @@
-/**
- * @readonly
- * @enum {number}
- */
-export const EmissionFromType = {
-    Shell: 0,
-    Volume: 1
-};