@woosh/meep-engine 2.43.38 → 2.43.40

package/core/bvh2/aabb3/AABB3.js

@@ -39,6 +39,69 @@ export class AABB3 {
         this.setBounds(x0, y0, z0, x1, y1, z1);
     }
 
+    * [Symbol.iterator]() {
+
+        yield this.x0;
+        yield this.y0;
+        yield this.z0;
+
+        yield this.x1;
+        yield this.y1;
+        yield this.z1;
+
+    }
+
+    get 0() {
+        return this.x0;
+    }
+
+
+    get 1() {
+        return this.y0;
+    }
+
+    get 2() {
+        return this.z0;
+    }
+
+
+    get 3() {
+        return this.x1;
+    }
+
+
+    get 4() {
+        return this.y1;
+    }
+
+    get 5() {
+        return this.z1;
+    }
+
+    set 0(v) {
+        this.x0 = v;
+    }
+
+    set 1(v) {
+        this.y0 = v;
+    }
+
+    set 2(v) {
+        this.z0 = v;
+    }
+
+    set 3(v) {
+        this.x1 = v;
+    }
+
+    set 4(v) {
+        this.y1 = v;
+    }
+
+    set 5(v) {
+        this.z1 = v;
+    }
+
     /**
      *
      * @param {number} x
@@ -816,17 +879,17 @@ export class AABB3 {
     }
 
     /**
-     *
-     * @param {number} v
+     * Expands the box in all directions by the given amount
+     * @param {number} extra
      */
