@woosh/meep-engine 2.119.84 → 2.119.85

package/package.json

@@ -5,7 +5,7 @@
   "description": "Fully featured ECS game engine written in JavaScript",
   "type": "module",
   "author": "Alexander Goldring",
-  "version": "2.119.84",
+  "version": "2.119.85",
   "main": "build/meep.module.js",
   "module": "build/meep.module.js",
   "exports": {

package/src/core/color/rgb_to_rgbe9995.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Convert floating point RGB input to RGBE9995 Uint32 value
+ * TODO unverified
+ * @param {number} r
+ * @param {number} g
+ * @param {number} b
+ * @returns {number} Uint32
+ */
+export function rgb_to_rgbe9995(r: number, g: number, b: number): number;
+//# sourceMappingURL=rgb_to_rgbe9995.d.ts.map

package/src/core/color/rgb_to_rgbe9995.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rgb_to_rgbe9995.d.ts","sourceRoot":"","sources":["../../../../src/core/color/rgb_to_rgbe9995.js"],"names":[],"mappings":"AAGA;;;;;;;GAOG;AACH,mCALW,MAAM,KACN,MAAM,KACN,MAAM,GACJ,MAAM,CAyClB"}

package/src/core/color/rgb_to_rgbe9995.js

@@ -0,0 +1,51 @@
+import { clamp } from "../math/clamp.js";
+import { max3 } from "../math/max3.js";
+
+/**
+ * Convert floating point RGB input to RGBE9995 Uint32 value
+ * TODO unverified
+ * @param {number} r
+ * @param {number} g
+ * @param {number} b
+ * @returns {number} Uint32
+ */
+export function rgb_to_rgbe9995(r, g, b) {
+
+    //see https://github.com/Stary2001/godot/blob/00c6ce9716ed542997bc2b59136bceb3729db970/core/color.h#L125
+
+    const pow2to9 = 512.0;
+    const B = 15.0;
+    //const float Emax = 31.0f;
+    const N = 9.0;
+
+    const sharedexp = 65408.000; //(( pow2to9  - 1.0f)/ pow2to9)*powf( 2.0f, 31.0f - 15.0f);
+
+    const cRed = clamp(r, 0, sharedexp);
+    const cGreen = clamp(g, 0, sharedexp);
+    const cBlue = clamp(b, 0, sharedexp);
+
+    const cMax = max3(cRed, cGreen, cBlue);
+
+    // expp = MAX(-B - 1, log2(maxc)) + 1 + B
+
+    const expp = Math.max(-B - 1.0, Math.floor(Math.log(cMax) / Math.LN2)) + 1.0 + B;
+
+    const sMax = Math.floor((cMax / Math.pow(2.0, expp - B - N)) + 0.5);
+
+    let exps = expp + 1.0;
+
+    if (0.0 <= sMax && sMax < pow2to9) {
+        exps = expp;
+    }
+
+    const sRed = Math.floor((cRed / Math.pow(2.0, exps - B - N)) + 0.5) >>> 0;
+    const sGreen = Math.floor((cGreen / Math.pow(2.0, exps - B - N)) + 0.5) >>> 0;
+    const sBlue = Math.floor((cBlue / Math.pow(2.0, exps - B - N)) + 0.5) >>> 0;
+
+    return (sRed & 0x1FF)
+        | ((sGreen & 0x1FF) << 9)
+        | ((sBlue & 0x1FF) << 18)
+        | ((exps & 0x1F) << 27)
+        ;
+
+}

package/src/core/color/rgbe9995_to_rgb.d.ts

@@ -0,0 +1,9 @@
+/**
+ * TODO unverified
+ * Decode RGBE (RGB + exponent) UINT32 value
+ * @param {number[]|Float32Array} out
+ * @param {number} out_offset
+ * @param {number} rgbe
+ */
+export function rgbe9995_to_rgb(out: number[] | Float32Array, out_offset: number, rgbe: number): void;
+//# sourceMappingURL=rgbe9995_to_rgb.d.ts.map

package/src/core/color/rgbe9995_to_rgb.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rgbe9995_to_rgb.d.ts","sourceRoot":"","sources":["../../../../src/core/color/rgbe9995_to_rgb.js"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,qCAJW,MAAM,EAAE,GAAC,YAAY,cACrB,MAAM,QACN,MAAM,QAmBhB"}

