@woosh/meep-engine 3.15.0 → 3.16.0

package/src/engine/animation/AnimationUtils.js

@@ -1,234 +1,246 @@
-import { SerializationMetadata } from "../ecs/components/SerializationMetadata.js";
-import Entity from "../ecs/Entity.js";
-import { Transform } from "../ecs/transform/Transform.js";
-import { whenAllEntitiesDestroyed, whenEntityDestroyed } from "../ecs/util/EntityBuilderUtils.js";
-import { removeComponentsExcept } from "../ecs/util/removeComponentsExcept.js";
-import { createSound, createTimer } from "../EntityCreator.js";
-import { SGMesh } from "../graphics/ecs/mesh-v2/aggregate/SGMesh.js";
-import Trail2D from "../graphics/ecs/trail2d/Trail2D.js";
-import { Trail2DFlags } from "../graphics/ecs/trail2d/Trail2DFlags.js";
-import { ParticleEmitter } from "../graphics/particles/particular/engine/emitter/ParticleEmitter.js";
-import { ParticleEmitterFlag } from "../graphics/particles/particular/engine/emitter/ParticleEmitterFlag.js";
-import { SequenceBehavior } from "../intelligence/behavior/composite/SequenceBehavior.js";
-import { BehaviorComponent } from "../intelligence/behavior/ecs/BehaviorComponent.js";
-import { DieBehavior } from "../intelligence/behavior/ecs/DieBehavior.js";
-import { ActionBehavior } from "../intelligence/behavior/primitive/ActionBehavior.js";
-import { DelayBehavior } from "../intelligence/behavior/util/DelayBehavior.js";
-import { stopEntityAndNotifyWhenStopped } from "./AnimatedActions.js";
-import AnimationTrack from "./keyed2/AnimationTrack.js";
-import AnimationTrackPlayback from "./keyed2/AnimationTrackPlayback.js";
-import { playAnimationTrack } from "./playAnimationTrack.js";
-import TransitionFunctions from "./TransitionFunctions.js";
-
-/**
- *
- * @param {number} entity
- * @param {EntityComponentDataset} ecd
- * @returns {Promise}
- */
-export function stopTrailAndNotifyOnceFinished(entity, ecd) {
-    return new Promise((resolve, reject) => {
-        if (!ecd.entityExists(entity)) {
-            resolve();
-            return;
-        }
-
-        const trail = ecd.getComponent(entity, Trail2D);
-
-        if (trail === undefined) {
-            resolve();
-            return;
-        }
-
-        trail.clearFlag(Trail2DFlags.Spawning);
-
-        new Entity()
-            .add(BehaviorComponent.from(SequenceBehavior.from([
-                DelayBehavior.fromJSON({ value: trail.maxAge }),
-                new ActionBehavior(resolve)
-            ])))
-            .build(ecd);
-    });
-}
-
-/**
- *
- * @param {number} entity
- * @param {EntityComponentDataset} ecd
- * @returns {Promise}
- */
-export function stopEmitterAndNotifyOnceFinished(entity, ecd) {
-    return new Promise(function (resolve, reject) {
-        if (!ecd.entityExists(entity)) {
-            console.warn(`Entity ${entity} doesn't exist`);
-
-            resolve();
-            return;
-        }
-
-        /**
-         *
-         * @type {ParticleEmitter}
-         */
-        const emitter = ecd.getComponent(entity, ParticleEmitter);
-
-        if (emitter === undefined) {
-            console.warn(`Entity ${entity} doesn't have ParticleEmitter component`);
-
-            resolve();
-            return;
-        }
-
-        //stop emission
-        emitter.clearFlag(ParticleEmitterFlag.Emitting);
-
-
-        //figure out how long the emitter should stay alive
-        const maxLife = emitter.computeMaxEmittingParticleLife();
-
-        //wait out the particles that are already in flight, then report and clean up
-        new Entity()
-            .add(SerializationMetadata.Transient)
-            .add(BehaviorComponent.from(SequenceBehavior.from([
-                DelayBehavior.from(maxLife),
-                new ActionBehavior(resolve),
-                DieBehavior.create()
-            ])))
-            .build(ecd);
-    });
-}
-
-
-/**
- *
- * @param {number} entity
- * @param {EntityComponentDataset} ecd
- * @returns {Promise}
- */
-export function shutdownParticleEmitter(entity, ecd) {
-    const promise = stopEmitterAndNotifyOnceFinished(entity, ecd);
-
-
-    const MAX_PARTICLE_LIFE = 10;
-
-    /**
-     *
-     * @type {ParticleEmitter}
-     */
-    const particleEmitter = ecd.getComponent(entity, ParticleEmitter);
-
-    if (particleEmitter !== undefined) {
-
-        //destroy any particles that have very long lifespan
-
-        particleEmitter.traverseLayers((layer) => {
-            const maxParticleLife = layer.particleLife.max;
-
-            if (layer.emissionRate <= 0 && layer.emissionImmediate <= 0) {
-                //skip layers with no emission
-                return;
-            }
-
-            if (maxParticleLife > MAX_PARTICLE_LIFE) {
-                particleEmitter.destroyParticlesFromLayer(layer);
-            }
-        });
-    }
-
-    return promise;
-}
-
-/**
- *
- * @param entity
- * @param {EntityComponentDataset} ecd
- * @param {ParticleEmitter} emitter
- * @param {String} soundEffect
- * @param {number} [timeout]
- * @returns {Promise}
- */
-export function removeEntityWithEffect({ entity, ecd, emitter, soundEffect, timeout }) {
-    /**
-     *
-     * @type {Transform}
-     */
-    const transform = ecd.getComponent(entity, Transform);
-
-    //prevent further interactions
-    removeComponentsExcept(ecd, entity, [SGMesh, ParticleEmitter, Trail2D, Transform]);
-
-    //make entity volatile so it does not end up in game saves
-    ecd.addComponentToEntity(entity, SerializationMetadata.Transient);
-
-    return new Promise((resolve, reject) => {
-
-        const entityStopped = stopEntityAndNotifyWhenStopped(entity, ecd);
-
-
-        const animationTrack = new AnimationTrack(['scale']);
-        animationTrack.addKey(0, [1]);
-        animationTrack.addKey(0.05, [1]);
-        animationTrack.addKey(0.27, [0]);
-        animationTrack.addTransition(0, TransitionFunctions.EaseOut);
-        animationTrack.addTransition(1, TransitionFunctions.EaseOut);
-
-
-        const originalScale = transform.scale.clone();
-
-        const trackPlayback = new AnimationTrackPlayback(animationTrack, function (s) {
-            transform.scale.copy(originalScale.clone().multiplyScalar(s));
-        }, null);
-
-        trackPlayback.on.ended.add(() => {
-            //remove mesh if it exists since scale is 0
-            ecd.removeComponentFromEntity(entity, SGMesh);
-        });
-
-        const eAnimation = playAnimationTrack(trackPlayback, ecd);
-
-        const entityRemoved = Promise.all([
-            whenEntityDestroyed(eAnimation),
-            entityStopped
-        ])
-            .then(() => {
-
-                //check that the entity exists
-                if (ecd.entityExists(entity)) {
-                    ecd.removeEntity(entity);
-                }
-
-            });
-
-        const t = new Transform();
-        t.copy(transform);
-
-        const emitterBuilder = new Entity();
-        emitterBuilder.add(t).add(emitter);
-        emitterBuilder.build(ecd);
-
-        const timer = createTimer({
-            timeout: emitter.layers.reduce((s, l) => {
-                return Math.max(s, l.particleLife.max)
-            }, 0),
-            action() {
-                emitterBuilder.destroy()
-            }
-        });
-
-        const sound = createSound({
-            position: transform.position,
-            url: soundEffect,
-            positioned: true
-        });
-
-        Promise.all([
-            entityRemoved,
-            whenAllEntitiesDestroyed([timer, sound])
-        ])
-            .then(resolve, reject);
-
-        timer.build(ecd);
-        sound.build(ecd);
-    });
-
-}
+import { SerializationMetadata } from "../ecs/components/SerializationMetadata.js";
+import Entity from "../ecs/Entity.js";
+import Vector3 from "../../core/geom/Vector3.js";
+import { Transform64 } from "../ecs/transform/Transform64.js";
+import { t64_announce_change } from "../ecs/transform/t64_announce_change.js";
+import { t64_read_translation } from "../ecs/transform/t64_read_translation.js";
+import { whenAllEntitiesDestroyed, whenEntityDestroyed } from "../ecs/util/EntityBuilderUtils.js";
+import { removeComponentsExcept } from "../ecs/util/removeComponentsExcept.js";
+import { createSound, createTimer } from "../EntityCreator.js";
+import { SGMesh } from "../graphics/ecs/mesh-v2/aggregate/SGMesh.js";
+import Trail2D from "../graphics/ecs/trail2d/Trail2D.js";
+import { Trail2DFlags } from "../graphics/ecs/trail2d/Trail2DFlags.js";
+import { ParticleEmitter } from "../graphics/particles/particular/engine/emitter/ParticleEmitter.js";
+import { ParticleEmitterFlag } from "../graphics/particles/particular/engine/emitter/ParticleEmitterFlag.js";
+import { SequenceBehavior } from "../intelligence/behavior/composite/SequenceBehavior.js";
+import { BehaviorComponent } from "../intelligence/behavior/ecs/BehaviorComponent.js";
+import { DieBehavior } from "../intelligence/behavior/ecs/DieBehavior.js";
+import { ActionBehavior } from "../intelligence/behavior/primitive/ActionBehavior.js";
+import { DelayBehavior } from "../intelligence/behavior/util/DelayBehavior.js";
+import { stopEntityAndNotifyWhenStopped } from "./AnimatedActions.js";
+import AnimationTrack from "./keyed2/AnimationTrack.js";
+import AnimationTrackPlayback from "./keyed2/AnimationTrackPlayback.js";
+import { playAnimationTrack } from "./playAnimationTrack.js";
+import TransitionFunctions from "./TransitionFunctions.js";
+
+/**
+ *
+ * @param {number} entity
+ * @param {EntityComponentDataset} ecd
+ * @returns {Promise}
+ */
+export function stopTrailAndNotifyOnceFinished(entity, ecd) {
+    return new Promise((resolve, reject) => {
+        if (!ecd.entityExists(entity)) {
+            resolve();
+            return;
+        }
+
+        const trail = ecd.getComponent(entity, Trail2D);
+
+        if (trail === undefined) {
+            resolve();
+            return;
+        }
+
+        trail.clearFlag(Trail2DFlags.Spawning);
+
+        new Entity()
+            .add(BehaviorComponent.from(SequenceBehavior.from([
+                DelayBehavior.fromJSON({ value: trail.maxAge }),
+                new ActionBehavior(resolve)
+            ])))
+            .build(ecd);
+    });
+}
+
+/**
+ *
+ * @param {number} entity
+ * @param {EntityComponentDataset} ecd
+ * @returns {Promise}
+ */
+export function stopEmitterAndNotifyOnceFinished(entity, ecd) {
+    return new Promise(function (resolve, reject) {
+        if (!ecd.entityExists(entity)) {
+            console.warn(`Entity ${entity} doesn't exist`);
+
+            resolve();
+            return;
+        }
+
+        /**
+         *
+         * @type {ParticleEmitter}
+         */
+        const emitter = ecd.getComponent(entity, ParticleEmitter);
+
+        if (emitter === undefined) {
+            console.warn(`Entity ${entity} doesn't have ParticleEmitter component`);
+
+            resolve();
+            return;
+        }
+
+        //stop emission
+        emitter.clearFlag(ParticleEmitterFlag.Emitting);
+
+
+        //figure out how long the emitter should stay alive
+        const maxLife = emitter.computeMaxEmittingParticleLife();
+
+        //wait out the particles that are already in flight, then report and clean up
+        new Entity()
+            .add(SerializationMetadata.Transient)
+            .add(BehaviorComponent.from(SequenceBehavior.from([
+                DelayBehavior.from(maxLife),
+                new ActionBehavior(resolve),
+                DieBehavior.create()
+            ])))
+            .build(ecd);
+    });
+}
+
+
+/**
+ *
+ * @param {number} entity
+ * @param {EntityComponentDataset} ecd
+ * @returns {Promise}
+ */
+export function shutdownParticleEmitter(entity, ecd) {
+    const promise = stopEmitterAndNotifyOnceFinished(entity, ecd);
+
+
+    const MAX_PARTICLE_LIFE = 10;
+
+    /**
+     *
+     * @type {ParticleEmitter}
+     */
+    const particleEmitter = ecd.getComponent(entity, ParticleEmitter);
+
+    if (particleEmitter !== undefined) {
+
+        //destroy any particles that have very long lifespan
+
+        particleEmitter.traverseLayers((layer) => {
+            const maxParticleLife = layer.particleLife.max;
+
+            if (layer.emissionRate <= 0 && layer.emissionImmediate <= 0) {
+                //skip layers with no emission
+                return;
+            }
+
+            if (maxParticleLife > MAX_PARTICLE_LIFE) {
+                particleEmitter.destroyParticlesFromLayer(layer);
+            }
+        });
+    }
+
+    return promise;
+}
+
+/**
+ *
+ * @param entity
+ * @param {EntityComponentDataset} ecd
+ * @param {ParticleEmitter} emitter
+ * @param {String} soundEffect
+ * @param {number} [timeout]
+ * @returns {Promise}
+ */
+export function removeEntityWithEffect({ entity, ecd, emitter, soundEffect, timeout }) {
+    /**
+     *
+     * @type {Transform64}
+     */
+    const transform = ecd.getComponent(entity, Transform64);
+
+    //prevent further interactions
+    removeComponentsExcept(ecd, entity, [SGMesh, ParticleEmitter, Trail2D, Transform64]);
+
+    //make entity volatile so it does not end up in game saves
+    ecd.addComponentToEntity(entity, SerializationMetadata.Transient);
+
+    return new Promise((resolve, reject) => {
+
+        const entityStopped = stopEntityAndNotifyWhenStopped(entity, ecd);
+
+
+        const animationTrack = new AnimationTrack(['scale']);
+        animationTrack.addKey(0, [1]);
+        animationTrack.addKey(0.05, [1]);
+        animationTrack.addKey(0.27, [0]);
+        animationTrack.addTransition(0, TransitionFunctions.EaseOut);
+        animationTrack.addTransition(1, TransitionFunctions.EaseOut);
+
+
+        const originalScale = new Vector3(
+            transform.scale_x, transform.scale_y, transform.scale_z
+        );
+
+        const trackPlayback = new AnimationTrackPlayback(animationTrack, function (s) {
+            transform.setScale(
+                originalScale.x * s, originalScale.y * s, originalScale.z * s
+            );
+
+            // a scale write leaves the matrix describing the previous size
+            transform.updateMatrix();
+
+            t64_announce_change(ecd, entity, transform);
+        }, null);
+
+        trackPlayback.on.ended.add(() => {
+            //remove mesh if it exists since scale is 0
+            ecd.removeComponentFromEntity(entity, SGMesh);
+        });
+
+        const eAnimation = playAnimationTrack(trackPlayback, ecd);
+
+        const entityRemoved = Promise.all([
+            whenEntityDestroyed(eAnimation),
+            entityStopped
+        ])
+            .then(() => {
+
+                //check that the entity exists
+                if (ecd.entityExists(entity)) {
+                    ecd.removeEntity(entity);
+                }
+
+            });
+
+        const t = new Transform64();
+        t.copy(transform);
+
+        const emitterBuilder = new Entity();
+        emitterBuilder.add(t).add(emitter);
+        emitterBuilder.build(ecd);
+
+        const timer = createTimer({
+            timeout: emitter.layers.reduce((s, l) => {
+                return Math.max(s, l.particleLife.max)
+            }, 0),
+            action() {
+                emitterBuilder.destroy()
+            }
+        });
+
+        const sound = createSound({
+            position: t64_read_translation(new Vector3(), transform),
+            url: soundEffect,
+            positioned: true
+        });
+
+        Promise.all([
+            entityRemoved,
+            whenAllEntitiesDestroyed([timer, sound])
+        ])
+            .then(resolve, reject);
+
+        timer.build(ecd);
+        sound.build(ecd);
+    });
+
+}

