@woosh/meep-engine 2.108.4 → 2.109.0

package/build/meep.cjs

@@ -557,7 +557,7 @@ assert.isArray = function (value, name = 'value') {
 
 /**
  * @template T
- * @param {ArrayLike<T>|T[]} value
+ * @param {ArrayLike<T>|T[]|Uint32Array|Float32Array} value
  * @param {string} name
  */
 assert.isArrayLike = function (value, name = 'value') {
@@ -3608,7 +3608,7 @@ let Quaternion$1 = class Quaternion {
     /**
      *
      * @param {Quaternion} other
-     * @param {number} max_delta
+     * @param {number} max_delta in radians
      */
     rotateTowards(other, max_delta) {
         Quaternion.rotateTowards(this, this, other, max_delta);
@@ -4987,6 +4987,19 @@ class Transform {
         return result;
     }
 
+    /**
+     *
+     * @param {number[]|Float32Array} mat
+     * @returns {Transform}
+     */
+    static fromMatrix(mat) {
+        const result = new Transform();
+
+        result.fromMatrix4(mat);
+
+        return result;
+    }
+
     /**
      * Multiply two transforms, result it written into this one
      * @param {Transform} a
@@ -5000,17 +5013,18 @@ class Transform {
 
     /**
      *
-     * @param {mat4|number[]|Float32Array} m
+     * @param {mat4|number[]|Float32Array} matrix
      */
-    fromMatrix4(m) {
+    fromMatrix4(matrix) {
+
         // we know we are changing the matrix, so we're going to need to disable the flag that sets matrix from position/rotation/scale changes
         const ad = this.getFlag(TransformFlags.AutomaticChangeDetection);
 
         this.clearFlag(TransformFlags.AutomaticChangeDetection);
 
-        this.matrix.set(m);
+        this.matrix.set(matrix);
 
-        decompose_matrix_4_array(m, this.position, this.rotation, this.scale);
+        decompose_matrix_4_array(matrix, this.position, this.rotation, this.scale);
 
         // restore value of the flag
         this.writeFlag(TransformFlags.AutomaticChangeDetection, ad);
@@ -69343,6 +69357,36 @@ function computeSystemName(system) {
     return system.constructor.name;
 }
 
+/**
+ *
+ * @param {Object3D} object
+ */
+function threeUpdateMatrix(object) {
+    object.updateMatrix();
+
+    const children = object.children;
+    for (let i = 0, childCount = children.length; i < childCount; i++) {
+        const child = children[i];
+
+        threeUpdateMatrix(child);
+    }
+}
+
+/**
+ *
+ * @param {Object3D} object3
+ */
+function threeUpdateTransform(object3) {
+
+    /**
+     signal that transformation matrix should be updated
+     @see https://threejs.org/docs/index.html#api/core/Object3D.matrixWorldNeedsUpdate
+     */
+    threeUpdateMatrix(object3);
+
+    object3.updateMatrixWorld(false);
+}
+
 /**
  *
  * @param {Camera} c
@@ -70089,50 +70133,43 @@ function set_camera_aspect_ratio(camera, width, height) {
 
 /**
  *
- * @param {Object3D} object
+ * @param {Camera} camera
  */
-function threeUpdateMatrix(object) {
-    object.updateMatrix();
+function update_camera_transform(camera) {
 
-    const children = object.children;
-    for (let i = 0, childCount = children.length; i < childCount; i++) {
-        const child = children[i];
+    const three_camera = camera.object;
 
-        threeUpdateMatrix(child);
+    if (three_camera === null) {
+        return;
     }
+
+    three_camera.updateProjectionMatrix();
+    threeUpdateTransform(three_camera);
 }
 
 /**
  *
- * @param {Object3D} object3
+ * @param {THREE.Camera} object
+ * @param {Quaternion} rotation
  */
-function threeUpdateTransform(object3) {
+function three_camera_set_transform_rotation(object, rotation) {
 
-    /**
-     signal that transformation matrix should be updated
-     @see https://threejs.org/docs/index.html#api/core/Object3D.matrixWorldNeedsUpdate
+    /*
+    NOTE: I'm not sure why, but three.js camera points in the opposite direction to normal objects
+    See: https://github.com/mrdoob/three.js/blob/412b99a7f26e117ea97f40eb53d010ab81aa3279/src/core/Object3D.js#L282
      */
-    threeUpdateMatrix(object3);
 
-    object3.updateMatrixWorld(false);
-}
-
-/**
- *
- * @param {Camera} camera
- */
-function update_camera_transform(camera) {
+    invertQuaternionOrientation(object.quaternion, rotation);
 
-    const three_camera = camera.object;
+    object.rotation.setFromQuaternion(object.quaternion);
 
-    if (three_camera === null) {
-        return;
-    }
+    // rotation.__setThreeEuler(camera.object.rotation); // seems unnecessary, based on Object3D.lookAt implementation
+    // camera.object.quaternion.set(rotation.x, rotation.y, rotation.z, rotation.w);
+
+    object.updateProjectionMatrix();
+    threeUpdateTransform(object);
+}
 
-    three_camera.updateProjectionMatrix();
-    threeUpdateTransform(three_camera);
-}
-
 class CameraSystem extends System {
     /**
      *
@@ -70221,19 +70258,7 @@ class CameraSystem extends System {
         function synchronizeRotation() {
             const rotation = transform.rotation;
 
-            /*
-            NOTE: I'm not sure why, but three.js camera points in the opposite direction to normal objects
-            See: https://github.com/mrdoob/three.js/blob/412b99a7f26e117ea97f40eb53d010ab81aa3279/src/core/Object3D.js#L282
-             */
-
-            invertQuaternionOrientation(camera.object.quaternion, rotation);
-
-            camera.object.rotation.setFromQuaternion(camera.object.quaternion);
-
-            // rotation.__setThreeEuler(camera.object.rotation); // seems unnecessary, based on Object3D.lookAt implementation
-            // camera.object.quaternion.set(rotation.x, rotation.y, rotation.z, rotation.w);
-
-            update_camera_transform(camera);
+            three_camera_set_transform_rotation(camera.object, rotation);
         }
 
         function rebuild() {