package/src/core/color/rgbe9995_to_rgb.js

@@ -0,0 +1,25 @@
+/**
+ * TODO unverified
+ * Decode RGBE (RGB + exponent) UINT32 value
+ * @param {number[]|Float32Array} out
+ * @param {number} out_offset
+ * @param {number} rgbe
+ */
+export function rgbe9995_to_rgb(out, out_offset, rgbe) {
+    // see https://github.com/godotengine/godot/blob/4c4e67334412f73c9deba5e5d29afa8651418af2/core/math/color.cpp#L471
+
+    const r = rgbe & 0x1ff;
+    const g = (rgbe >> 9) & 0x1ff;
+    const b = (rgbe >> 18) & 0x1ff;
+    const e = (rgbe >> 27);
+
+    const scale = Math.pow(2.0, e - 15.0 - 9.0);
+
+    const _r = r * scale;
+    const _g = g * scale;
+    const _b = b * scale;
+
+    out[out_offset] = _r;
+    out[out_offset + 1] = _g;
+    out[out_offset + 2] = _b;
+}

package/src/core/geom/3d/v3_compute_interior_angle.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Compute interior angle between three points
+ * Computed angle is around point B
+ * @param {{x:number, y:number, z:number}} a
+ * @param {{x:number, y:number, z:number}} b
+ * @param {{x:number, y:number, z:number}} c
+ * @returns {number} angle in radians
+ */
+export function v3_compute_interior_angle(a: {
+    x: number;
+    y: number;
+    z: number;
+}, b: {
+    x: number;
+    y: number;
+    z: number;
+}, c: {
+    x: number;
+    y: number;
+    z: number;
+}): number;
+//# sourceMappingURL=v3_compute_interior_angle.d.ts.map

package/src/core/geom/3d/v3_compute_interior_angle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"v3_compute_interior_angle.d.ts","sourceRoot":"","sources":["../../../../../src/core/geom/3d/v3_compute_interior_angle.js"],"names":[],"mappings":"AAEA;;;;;;;GAOG;AACH,6CALW;IAAC,CAAC,EAAC,MAAM,CAAC;IAAC,CAAC,EAAC,MAAM,CAAC;IAAC,CAAC,EAAC,MAAM,CAAA;CAAC,KAC9B;IAAC,CAAC,EAAC,MAAM,CAAC;IAAC,CAAC,EAAC,MAAM,CAAC;IAAC,CAAC,EAAC,MAAM,CAAA;CAAC,KAC9B;IAAC,CAAC,EAAC,MAAM,CAAC;IAAC,CAAC,EAAC,MAAM,CAAC;IAAC,CAAC,EAAC,MAAM,CAAA;CAAC,GAC5B,MAAM,CAiBlB"}

package/src/core/geom/3d/v3_compute_interior_angle.js

@@ -0,0 +1,26 @@
+import { v3_angle_between } from "../vec3/v3_angle_between.js";
+
+/**
+ * Compute interior angle between three points
+ * Computed angle is around point B
+ * @param {{x:number, y:number, z:number}} a
+ * @param {{x:number, y:number, z:number}} b
+ * @param {{x:number, y:number, z:number}} c
+ * @returns {number} angle in radians
+ */
+export function v3_compute_interior_angle(a, b, c) {
+    //compute AB delta
+    const d_ab_x = a.x - b.x;
+    const d_ab_y = a.y - b.y;
+    const d_ab_z = a.z - b.z;
+
+    //compute CB delta
+    const d_cb_x = c.x - b.x;
+    const d_cb_y = c.y - b.y;
+    const d_cb_z = c.z - b.z;
+
+    return v3_angle_between(
+        d_ab_x, d_ab_y, d_ab_z,
+        d_cb_x, d_cb_y, d_cb_z,
+    )
+}

package/src/core/geom/Quaternion.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Quaternion.d.ts","sourceRoot":"","sources":["../../../../src/core/geom/Quaternion.js"],"names":[],"mappings":"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"}
+{"version":3,"file":"Quaternion.d.ts","sourceRoot":"","sources":["../../../../src/core/geom/Quaternion.js"],"names":[],"mappings":"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"}