package/src/engine/animation/Animations.d.ts

@@ -27,5 +27,6 @@ declare function translate(entity: number, ecd: EntityComponentDataset, paramete
  * @returns {Tween}
  */
 declare function fade(entity: number, ecd: EntityComponentDataset, parameter: Vector3, time: number, transitionFunction: (x: number) => number): Tween;
+import Vector3 from "../../core/geom/Vector3.js";
 import Tween from "./Tween.js";
 //# sourceMappingURL=Animations.d.ts.map

package/src/engine/animation/Animations.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Animations.d.ts","sourceRoot":"","sources":["../../../../src/engine/animation/Animations.js"],"names":[],"mappings":";;;;;AAIA;;;;;;;;GAQG;AACH,mCAPW,MAAM,yDAGN,MAAM,0BACF,MAAM,KAAK,MAAM,GACnB,KAAK,CAcjB;AAED;;;;;;;;;;;;GAYG;AACH,8BAPW,MAAM,yDAGN,MAAM,0BACF,MAAM,KAAK,MAAM,GACnB,KAAK,CAsBjB;kBA1DiB,YAAY"}
+{"version":3,"file":"Animations.d.ts","sourceRoot":"","sources":["../../../../src/engine/animation/Animations.js"],"names":[],"mappings":";;;;;AAOA;;;;;;;;GAQG;AACH,mCAPW,MAAM,0CAEN,OAAO,QACP,MAAM,0BACF,MAAM,KAAK,MAAM,GACnB,KAAK,CAmBjB;AAED;;;;;;;;;;;;GAYG;AACH,8BAPW,MAAM,0CAEN,OAAO,QACP,MAAM,0BACF,MAAM,KAAK,MAAM,GACnB,KAAK,CAsBjB;oBAnEmB,4BAA4B;kBAI9B,YAAY"}

package/src/engine/animation/Animations.js

@@ -1,5 +1,8 @@
 import GUIElement from "../ecs/gui/GUIElement.js";
-import { Transform } from "../ecs/transform/Transform.js";
+import Vector3 from "../../core/geom/Vector3.js";
+import { Transform64 } from "../ecs/transform/Transform64.js";
+import { t64_announce_change } from "../ecs/transform/t64_announce_change.js";
+import { t64_read_translation } from "../ecs/transform/t64_read_translation.js";
 import Tween from "./Tween.js";
 
 /**
@@ -12,16 +15,21 @@ import Tween from "./Tween.js";
  * @returns {Tween}
  */
 function translate(entity, ecd, parameter, time, transitionFunction) {
-    const transform = ecd.getComponent(entity, Transform);
+    const transform = ecd.getComponent(entity, Transform64);
 
-    const origin = transform.position.clone();
+    const origin = t64_read_translation(new Vector3(), transform);
     const target = origin.clone().add(parameter);
 
     const temp = origin.clone();
+
     return new Tween(function (v) {
-        const position = transform.position;
         temp.copy(origin).lerp(target, v);
-        position.copy(temp);
+
+        // the translation is the matrix's own column, so nothing is left to recompose - but the
+        // component still has to say it moved, or nothing following the entity will move with it
+        transform.setTranslation(temp.x, temp.y, temp.z);
+
+        t64_announce_change(ecd, entity, transform);
     }, 0, 1, time, transitionFunction);
 }
 

package/src/engine/animation/clip/bind_property_writer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"bind_property_writer.d.ts","sourceRoot":"","sources":["../../../../../src/engine/animation/clip/bind_property_writer.js"],"names":[],"mappings":"AA2FA;;;;;GAKG;AACH,mEAHW,MAAM,EAAE,GACN,gBAAgB,CA+B5B;iCA3HgC,sCAAsC"}
+{"version":3,"file":"bind_property_writer.d.ts","sourceRoot":"","sources":["../../../../../src/engine/animation/clip/bind_property_writer.js"],"names":[],"mappings":"AA6FA;;;;;GAKG;AACH,mEAHW,MAAM,EAAE,GACN,gBAAgB,CAoC5B;iCAnIgC,sCAAsC"}