-    grow(v) {
-        this.x0 -= v;
-        this.y0 -= v;
-        this.z0 -= v;
+    grow(extra) {
+        this.x0 -= extra;
+        this.y0 -= extra;
+        this.z0 -= extra;
 
-        this.x1 += v;
-        this.y1 += v;
-        this.z1 += v;
+        this.x1 += extra;
+        this.y1 += extra;
+        this.z1 += extra;
     }
 
     /**
@@ -847,82 +910,6 @@ export class AABB3 {
 }
 
 
-/**
- *
- * @param {BinaryBuffer} buffer
- * @param {AABB3} box
- * @param {number} x0
- * @param {number} y0
- * @param {number} z0
- * @param {number} x1
- * @param {number} y1
- * @param {number} z1
- */
-export function serializeAABB3Encoded_v0(buffer, box, x0, y0, z0, x1, y1, z1) {
-    let header = 0;
-
-    if (box.x0 === x0) {
-        header |= 1;
-    }
-
-    if (box.x1 === x1) {
-        header |= 2;
-    }
-
-    if (box.y0 === y0) {
-        header |= 4;
-    }
-
-    if (box.y1 === y1) {
-        header |= 8;
-    }
-
-    if (box.z0 === z0) {
-        header |= 16;
-    }
-
-    if (box.z1 === z1) {
-        header |= 32;
-    }
-
-    buffer.writeUint8(header);
-
-    //compute value ranges
-    const xD = x1 - x0;
-    const yD = y1 - y0;
-    const zD = z1 - z0;
-
-    if ((header & 1) === 0) {
-        const _x0 = (((box.x0 - x0) / xD) * 65535) | 0;
-        buffer.writeUint16(_x0);
-    }
-
-    if ((header & 2) === 0) {
-        const _x1 = (((box.x1 - x0) / xD) * 65535) | 0;
-        buffer.writeUint16(_x1);
-    }
-
-    if ((header & 4) === 0) {
-        const _y0 = (((box.y0 - y0) / yD) * 65535) | 0;
-        buffer.writeUint16(_y0);
-    }
-
-    if ((header & 8) === 0) {
-        const _y1 = (((box.y1 - y0) / yD) * 65535) | 0;
-        buffer.writeUint16(_y1);
-    }
-
-    if ((header & 16) === 0) {
-        const _z0 = (((box.z0 - z0) / zD) * 65535) | 0;
-        buffer.writeUint16(_z0);
-    }
-
-    if ((header & 32) === 0) {
-        const _z1 = (((box.z1 - z0) / zD) * 65535) | 0;
-        buffer.writeUint16(_z1);
-    }
-}
-
 /**
  * @readonly
  * @type {boolean}

package/core/bvh2/aabb3/serializeAABB3Encoded_v0.js

@@ -0,0 +1,75 @@
+/**
+ *
+ * @param {BinaryBuffer} buffer
+ * @param {AABB3} box
+ * @param {number} x0
+ * @param {number} y0
+ * @param {number} z0
+ * @param {number} x1
+ * @param {number} y1
+ * @param {number} z1
+ */
+export function serializeAABB3Encoded_v0(buffer, box, x0, y0, z0, x1, y1, z1) {
+    let header = 0;
+
+    if (box.x0 === x0) {
+        header |= 1;
+    }
+
+    if (box.x1 === x1) {
+        header |= 2;
+    }
+
+    if (box.y0 === y0) {
+        header |= 4;
+    }
+
+    if (box.y1 === y1) {
+        header |= 8;
+    }
+
+    if (box.z0 === z0) {
+        header |= 16;
+    }
+
+    if (box.z1 === z1) {
+        header |= 32;
+    }
+
+    buffer.writeUint8(header);
+
+    //compute value ranges
+    const xD = x1 - x0;
+    const yD = y1 - y0;
+    const zD = z1 - z0;
+
+    if ((header & 1) === 0) {
+        const _x0 = (((box.x0 - x0) / xD) * 65535) | 0;
+        buffer.writeUint16(_x0);
+    }
+
+    if ((header & 2) === 0) {
+        const _x1 = (((box.x1 - x0) / xD) * 65535) | 0;
+        buffer.writeUint16(_x1);
+    }
+
+    if ((header & 4) === 0) {
+        const _y0 = (((box.y0 - y0) / yD) * 65535) | 0;
+        buffer.writeUint16(_y0);
+    }
+
+    if ((header & 8) === 0) {
+        const _y1 = (((box.y1 - y0) / yD) * 65535) | 0;
+        buffer.writeUint16(_y1);
+    }
+
+    if ((header & 16) === 0) {
+        const _z0 = (((box.z0 - z0) / zD) * 65535) | 0;
+        buffer.writeUint16(_z0);
+    }
+
+    if ((header & 32) === 0) {
+        const _z1 = (((box.z1 - z0) / zD) * 65535) | 0;
+        buffer.writeUint16(_z1);
+    }
+}

package/core/bvh2/serialization/serializeBinaryNodeToBinaryBuffer.js

@@ -1,5 +1,5 @@
-import { serializeAABB3Encoded_v0 } from "../aabb3/AABB3.js";
 import { serializeAABB3 } from "../aabb3/serializeAABB3.js";
+import { serializeAABB3Encoded_v0 } from "../aabb3/serializeAABB3Encoded_v0.js";
 
 /**
  *

package/core/collection/HashMap.js

@@ -177,7 +177,7 @@ export class HashMap {
         // mix the input hash to minimize potential impact of poor hash function spread
         const mixed_hash = (hash >>> 16) ^ hash;
 
-        // ensure index is non-negative
+        // force index to unsigned integer
         const index = mixed_hash >>> 0;
 
         return index % this.__bucket_count;
@@ -194,7 +194,9 @@ export class HashMap {
 
         assert.isFiniteNumber(bucket_index, 'hash');
 
-        let bucket = this.records[bucket_index];
+        const records = this.records;
+
+        let bucket = records[bucket_index];
 
         if (bucket === undefined) {
 
@@ -202,7 +204,7 @@ export class HashMap {
 
             bucket = [];
 
-            this.records[bucket_index] = bucket;
+            records[bucket_index] = bucket;
 
         } else {
 
@@ -218,7 +220,11 @@ export class HashMap {
 
                 if (entryKey === key || this.keyEqualityFunction(entryKey, key)) {
 
+                    // found record with matching key, replace the value
+
                     entry.value = value;
+
+                    // done, return
                     return;
 
                 }
@@ -237,7 +243,7 @@ export class HashMap {
         const load = new_size / this.__bucket_count;
 
         if (load > this.__load_factor) {
-            // increase table size
+            // current load is too high, increase table size
             this.setBucketCount(this.__bucket_count * 2);
         }
     }
@@ -276,7 +282,9 @@ export class HashMap {
     }
 
     /**
+     * If key exists in the map - returns stored value, if it doesn't - invokes `compute` function and stores produced value in the map; then returns that value
      *
+     * Inspired by Java's implementation
      * @param {K} key
      * @param {function(K):V} compute
      * @param {*} [compute_context]
@@ -402,14 +410,14 @@ export class HashMap {
      */
     rebuild() {
 
-        let h, i, l;
+        let string_bucket_index, i, l;
 
         const records = this.records;
 
-        for (h in records) {
-            const stored_bucket_index = parseInt(h);
+        for (string_bucket_index in records) {
+            const stored_bucket_index = parseInt(string_bucket_index);
 
-            if (!records.hasOwnProperty(h)) {
+            if (!records.hasOwnProperty(string_bucket_index)) {
                 continue;
             }
 

package/core/color/Color.js

@@ -5,7 +5,7 @@ import { min2 } from "../math/min2.js";
 import { max2 } from "../math/max2.js";
 import { min3 } from "../math/min3.js";
 import { computeHashIntegerArray } from "../collection/array/computeHashIntegerArray.js";
-import { computeHashFloat } from "../math/hash/computeHashFloat.js";
+import { computeHashFloat } from "../primitives/numbers/computeHashFloat.js";
 import { rgb2hsv } from "./rgb2hsv.js";
 import { rgb2uint24 } from "./rgb2uint24.js";
 import { clamp01 } from "../math/clamp01.js";

package/core/geom/3d/aabb/aabb3_matrix4_project.js

@@ -1,3 +1,5 @@
+import { assert } from "../../../assert.js";
+
 /**
  * NOTE: Based on Transforming Axis-Aligned Bounding Boxes by Jim Arvo from "Graphics Gems", Academic Press, 1990
  * NOTE: {@link result} and {@link aabb} must be different objects
@@ -6,6 +8,8 @@
  * @param {number[]} matrix 4x4 matrix
  */
 export function aabb3_matrix4_project(result, aabb, matrix) {
+    assert.notEqual(result, aabb, 'input and output must not be the same for algorithm to work correctly');
+
     // extract translation from matrix
     result[0] = result[3] = matrix[12];
     result[1] = result[4] = matrix[13];

package/core/geom/ConicRay.js

@@ -1,7 +1,7 @@
 import { assert } from "../assert.js";
 import Vector3 from "./Vector3.js";
 import { computeHashIntegerArray } from "../collection/array/computeHashIntegerArray.js";
-import { computeHashFloat } from "../math/hash/computeHashFloat.js";
+import { computeHashFloat } from "../primitives/numbers/computeHashFloat.js";
 import { epsilonEquals } from "../math/epsilonEquals.js";
 import { EPSILON } from "../math/EPSILON.js";
 

package/core/geom/Quaternion.d.ts

@@ -13,6 +13,11 @@ export default class Quaternion {
     public z: number
     public w: number
 
+    0: number
+    1: number
+    2: number
+    3: number
+
     readonly onChanged: Signal<number, number, number, number, number, number, number, number>;
 
     set(x: number, y: number, z: number, w: number): void
@@ -61,9 +66,9 @@ export default class Quaternion {
 
     fromJSON(j: any): void
 
-    readFromArray(array: ArrayLike<number>, offset: number): void
+    readFromArray(array: ArrayLike<number>, offset?: number): void
 
-    writeToArray(array: ArrayLike<number>, offset: number): void
+    writeToArray(array: ArrayLike<number>, offset?: number): void
 
     asArray(): number[]
 }

package/core/geom/Quaternion.js

@@ -11,7 +11,7 @@ import { lerp } from "../math/lerp.js";
 import Vector3 from "./Vector3.js";
 import { v3_dot } from "./v3_dot.js";
 import { min2 } from "../math/min2.js";
-import { computeHashFloat } from "../math/hash/computeHashFloat.js";
+import { computeHashFloat } from "../primitives/numbers/computeHashFloat.js";
 import { epsilonEquals } from "../math/epsilonEquals.js";
 import { EPSILON } from "../math/EPSILON.js";
 
@@ -154,6 +154,22 @@ class Quaternion {
         return this.w;
     }
 
+    set 0(v) {
+        this.x = v;
+    }
+
+    set 1(v) {
+        this.y = v;
+    }
+
+    set 2(v) {
+        this.z = v;
+    }
+
+    set 3(v) {
+        this.w = v;
+    }
+
     /**
      *
      * @param {number} fx forward vector
@@ -1655,7 +1671,7 @@ class Quaternion {
      * @param {number[]} array
      * @param {number} offset
      */
-    readFromArray(array, offset) {
+    readFromArray(array, offset=0) {
         this.set(
             array[offset],
             array[offset + 1],
@@ -1669,7 +1685,7 @@ class Quaternion {
      * @param {number[]} array
      * @param {number} offset
      */
-    writeToArray(array, offset) {
+    writeToArray(array, offset=0) {
         array[offset] = this.x;
         array[offset + 1] = this.y;
         array[offset + 2] = this.z;

package/core/geom/Vector1.d.ts

@@ -1,7 +1,17 @@
+import Signal from "../events/signal/Signal";
+
 export default class Vector1 {
     x: number
 
-    set(v: number)
+    0: number
+
+    readonly onChanged: Signal<number,number>
+
+    constructor()
+
+    constructor(x: number)
+
+    set(v: number) : void
 
     getValue(): number
 
@@ -13,5 +23,13 @@ export default class Vector1 {
 
     process(callback: (x) => any): void
 
+    toJSON(): any
+
+    fromJSON(j: any): void
+
+    readFromArray(array: ArrayLike<number>, offset?: number): void
+
+    writeToArray(array: ArrayLike<number>, offset?: number): void
+
     asArray(): number[]
 }

package/core/geom/Vector1.js

@@ -6,7 +6,7 @@
 import { assert } from "../assert.js";
 import Signal from "../events/signal/Signal.js";
 import { clamp } from "../math/clamp.js";
-import { computeHashFloat } from "../math/hash/computeHashFloat.js";
+import { computeHashFloat } from "../primitives/numbers/computeHashFloat.js";
 
 
 class Vector1 extends Number {
@@ -223,7 +223,7 @@ class Vector1 extends Number {
      * @param {number[]} array
      * @param {number} offset
      */
-    readFromArray(array, offset) {
+    readFromArray(array, offset=0) {
         this.set(array[offset]);
     }
 
@@ -232,7 +232,7 @@ class Vector1 extends Number {
      * @param {number[]} array
      * @param {number} offset
      */
-    writeToArray(array, offset) {
+    writeToArray(array, offset=0) {
         array[offset] = this.x;
     }
 
@@ -268,6 +268,14 @@ class Vector1 extends Number {
         return a.x - b.x;
     }
 
+    get 0() {
+        return this.x;
+    }
+
+    set 0(v) {
+        this.x = v;
+    }
+
     * [Symbol.iterator]() {
 
         yield this.x;

package/core/geom/Vector2.d.ts

@@ -4,6 +4,9 @@ export default class Vector2 {
     x: number
     y: number
 
+    0: number
+    1: number
+
     public readonly onChanged: Signal<number, number, number, number>
 
     constructor(x: number, y: number)
@@ -36,5 +39,9 @@ export default class Vector2 {
 
     isZero(): boolean
 
+    readFromArray(array: ArrayLike<number>, offset?: number): void
+
+    writeToArray(array: ArrayLike<number>, offset?: number): void
+
     asArray():number[]
 }

package/core/geom/Vector2.js

@@ -46,7 +46,7 @@ class Vector2 {
      * @param {number[]} array
      * @param {number} offset
      */
-    readFromArray(array, offset) {
+    readFromArray(array, offset = 0) {
         this.set(
             array[offset],
             array[offset + 1]
@@ -58,15 +58,15 @@ class Vector2 {
      * @param {number[]} array
      * @param {number} offset
      */
-    writeToArray(array, offset) {
+    writeToArray(array, offset = 0) {
         array[offset] = this.x;
         array[offset + 1] = this.y;
     }
 
-    asArray(){
+    asArray() {
         const r = [];
 
-        this.writeToArray(r,0);
+        this.writeToArray(r, 0);
 
         return r;
     }
@@ -588,6 +588,23 @@ class Vector2 {
         return this.x === other.x && this.y === other.y;
     }
 
+    get 0() {
+        return this.x;
+    }
+
+    get 1() {
+        return this.y;
+    }
+
+    set 0(v) {
+        this.x = v;
+    }
+
+    set 1(v) {
+        this.y = v;
+    }
+
+
     * [Symbol.iterator]() {
 
         yield this.x;

package/core/geom/Vector3.d.ts

@@ -47,7 +47,7 @@ export default class Vector3 implements Vector3Like {
 
     ceil(): void
 
-    multiplyVectors(a:Vector3Like,b:Vector3Like):void
+    multiplyVectors(a: Vector3Like, b: Vector3Like): void
 
     _multiply(x: number, y: number, z: number): void
 
@@ -91,11 +91,11 @@ export default class Vector3 implements Vector3Like {
 
     toJSON(): any
 
-    fromJSON(json: { x?: number, y?: number, z?: number })
+    fromJSON(json: { x?: number, y?: number, z?: number } | number): void
 
-    readFromArray(array: number[] | ArrayLike<number>, offset: number): void
+    readFromArray(array: number[] | ArrayLike<number>, offset?: number): void
 
-    writeToArray(array: number[] | ArrayLike<number>, offset: number): void
+    writeToArray(array: number[] | ArrayLike<number>, offset?: number): void
 
     asArray(): number[]
 

package/core/geom/Vector3.js

@@ -13,7 +13,7 @@ import { v3_length } from "./v3_length.js";
 import { v3_angle_between } from "./v3_angle_between.js";
 import { v3_lerp } from "./v3_lerp.js";
 import { v3_slerp } from "./v3_slerp.js";
-import { computeHashFloat } from "../math/hash/computeHashFloat.js";
+import { computeHashFloat } from "../primitives/numbers/computeHashFloat.js";
 import { epsilonEquals } from "../math/epsilonEquals.js";
 import { EPSILON } from "../math/EPSILON.js";
 
@@ -38,7 +38,7 @@ class Vector3 {
      * @param {number[]} array
      * @param {number} offset
      */
-    readFromArray(array, offset) {
+    readFromArray(array, offset=0) {
         this.set(
             array[offset],
             array[offset + 1],
@@ -51,7 +51,7 @@ class Vector3 {
      * @param {number[]} array
      * @param {number} offset
      */
-    writeToArray(array, offset) {
+    writeToArray(array, offset=0) {
         array[offset] = this.x;
         array[offset + 1] = this.y;
         array[offset + 2] = this.z;
@@ -806,7 +806,7 @@ class Vector3 {
     }
 
     toString() {
-        return `[x:${this.x},y:${this.y},z:${this.z}]`;
+        return `[x:${this.x}, y:${this.y}, z:${this.z}]`;
     }
 
     /**
@@ -952,6 +952,31 @@ class Vector3 {
         return hash;
     }
 
+
+    get 0() {
+        return this.x;
+    }
+
+    get 1() {
+        return this.y;
+    }
+
+    get 2() {
+        return this.z;
+    }
+
+    set 0(v) {
+        this.x = v;
+    }
+
+    set 1(v) {
+        this.y = v;
+    }
+
+    set 2(v) {
+        this.z = v;
+    }
+
     * [Symbol.iterator]() {
 
         yield this.x;