package/src/core/geom/Quaternion.js

@@ -1023,14 +1023,16 @@ class Quaternion {
     }
 
     /**
-     *
+     * Spherical linear interpolation
      * @param {Quaternion} from
      * @param {Quaternion} to
-     * @param {number} t
+     * @param {number} t coefficient, how much between the input quats?
      */
     slerpQuaternions(from, to, t) {
         assert.isNumber(t, 't');
 
+        // see https://github.com/glampert/vectormath/blob/7105ef341303fe83b3dacd6883d9333989126069/scalar/quaternion.hpp#L90
+
         const ax = from.x,
             ay = from.y,
             az = from.z,
@@ -1041,26 +1043,30 @@ class Quaternion {
             bz = to.z,
             bw = to.w;
 
-        let omega, cosom, sinom, scale0, scale1;
+        let  cos_angle,  scale0, scale1;
 
         // calc cosine
-        cosom = ax * bx + ay * by + az * bz + aw * bw;
+        cos_angle = ax * bx + ay * by + az * bz + aw * bw;
 
         // adjust signs (if necessary)
-        if (cosom < 0.0) {
-            cosom = -cosom;
+        if (cos_angle < 0.0) {
+            cos_angle = -cos_angle;
             bx = -bx;
             by = -by;
             bz = -bz;
             bw = -bw;
         }
+
         // calculate coefficients
-        if ((1.0 - cosom) > EPSILON) {
+        if ((1.0 - cos_angle) > EPSILON) {
             // standard case (slerp)
-            omega = Math.acos(cosom);
-            sinom = sin(omega);
-            scale0 = sin((1.0 - t) * omega) / sinom;
-            scale1 = sin(t * omega) / sinom;
+            const angle = Math.acos(cos_angle);
+
+            const recip_sin_angle = 1 / sin(angle);
+
+            scale0 = sin((1.0 - t) * angle) * recip_sin_angle;
+            scale1 = sin(t * angle) * recip_sin_angle;
+
         } else {
             // "from" and "to" quaternions are very close
             //  ... so we can do a linear interpolation

package/src/engine/animation/keyed2/AnimationTrackPlayback.d.ts

@@ -23,6 +23,11 @@ declare class AnimationTrackPlayback {
     on: {
         ended: Signal<any, any, any, any, any, any, any, any>;
     };
+    /**
+     *
+     * @returns {boolean}
+     */
+    get loop(): boolean;
     /**
      *
      * @returns {Promise<void>}

package/src/engine/animation/keyed2/AnimationTrackPlayback.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AnimationTrackPlayback.d.ts","sourceRoot":"","sources":["../../../../../src/engine/animation/keyed2/AnimationTrackPlayback.js"],"names":[],"mappings":";AAGA;IACI;;;;;;;;OAQG;IACH,4EAuBC;IAtBG,sBAAkB;IAClB,cAA+B;IAE/B,oBAAoC;IACpC,kBAAgC;IAEhC,uBAAuB;IACvB,8BAA8B;IAE9B,uBAAuB;IACvB,sBAAsB;IAEtB,gBAAmB;IAEnB,4BAA0D;IAG1D;;MAEC;IAKL;;;OAGG;IACH,gBAFa,QAAQ,IAAI,CAAC,CAUzB;IAED;;;OAGG;IACH,WAFW,OAAO,QAIjB;IAED,cAEC;IAED;;;OAGG;IACH,kBAFW,MAAM,QA2BhB;IAED;;;OAGG;IACH,cAFa,OAAO,CA2CnB;IAED;;;OAGG;IACH,mBAFW,MAAM,QA6BhB;IAED,eAOC;IAED;;;OAGG;IACH,0BAFW,MAAM,EAAE,QA2ClB;CACJ;mBAtOkB,uCAAuC"}
+{"version":3,"file":"AnimationTrackPlayback.d.ts","sourceRoot":"","sources":["../../../../../src/engine/animation/keyed2/AnimationTrackPlayback.js"],"names":[],"mappings":";AAGA;IACI;;;;;;;;OAQG;IACH,4EAuBC;IAtBG,sBAAkB;IAClB,cAA+B;IAE/B,oBAAoC;IACpC,kBAAgC;IAEhC,uBAAuB;IACvB,8BAA8B;IAE9B,uBAAuB;IACvB,sBAAsB;IAEtB,gBAAmB;IAEnB,4BAA0D;IAG1D;;MAEC;IAKL;;;OAGG;IACH,oBAEC;IAED;;;OAGG;IACH,gBAFa,QAAQ,IAAI,CAAC,CAUzB;IAED;;;OAGG;IACH,WAFW,OAAO,QAIjB;IAED,cAEC;IAED;;;OAGG;IACH,kBAFW,MAAM,QA2BhB;IAED;;;OAGG;IACH,cAFa,OAAO,CA2CnB;IAED;;;OAGG;IACH,mBAFW,MAAM,QA6BhB;IAED,eAOC;IAED;;;OAGG;IACH,0BAFW,MAAM,EAAE,QA2ClB;CACJ;mBA9OkB,uCAAuC"}

package/src/engine/animation/keyed2/AnimationTrackPlayback.js

@@ -36,6 +36,14 @@ class AnimationTrackPlayback {
         this.setPosition(0);
     }
 
+    /**
+     *
+     * @returns {boolean}
+     */
+    get loop() {
+        return this.__loop;
+    }
+
     /**
      *
      * @returns {Promise<void>}

package/src/engine/animation/keyed2/behavior/AnimationBehavior.d.ts

@@ -4,8 +4,12 @@ export class AnimationBehavior extends Behavior<any> {
      * @param {AnimationTrackPlayback} animation
      */
     constructor(animation: AnimationTrackPlayback);
+    /**
+     *
+     * @type {AnimationTrackPlayback}
+     */
     animation: AnimationTrackPlayback;
-    initialize(): void;
+    initialize(_ignore_: any): void;
 }
 import { Behavior } from "../../../intelligence/behavior/Behavior.js";
 //# sourceMappingURL=AnimationBehavior.d.ts.map

package/src/engine/animation/keyed2/behavior/AnimationBehavior.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AnimationBehavior.d.ts","sourceRoot":"","sources":["../../../../../../src/engine/animation/keyed2/behavior/AnimationBehavior.js"],"names":[],"mappings":"AAGA;IACI;;;OAGG;IACH,+CAGC;IADG,kCAA0B;IAmB9B,mBAEC;CACJ;yBAhCwB,4CAA4C"}
+{"version":3,"file":"AnimationBehavior.d.ts","sourceRoot":"","sources":["../../../../../../src/engine/animation/keyed2/behavior/AnimationBehavior.js"],"names":[],"mappings":"AAGA;IACI;;;OAGG;IACH,+CAOC;IALG;;;OAGG;IACH,kCAA0B;IAqB9B,gCAEC;CACJ;yBAtCwB,4CAA4C"}

package/src/engine/animation/keyed2/behavior/AnimationBehavior.js

@@ -8,6 +8,10 @@ export class AnimationBehavior extends Behavior {
      */
     constructor(animation) {
         super();
+        /**
+         *
+         * @type {AnimationTrackPlayback}
+         */
         this.animation = animation;
     }
 
@@ -18,16 +22,18 @@ export class AnimationBehavior extends Behavior {
      * @returns {BehaviorStatus}
      */
     tick(timeDelta) {
-        this.animation.advance(timeDelta);
+        const animation = this.animation;
 
-        if (this.animation.position >= this.animation.track.timeEnd && !this.animation.loop) {
+        animation.advance(timeDelta);
+
+        if (animation.position >= animation.track.timeEnd && !animation.loop) {
             return BehaviorStatus.Succeeded;
         }
 
         return BehaviorStatus.Running;
     }
 
-    initialize() {
+    initialize(_ignore_) {
         this.animation.setPosition(this.animation.track.timeStart);
     }
 }

package/src/engine/ecs/transform/Transform.d.ts

@@ -45,7 +45,7 @@ export class Transform {
     readonly matrix: Float32Array;
     /**
      * Various bit flags, see {@link TransformFlags}
-     * This should generally be accessed through getFlag/setFlag instead of modifying the value directly
+     * This should generally be accessed through {@link getFlag}/{@link setFlag} instead of modifying the value directly
      * @type {number}
      */
     flags: number;

package/src/engine/ecs/transform/Transform.js

@@ -53,7 +53,7 @@ export class Transform {
 
     /**
      * Various bit flags, see {@link TransformFlags}
-     * This should generally be accessed through getFlag/setFlag instead of modifying the value directly
+     * This should generally be accessed through {@link getFlag}/{@link setFlag} instead of modifying the value directly
      * @type {number}
      */
     flags = FLAGS_DEFAULT;

package/src/engine/physics/inverse_kinematics/two_joint_ik.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"two_joint_ik.d.ts","sourceRoot":"","sources":["../../../../../src/engine/physics/inverse_kinematics/two_joint_ik.js"],"names":[],"mappings":"AAgDA;;;;;;;;;;;GAWG;AACH,gCAVW,OAAO,KACP,OAAO,KACP,OAAO,KACP,OAAO,OACP,MAAM,QACN,UAAU,QACV,UAAU,QACV,UAAU,QACV,UAAU,QAoEpB;oBA5HmB,+BAA+B;uBAF5B,kCAAkC"}
+{"version":3,"file":"two_joint_ik.d.ts","sourceRoot":"","sources":["../../../../../src/engine/physics/inverse_kinematics/two_joint_ik.js"],"names":[],"mappings":"AA0BA;;;;;;;;;;;GAWG;AACH,gCAVW,OAAO,KACP,OAAO,KACP,OAAO,KACP,OAAO,OACP,MAAM,QACN,UAAU,QACV,UAAU,QACV,UAAU,QACV,UAAU,QAoEpB;oBAtGmB,+BAA+B;uBAD5B,kCAAkC"}

package/src/engine/physics/inverse_kinematics/two_joint_ik.js

@@ -1,32 +1,8 @@
+import { v3_compute_interior_angle } from "../../../core/geom/3d/v3_compute_interior_angle.js";
 import Quaternion from "../../../core/geom/Quaternion.js";
-import { v3_angle_between } from "../../../core/geom/vec3/v3_angle_between.js";
 import Vector3 from "../../../core/geom/Vector3.js";
 import { clamp } from "../../../core/math/clamp.js";
 
-/**
- * Compute interior angle between three points
- * @param {Vector3} a
- * @param {Vector3} b
- * @param {Vector3} c
- * @returns {number} angle in radians
- */
-function computeInteriorAngle(a, b, c) {
-    //compute AB delta
-    const d_ab_x = a.x - b.x;
-    const d_ab_y = a.y - b.y;
-    const d_ab_z = a.z - b.z;
-
-    //compute CB delta
-    const d_cb_x = c.x - b.x;
-    const d_cb_y = c.y - b.y;
-    const d_cb_z = c.z - b.z;
-
-    return v3_angle_between(
-        d_ab_x, d_ab_y, d_ab_z,
-        d_cb_x, d_cb_y, d_cb_z,
-    )
-}
-
 const d = new Vector3();
 
 const delta_ca = new Vector3();
@@ -46,6 +22,8 @@ const axis0_la = new Vector3();
 const axis0_lb = new Vector3();
 const axis1_la = new Vector3();
 
+// TODO: investigate https://github.com/guillaumeblanc/ozz-animation/blob/master/src/animation/runtime/ik_two_bone_job.cc
+
 /**
  * Based on http://theorangeduck.com/page/simple-two-joint
  * @param {Vector3} a Root bone position
@@ -74,9 +52,9 @@ export function two_joint_ik(
     const lat = clamp(t.distanceTo(a), eps, maximum_extension);
 
     //compute current interior angles
-    const ac_ab_0 = computeInteriorAngle(c, a, b);
-    const ba_bc_0 = computeInteriorAngle(a, b, c);
-    const ac_at_0 = computeInteriorAngle(c, a, t);
+    const ac_ab_0 = v3_compute_interior_angle(c, a, b);
+    const ba_bc_0 = v3_compute_interior_angle(a, b, c);
+    const ac_at_0 = v3_compute_interior_angle(c, a, t);
 
     // Using the cosine rule to compute desired interior angles
     const length_at_sqr = lat * lat;