package/src/engine/animation/clip/bind_property_writer.js

@@ -1,8 +1,10 @@
 import { assert } from "../../../core/assert.js";
 import Name from "../../ecs/name/Name.js";
-import { BoundQuaternionWriter } from "../curve/binding/BoundQuaternionWriter.js";
 import { BoundValueWriter } from "../curve/binding/BoundValueWriter.js";
-import { BoundVector3Writer } from "../curve/binding/BoundVector3Writer.js";
+import {
+    BoundTransform64Writer,
+    Transform64Channel
+} from "../curve/binding/BoundTransform64Writer.js";
 
 /**
  *
@@ -108,14 +110,19 @@ export function bind_property_writer(node, path_parts) {
     let writer;
 
     switch (property_name) {
+        /*
+         The three names are the glTF ones and stay as they are; what they bind to is a span of the
+         node's Transform64 rather than an object hanging off it, so all three go through the writer
+         that knows how to put one back.
+        */
         case "position":
-            writer = new BoundVector3Writer(parent.transform.position);
+            writer = new BoundTransform64Writer(parent, Transform64Channel.Translation);
             break;
         case "quaternion":
-            writer = new BoundQuaternionWriter(parent.transform.rotation);
+            writer = new BoundTransform64Writer(parent, Transform64Channel.Rotation);
             break;
         case "scale":
