@woosh/meep-engine 2.39.15 → 2.39.18

package/core/binary/int32_to_binary_string.js

@@ -0,0 +1,18 @@
+/**
+ * @see https://stackoverflow.com/questions/9939760/how-do-i-convert-an-integer-to-binary-in-javascript
+ * @example 1024    -> "00000000 00000000 00000100 00000000"
+ * @example -1      -> "11111111 11111111 11111111 11111111"
+ * @param {number} nMask
+ * @returns {string}
+ */
+export function int32_to_binary_string(nMask) {
+    // nMask must be between -2147483648 and 2147483647
+    if (nMask > 2 ** 31 - 1)
+        throw "number too large. number shouldn't be > 2**31-1"; //added
+    if (nMask < -1 * (2 ** 31))
+        throw "number too far negative, number shouldn't be < 2**31" //added
+    for (var nFlag = 0, nShifted = nMask, sMask = ''; nFlag < 32;
+         nFlag++, sMask += String(nShifted >>> 31), nShifted <<= 1) ;
+    sMask = sMask.replace(/\B(?=(.{8})+(?!.))/g, " ") // added
+    return sMask;
+}

package/core/cache/Cache.js

@@ -5,7 +5,7 @@ import { returnOne, returnZero, strictEquals } from "../function/Functions.js";
 import { CacheElement } from "./CacheElement.js";
 
 /**
- *
+ * TODO validate hashes of held elements to keep them up to date. Keys are assumed to be immutable, but this assumption may be broken by users
  * @template Key, Value
  * @extends Map<Key,Value>
  */

package/core/geom/3d/decompose_matrix_4_array.js

@@ -26,7 +26,7 @@ export function decompose_matrix_4_array(m, position, rotation, scale) {
 
     const scale_z = hypot(m31, m32, m33);
 
-    // extract rotation
+    // extract rotation matrix
     const is1 = 1 / scale_x;
     const is2 = 1 / scale_y;
     const is3 = 1 / scale_z;
@@ -43,6 +43,8 @@ export function decompose_matrix_4_array(m, position, rotation, scale) {
     const sm32 = m32 * is3;
     const sm33 = m33 * is3;
 
+    // TODO take care of cases where scale is 0
+
     // write out results
 
     position.set(

package/core/geom/3d/ray/ray3_array_apply_matrix4.js

@@ -3,6 +3,7 @@
  * @param {number[]|ArrayLike<number>|Float32Array} output 6 component vector, [origin_x, origin_y, origin_z, direction_x, direction_y, direction_z]
  * @param {number[]|ArrayLike<number>|Float32Array} input 6 component vector, [origin_x, origin_y, origin_z, direction_x, direction_y, direction_z]
  * @param {number[]|ArrayLike<number>|Float32Array} m4 4x4 matrix
+ * @returns {boolean} false if matrix transformation is impossible, such as when scale of the matrix is 0
  */
 export function ray3_array_apply_matrix4(output, input, m4) {
     const origin_x = input[0];
@@ -14,7 +15,13 @@ export function ray3_array_apply_matrix4(output, input, m4) {
     const direction_z = input[5];
 
     // transform ray to local space (inlined for speed)
-    const inv_w = 1 / (m4[3] * origin_x + m4[7] * origin_y + m4[11] * origin_z + m4[15]);
+    const det = m4[3] * origin_x + m4[7] * origin_y + m4[11] * origin_z + m4[15];
+
+    if (det === 0) {
+        return false;
+    }
+
+    const inv_w = 1 / det;
 
     const out_origin_x = (m4[0] * origin_x + m4[4] * origin_y + m4[8] * origin_z + m4[12]) * inv_w;
     const out_origin_y = (m4[1] * origin_x + m4[5] * origin_y + m4[9] * origin_z + m4[13]) * inv_w;
@@ -26,6 +33,11 @@ export function ray3_array_apply_matrix4(output, input, m4) {
 
     // normalize direction
     const out_direction_magnitude = Math.hypot(out_direction_x, out_direction_y, out_direction_z);
+
+    if (out_direction_magnitude === 0) {
+        return false;
+    }
+
     const out_direction_magnitude_inverse = 1 / out_direction_magnitude;
 
     const out_direction_normalized_x = out_direction_x * out_direction_magnitude_inverse;
@@ -39,4 +51,6 @@ export function ray3_array_apply_matrix4(output, input, m4) {
     output[3] = out_direction_normalized_x;
     output[4] = out_direction_normalized_y;
     output[5] = out_direction_normalized_z;
+
+    return true;
 }

package/editor/tools/v2/TransformControls.d.ts

@@ -0,0 +1,15 @@
+import {OrthographicCamera, PerspectiveCamera} from "three";
+import {EntityComponentDataset} from "../../../engine/ecs/EntityComponentDataset";
+import {EntityNode} from "../../../engine/ecs/parent/EntityNode";
+
+export class TransformControls extends EntityNode {
+    constructor(camera: PerspectiveCamera | OrthographicCamera, domElement: HTMLElement)
+
+    build(ecd: EntityComponentDataset): void
+
+    destroy(): void
+
+    attach(entity: number): void
+
+    detach(): void
+}