@woosh/meep-engine 2.110.4 → 2.110.6

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

@@ -1 +1 @@
-{"version":3,"file":"AnimationClip.d.ts","sourceRoot":"","sources":["../../../../../src/engine/animation/clip/AnimationClip.js"],"names":[],"mappings":"AAEA;IACI,aAAS;IACT;;;OAGG;IACH,QAFU,gBAAgB,CAEf;IAEX,uBAWC;CACJ"}
+{"version":3,"file":"AnimationClip.d.ts","sourceRoot":"","sources":["../../../../../src/engine/animation/clip/AnimationClip.js"],"names":[],"mappings":"AAEA;IACI,aAAS;IACT;;;OAGG;IACH,QAFU,gBAAgB,CAEf;IAEX;;;OAGG;IACH,uBAWC;CACJ"}

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

@@ -8,6 +8,10 @@ export class AnimationClip {
      */
     tracks = []
 
+    /**
+     *
+     * @return {number}
+     */
     get duration() {
         let r = 0;
 

package/src/engine/animation/clip/AnimationInterpolationKind.d.ts

@@ -0,0 +1,7 @@
+export type AnimationInterpolationKind = number;
+export namespace AnimationInterpolationKind {
+    let Discrete: number;
+    let Linear: number;
+    let CubicTangents: number;
+}
+//# sourceMappingURL=AnimationInterpolationKind.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"AnimationInterpolationKind.d.ts","sourceRoot":"","sources":["../../../../../src/engine/animation/clip/AnimationInterpolationKind.js"],"names":[],"mappings":"yCAEU,MAAM"}

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

@@ -0,0 +1,9 @@
+/**
+ *
+ * @enum {number}
+ */
+export const AnimationInterpolationKind = {
+    Discrete: 0,
+    Linear: 1,
+    CubicTangents: 2
+};

package/src/engine/animation/clip/AnimationTrack.d.ts

@@ -1,3 +1,6 @@
+/**
+ * Represents animation of a meaningful multi-variate thing, such as 3d vector or single scalar
+ */
 export class AnimationTrack {
     /**
      *
@@ -33,6 +36,10 @@ export class AnimationTrack {
      * @return {number}
      */
     get duration(): number;
+    /**
+     *
+     * @return {number}
+     */
     get curveCount(): number;
     /**
      *
@@ -41,5 +48,10 @@ export class AnimationTrack {
      * @param {number} time
      */
     sample(output: number[] | Float32Array | Float64Array, output_offset: number, time: number): void;
+    /**
+     * @readonly
+     * @type {boolean}
+     */
+    readonly isAnimationTrack: boolean;
 }
 //# sourceMappingURL=AnimationTrack.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"AnimationTrack.d.ts","sourceRoot":"","sources":["../../../../../src/engine/animation/clip/AnimationTrack.js"],"names":[],"mappings":"AAEA;IAkEI;;;;;OAKG;IACH,qBAJW,gBAAgB,SAChB,MAAM,GACL,cAAc,CASzB;IA9ED;;;OAGG;IACH,MAFU,MAAM,CAEP;IAET;;;OAGG;IACH,MAFU,MAAM,EAAE,CAET;IAET;;;OAGG;IACH,QAFU,gBAAgB,CAEf;IAEX;;;;;OAKG;IACH,MAFU,MAAM,CAEP;IAET;;;OAGG;IACH,uBAYC;IAED,yBAEC;IAED;;;;;OAKG;IACH,eAJW,MAAM,EAAE,GAAC,YAAY,GAAC,YAAY,iBAClC,MAAM,QACN,MAAM,QAWhB;CAgBJ"}
+{"version":3,"file":"AnimationTrack.d.ts","sourceRoot":"","sources":["../../../../../src/engine/animation/clip/AnimationTrack.js"],"names":[],"mappings":"AAGA;;GAEG;AACH;IAwEI;;;;;OAKG;IACH,qBAJW,gBAAgB,SAChB,MAAM,GACL,cAAc,CAYzB;IAvFD;;;OAGG;IACH,MAFU,MAAM,CAEP;IAET;;;OAGG;IACH,MAFU,MAAM,EAAE,CAET;IAET;;;OAGG;IACH,QAFU,gBAAgB,CAEf;IAEX;;;;;OAKG;IACH,MAFU,MAAM,CAEP;IAET;;;OAGG;IACH,uBAYC;IAED;;;OAGG;IACH,yBAEC;IAED;;;;;OAKG;IACH,eAJW,MAAM,EAAE,GAAC,YAAY,GAAC,YAAY,iBAClC,MAAM,QACN,MAAM,QAahB;IAqBL;;;OAGG;IACH,2BAFU,OAAO,CAEwB;CANxC"}

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

@@ -1,5 +1,9 @@
+import { assert } from "../../../core/assert.js";
 import { max2 } from "../../../core/math/max2.js";
 
+/**
+ * Represents animation of a meaningful multi-variate thing, such as 3d vector or single scalar
+ */
 export class AnimationTrack {
     /**
      * Human-readable label
@@ -45,6 +49,10 @@ export class AnimationTrack {
         return r;
     }
 
+    /**
+     *
+     * @return {number}
+     */
     get curveCount() {
         return this.curves.length;
     }
@@ -59,6 +67,8 @@ export class AnimationTrack {
         const curves = this.curves;
         const curve_count = curves.length;
 
+        assert.greaterThanOrEqual(output.length, output_offset + curve_count, 'output overflow');
+
         for (let i = 0; i < curve_count; i++) {
             const curve = curves[i];
 
@@ -73,6 +83,9 @@ export class AnimationTrack {
      * @return {AnimationTrack}
      */
     static from(curves = [], name = "") {
+        assert.isString(name, 'name');
+        assert.isArray(curves, 'curves');
+
         const r = new AnimationTrack();
 
         r.curves = curves;
@@ -80,4 +93,10 @@ export class AnimationTrack {
 
         return r;
     }
-}
+}
+
+/**
+ * @readonly
+ * @type {boolean}
+ */
+AnimationTrack.prototype.isAnimationTrack = true;

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

@@ -1 +1 @@
-{"version":3,"file":"AnimationTrackBinding.d.ts","sourceRoot":"","sources":["../../../../../src/engine/animation/clip/AnimationTrackBinding.js"],"names":[],"mappings":"AAEA;IAaI;;;;;OAKG;IACH,8DAFa,qBAAqB,CAWjC;IA3BD;;;OAGG;IACH,QAFU,mBAAiB,IAAI,CAElB;IAEb;;;OAGG;IACH,sBAAY;IAmBZ;;;OAGG;IACH,cAFW,MAAM,QAMhB;CACJ"}
+{"version":3,"file":"AnimationTrackBinding.d.ts","sourceRoot":"","sources":["../../../../../src/engine/animation/clip/AnimationTrackBinding.js"],"names":[],"mappings":"AAIA;IAaI;;;;;OAKG;IACH,8DAFa,qBAAqB,CAqBjC;IArCD;;;OAGG;IACH,QAFU,mBAAiB,IAAI,CAElB;IAEb;;;OAGG;IACH,sBAAY;IA6BZ;;;OAGG;IACH,cAFW,MAAM,QAMhB;CACJ"}

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

@@ -1,3 +1,5 @@
+import { assert } from "../../../core/assert.js";
+
 const sample = new Float64Array(1024);
 
 export class AnimationTrackBinding {
@@ -20,6 +22,16 @@ export class AnimationTrackBinding {
      * @returns {AnimationTrackBinding}
      */
     static from(writer, track) {
+        assert.defined(writer,'writer');
+        assert.isObject(writer,'writer');
+        assert.notNull(writer,'writer');
+        assert.equal(writer.isBoundValueWriter,true,'writer.isBoundValueWriter !== true');
+
+        assert.defined(track,'track');
+        assert.isObject(track,'track');
+        assert.notNull(track,'track');
+        assert.equal(track.isAnimationTrack,true,'track.isAnimationTrack !== true');
+
 
         const r = new AnimationTrackBinding();
 

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

@@ -0,0 +1,9 @@
+/**
+ *
+ * @param {EntityNode} node
+ * @param {string} path
+ * @returns {BoundValueWriter}
+ */
+export function bind_property_writer(node: EntityNode, path: string): BoundValueWriter;
+import { BoundValueWriter } from "../curve/binding/BoundValueWriter.js";
+//# sourceMappingURL=bind_property_writer.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"bind_property_writer.d.ts","sourceRoot":"","sources":["../../../../../src/engine/animation/clip/bind_property_writer.js"],"names":[],"mappings":"AAqFA;;;;;GAKG;AACH,6DAHW,MAAM,GACJ,gBAAgB,CA4B5B;iCAnHgC,sCAAsC"}

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

@@ -0,0 +1,118 @@
+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";
+
+/**
+ *
+ * @param {EntityNode} node
+ * @returns {string|undefined}
+ */
+function get_node_name(node) {
+    /**
+     * @type {Name}
+     */
+    const name = node.entity.getComponent(Name);
+
+    if (name === null) {
+        return undefined;
+    }
+
+    return name.getValue();
+}
+
+/**
+ * Following THREE.js PropertyBinding.findNode implementation
+ * @param {EntityNode} root
+ * @param {string} nodeName
+ * @returns {EntityNode|undefined}
+ */
+function find_node(root, nodeName) {
+
+    const root_name = get_node_name(root);
+
+    if (root_name === nodeName) {
+        return root;
+    }
+
+    // search into node subtree.
+    const children = root.children;
+
+    const child_count = children.length;
+
+
+    for (let j = 0; j < child_count; j++) {
+        /**
+         * @type {EntityNode}
+         */
+        const child = children[j];
+
+        const subtree_result = find_node(child, nodeName);
+
+        if (subtree_result !== undefined) {
+            return subtree_result;
+        }
+    }
+}
+
+/**
+ *
+ * @param {EntityNode} root
+ * @param {string[]} path_parts
+ */
+function entity_node_resolve_path(root, path_parts) {
+
+    let node = root;
+
+    const part_count = path_parts.length;
+    for (let i = 0; i < part_count; i++) {
+
+        const part = path_parts[i];
+
+        const sub_node = find_node(node, part);
+
+        if (sub_node === undefined) {
+
+            throw new Error(`Child '${part}' not found, at index ${i} of [${path_parts.join(', ')}]. Valid names at this level: [${node.children.map(get_node_name)}]`);
+
+        }
+
+        node = sub_node;
+    }
+
+    return node;
+}
+
+/**
+ *
+ * @param {EntityNode} node
+ * @param {string} path
+ * @returns {BoundValueWriter}
+ */
+export function bind_property_writer(node, path) {
+    const path_parts = path.split('.');
+
+    const property_name = path_parts[path_parts.length - 1];
+
+    const parent = entity_node_resolve_path(node, path_parts.slice(0, path_parts.length - 1));
+
+    let writer;
+
+    switch (property_name) {
+        case "position":
+            writer = new BoundVector3Writer(parent.transform.position);
+            break;
+        case "quaternion":
+            writer = new BoundQuaternionWriter(parent.transform.rotation);
+            break;
+        case "scale":
+            writer = new BoundVector3Writer(parent.transform.scale);
+            break;
+        default:
+            console.log(`Unsupported property name: ${property_name}`);
+            // NO-OP
+            writer = new BoundValueWriter();
+    }
+
+    return writer;
+}

package/src/engine/animation/clip/curve_from_track_data.d.ts

@@ -0,0 +1,12 @@
+/**
+ *
+ * @param {AnimationCurve} curve
+ * @param {AnimationInterpolationKind} type
+ * @param {number[]|Float32Array} values
+ * @param {number[]|Float32Array} times
+ * @param {number} component_count
+ * @param {number} component_index
+ */
+export function curve_from_track_data(curve: AnimationCurve, type: AnimationInterpolationKind, values: number[] | Float32Array, times: number[] | Float32Array, component_count: number, component_index: number): void;
+import { AnimationInterpolationKind } from "./AnimationInterpolationKind.js";
+//# sourceMappingURL=curve_from_track_data.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"curve_from_track_data.d.ts","sourceRoot":"","sources":["../../../../../src/engine/animation/clip/curve_from_track_data.js"],"names":[],"mappings":"AAKA;;;;;;;;GAQG;AACH,mEANW,0BAA0B,UAC1B,MAAM,EAAE,GAAC,YAAY,SACrB,MAAM,EAAE,GAAC,YAAY,mBACrB,MAAM,mBACN,MAAM,QAchB;2CA1B0C,iCAAiC"}

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

@@ -0,0 +1,27 @@
+import { AnimationInterpolationKind } from "./AnimationInterpolationKind.js";
+import { curve_from_track_data_cubic_tangents } from "./curve_from_track_data_cubic_tangents.js";
+import { curve_from_track_data_discrete } from "./curve_from_track_data_discrete.js";
+import { curve_from_track_data_linear } from "./curve_from_track_data_linear.js";
+
+/**
+ *
+ * @param {AnimationCurve} curve
+ * @param {AnimationInterpolationKind} type
+ * @param {number[]|Float32Array} values
+ * @param {number[]|Float32Array} times
+ * @param {number} component_count
+ * @param {number} component_index
+ */
+export function curve_from_track_data(curve, type, values, times, component_count, component_index) {
+    switch (type) {
+        case AnimationInterpolationKind.Discrete:
+            return curve_from_track_data_discrete(curve, values, times, component_count, component_index);
+        case AnimationInterpolationKind.Linear:
+            return curve_from_track_data_linear(curve, values, times, component_count, component_index);
+        case AnimationInterpolationKind.CubicTangents:
+            return curve_from_track_data_cubic_tangents(curve, values, times, component_count, component_index);
+        default:
+            throw new Error(`Unsupported type '${type}'`);
+    }
+
+}

package/src/engine/animation/clip/curve_from_track_data_cubic_tangents.d.ts

@@ -0,0 +1,10 @@
+/**
+ *
+ * @param {AnimationCurve} curve
+ * @param {number[]} values
+ * @param {number[]} times
+ * @param {number} component_count
+ * @param {number} component_index
+ */
+export function curve_from_track_data_cubic_tangents(curve: AnimationCurve, values: number[], times: number[], component_count: number, component_index: number): void;
+//# sourceMappingURL=curve_from_track_data_cubic_tangents.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"curve_from_track_data_cubic_tangents.d.ts","sourceRoot":"","sources":["../../../../../src/engine/animation/clip/curve_from_track_data_cubic_tangents.js"],"names":[],"mappings":"AAEA;;;;;;;GAOG;AACH,oFALW,MAAM,EAAE,SACR,MAAM,EAAE,mBACR,MAAM,mBACN,MAAM,QAwBhB"}

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

@@ -0,0 +1,33 @@
+import { Keyframe } from "../curve/Keyframe.js";
+
+/**
+ *
+ * @param {AnimationCurve} curve
+ * @param {number[]} values
+ * @param {number[]} times
+ * @param {number} component_count
+ * @param {number} component_index
+ */
+export function curve_from_track_data_cubic_tangents(curve, values, times, component_count, component_index) {
+
+    const key_count = times.length;
+
+    for (let k = 0; k < key_count; k++) {
+        const component_position = k * component_count;
+
+        // 3 corresponds to 3 parts of a keyframe: inTangent, value, outTangent
+        const base_offset = 3 * component_position;
+
+        // Layout of keyframe output values for CUBICSPLINE animations:
+        //   [ inTangent_1, splineVertex_1, outTangent_1, inTangent_2, splineVertex_2, ... ]
+
+        const inTangent = values[base_offset + component_index];
+        const value = values[base_offset + component_count + component_index];
+        const outTangent = values[base_offset + component_count * 2 + component_index];
+
+        const time = times[k];
+
+        curve.add(Keyframe.from(time, value, inTangent, outTangent));
+    }
+
+}

package/src/engine/animation/clip/curve_from_track_data_discrete.d.ts

@@ -0,0 +1,10 @@
+/**
+ *
+ * @param {AnimationCurve} curve
+ * @param {number[]} values
+ * @param {number[]} times
+ * @param {number} component_count
+ * @param {number} component_index
+ */
+export function curve_from_track_data_discrete(curve: AnimationCurve, values: number[], times: number[], component_count: number, component_index: number): void;
+//# sourceMappingURL=curve_from_track_data_discrete.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"curve_from_track_data_discrete.d.ts","sourceRoot":"","sources":["../../../../../src/engine/animation/clip/curve_from_track_data_discrete.js"],"names":[],"mappings":"AAEA;;;;;;;GAOG;AACH,8EALW,MAAM,EAAE,SACR,MAAM,EAAE,mBACR,MAAM,mBACN,MAAM,QAqBhB"}

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

@@ -0,0 +1,30 @@
+import { Keyframe } from "../curve/Keyframe.js";
+
+/**
+ *
+ * @param {AnimationCurve} curve
+ * @param {number[]} values
+ * @param {number[]} times
+ * @param {number} component_count
+ * @param {number} component_index
+ */
+export function curve_from_track_data_discrete(curve, values, times, component_count, component_index) {
+
+    const key_count = times.length;
+
+    for (let k = 0; k < key_count; k++) {
+        const value = values[k * component_count + component_index];
+        const time = times[k];
+
+        curve.add(Keyframe.from(time, value));
+    }
+
+    const keys = curve.keys;
+
+    for (let i = key_count - 1; i > 0; i--) {
+        const key = keys[i];
+        const prev = keys[i - 1];
+
+        keys.splice(i, 0, Keyframe.from(key.time, prev.value));
+    }
+}

package/src/engine/animation/clip/curve_from_track_data_linear.d.ts

@@ -0,0 +1,10 @@
+/**
+ *
+ * @param {AnimationCurve} curve
+ * @param {number[]} values
+ * @param {number[]} times
+ * @param {number} component_count
+ * @param {number} component_index
+ */
+export function curve_from_track_data_linear(curve: AnimationCurve, values: number[], times: number[], component_count: number, component_index: number): void;
+//# sourceMappingURL=curve_from_track_data_linear.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"curve_from_track_data_linear.d.ts","sourceRoot":"","sources":["../../../../../src/engine/animation/clip/curve_from_track_data_linear.js"],"names":[],"mappings":"AAEA;;;;;;;GAOG;AACH,4EALW,MAAM,EAAE,SACR,MAAM,EAAE,mBACR,MAAM,mBACN,MAAM,QAgBhB"}

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

@@ -0,0 +1,25 @@
+import { Keyframe } from "../curve/Keyframe.js";
+
+/**
+ *
+ * @param {AnimationCurve} curve
+ * @param {number[]} values
+ * @param {number[]} times
+ * @param {number} component_count
+ * @param {number} component_index
+ */
+export function curve_from_track_data_linear(curve, values, times, component_count, component_index) {
+
+    const key_count = times.length;
+
+    for (let k = 0; k < key_count; k++) {
+        const value = values[k * component_count + component_index];
+        const time = times[k];
+
+        curve.add(Keyframe.from(time, value));
+    }
+
+    for (let k = 0; k < key_count; k++) {
+        curve.alignTangents(k);
+    }
+}

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

@@ -1 +1 @@
-{"version":3,"file":"ecd_bind_animation_curve.d.ts","sourceRoot":"","sources":["../../../../../src/engine/animation/clip/ecd_bind_animation_curve.js"],"names":[],"mappings":"AAuUA;;;;GAIG;AACH,2DAFW,mBAAmB,wBA6B7B;8BAhW6B,oBAAoB;qCACb,2BAA2B"}
+{"version":3,"file":"ecd_bind_animation_curve.d.ts","sourceRoot":"","sources":["../../../../../src/engine/animation/clip/ecd_bind_animation_curve.js"],"names":[],"mappings":"AAsGA;;;;GAIG;AACH,2DAFW,mBAAmB,wBA6B7B;8BApI6B,oBAAoB;qCACb,2BAA2B"}