-            writer = new BoundVector3Writer(parent.transform.scale);
+            writer = new BoundTransform64Writer(parent, Transform64Channel.Scale);
             break;
         default:
             console.log(`Unsupported property name: ${property_name}`);

package/src/engine/animation/curve/binding/BoundTransform64Writer.d.ts

@@ -0,0 +1,29 @@
+export type Transform64Channel = string;
+export namespace Transform64Channel {
+    let Translation: string;
+    let Rotation: string;
+    let Scale: string;
+}
+/**
+ * Animate one component of an {@link EntityNode}'s pose.
+ *
+ * A {@link Transform64} keeps its three components as spans of one array, so there is no
+ * {@link Vector3} or {@link Quaternion} on it for {@link BoundVector3Writer} to hold on to - which
+ * is why the pose gets a writer of its own rather than reusing those.
+ *
+ * The writer owns three obligations a curve should not have to know about: only a translation write
+ * lands in the matrix by itself, so a rotation or a scale write recomposes; and the node's pose is
+ * not the entity's, so the write is followed by the sync that pushes it into the components the
+ * rest of the engine reads.
+ */
+export class BoundTransform64Writer extends BoundValueWriter {
+    /**
+     * @param {EntityNode} node
+     * @param {string} channel one of {@link Transform64Channel}
+     */
+    constructor(node: EntityNode, channel: string);
+    write(data: any): void;
+    #private;
+}
+import { BoundValueWriter } from "./BoundValueWriter.js";
+//# sourceMappingURL=BoundTransform64Writer.d.ts.map

package/src/engine/animation/curve/binding/BoundTransform64Writer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BoundTransform64Writer.d.ts","sourceRoot":"","sources":["../../../../../../src/engine/animation/curve/binding/BoundTransform64Writer.js"],"names":[],"mappings":"iCAIU,MAAM;;;;;;AAahB;;;;;;;;;;;GAWG;AACH;IAWI;;;OAGG;IACH,uCAFW,MAAM,EAOhB;IAED,uBA2BC;;CACJ;iCA9EgC,uBAAuB"}