@woosh/meep-engine 2.117.21 → 2.117.23

package/build/meep.module.js

@@ -52064,19 +52064,52 @@ class TerrainPreview {
 const UINT32_MAX = 4294967295;
 
 /**
- * Assumes arrays have the same type
- * @param {TypedArray|Float32Array|Uint8Array|Uint32Array} source
- * @param {TypedArray|Float32Array|Uint8Array|Uint32Array} destination
+ * This is essentially a {@link memcopy} implementation for ArrayBuffers
+ * NOTE: allocates light-weight typed arrays under the hood, so beware of potential GC implications. Generally not an issue, unless you're copying very large number of very small arrays, consider alternatives such as {@link array_copy} instead
+ * @param {ArrayBuffer} source
+ * @param {number} source_offset
+ * @param {ArrayBuffer} target
+ * @param {number} target_offset
+ * @param {number} byte_length
  */
-function typed_array_copy(source, destination) {
-    const destination_size = destination.length;
+function array_buffer_copy(
+    source, source_offset,
+    target, target_offset,
+    byte_length
+) {
+
+    /**
+     * @type {Uint8Array|Uint16Array|Uint32Array}
+     */
+    let source_array;
+    /**
+     * @type {Uint8Array|Uint16Array|Uint32Array}
+     */
+    let target_array;
+
+    const alignment = largest_common_alignment_uint32(source_offset,target_offset,byte_length);
+
+    if (
+        alignment === 4
+    ) {
+        // aligned on 4-byte boundary
+        source_array = new Uint32Array(source, source_offset, byte_length >>> 2);
+        target_array = new Uint32Array(target, target_offset, byte_length >>> 2);
+
+    } else if (
+        alignment === 2
+    ) {
+        // aligned on 2-byte boundary
+        source_array = new Uint16Array(source, source_offset, byte_length >>> 1);
+        target_array = new Uint16Array(target, target_offset, byte_length >>> 1);
 
-    if (destination_size >= source.length) {
-        destination.set(source, 0);
     } else {
-        // destination is smaller than source, crop source data
-        array_copy(source, 0, destination, 0, destination_size);
+        // worst-case, assume 1-byte boundary
+        source_array = new Uint8Array(source, source_offset, byte_length);
+        target_array = new Uint8Array(target, target_offset, byte_length);
     }
+
+    target_array.set(source_array);
 }
 
 /**
@@ -52165,6 +52198,16 @@ class BVH {
      */
     __data_buffer = new ArrayBuffer(INITIAL_CAPACITY * ELEMENT_WORD_COUNT * 4);
 
+    /**
+     * Access raw data
+     * Useful for serialization
+     * If you intend to modify the data directly - make sure you fully understand the implications of doing so
+     * @returns {ArrayBuffer}
+     */
+    get data_buffer(){
+        return this.__data_buffer;
+    }
+
     /**
      *
      * @type {Float32Array}
@@ -52290,7 +52333,11 @@ class BVH {
         this.__data_uint32 = new Uint32Array(new_data_buffer);
 
         // copy old data into new buffer
-        typed_array_copy(old_data_uint32, this.__data_uint32);
+        array_buffer_copy(
+            old_data_uint32.buffer, old_data_uint32.byteOffset,
+            new_data_buffer, 0,
+            Math.min(old_data_uint32.byteLength, new_data_buffer.byteLength)
+        );
 
         this.__capacity = new_capacity;
     }
@@ -61428,6 +61475,22 @@ Cache.prototype.delete = Cache.prototype.remove;
  */
 Cache.prototype.has = Cache.prototype.contains;
 
+/**
+ * Assumes arrays have the same type
+ * @param {TypedArray|Float32Array|Uint8Array|Uint32Array} source
+ * @param {TypedArray|Float32Array|Uint8Array|Uint32Array} destination
+ */
+function typed_array_copy(source, destination) {
+    const destination_size = destination.length;
+
+    if (destination_size >= source.length) {
+        destination.set(source, 0);
+    } else {
+        // destination is smaller than source, crop source data
+        array_copy(source, 0, destination, 0, destination_size);
+    }
+}
+
 /**
  *
  * @param {Object} a

package/package.json

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

package/src/core/bvh2/bvh3/BVH.d.ts

@@ -3,6 +3,8 @@ export declare class BVH {
 
     node_capacity: number
 
+    readonly data_buffer: ArrayBuffer
+
     allocate_node(): number
 
     release_node(node: number): void

package/src/core/bvh2/bvh3/BVH.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"BVH.d.ts","sourceRoot":"","sources":["../../../../../src/core/bvh2/bvh3/BVH.js"],"names":[],"mappings":"AAQA,8BAA+B;AAC/B,+BAAgC;AAChC,+BAAgC;AAChC,8BAA+B;AAE/B;;;;;GAKG;AACH,+BAFU,MAAM,CAE+B;AAE/C;;;GAGG;AACH,wBAFU,MAAM,CAEoB;AAcpC;;;;;GAKG;AACH,iCAFU,MAAM,CAEqB;AAgBrC;;;;;;GAMG;AACH;IAEI;;;;OAIG;IACH,sBAA2E;IAE3E;;;;OAIG;IACH,uBAAsD;IAEtD;;;;OAIG;IACH,sBAAoD;IAEpD;;;;OAIG;IACH,mBAA8B;IAE9B;;;;OAIG;IACH,eAAW;IAEX;;;;OAIG;IACH,eAAY;IAEZ;;;;OAIG;IACH,uBAAmB;IAEnB;;;;OAIG;IACH,eAAmB;IAUnB;;;OAGG;IACH,sBAEC;IAdD;;;OAGG;IACH,mBAEC;IAkBD;;;OAGG;IACH,+BAMC;IAlBD;;;OAGG;IACH,4BAEC;IAcD,wBAgBC;IAED;;;;OAIG;IACH,uBAqBC;IAED;;OAEG;IACH,aAIC;IAED;;;OAGG;IACH,iBAFa,MAAM,CAqDlB;IAED;;;;OAIG;IACH,iBAFW,MAAM,QAMhB;IAED;;;;OAIG;IACH,iBAHW,MAAM,GACJ,OAAO,CAOnB;IAED;;;;OAIG;IACH,uBAHW,MAAM,GACJ,MAAM,CAKlB;IAED;;;;OAIG;IACH,uBAHW,MAAM,SACN,MAAM,QAOhB;IAED;;;;OAIG;IACH,oBAHW,MAAM,GACJ,MAAM,CAKlB;IAED;;;;OAIG;IACH,sBAHW,MAAM,UACN,MAAM,QAIhB;IAED;;;;OAIG;IACH,oBAHW,MAAM,GACJ,MAAM,CAKlB;IAED;;;;OAIG;IACH,sBAHW,MAAM,UACN,MAAM,QAIhB;IAED;;;;OAIG;IACH,oBAHW,MAAM,GACJ,MAAM,CAKlB;IAED;;;;OAIG;IACH,sBAHW,MAAM,UACN,MAAM,QAIhB;IAGD;;;;OAIG;IACH,oBAHW,MAAM,GACJ,MAAM,CAKlB;IAED;;;;OAIG;IACH,oBAHW,MAAM,UACN,MAAM,QAKhB;IAED;;;;OAIG;IACH,kBAHW,MAAM,UACN,MAAM,EAAE,GAAC,YAAY,QAe/B;IAED;;;;OAIG;IACH,kBAHW,MAAM,QACN,MAAM,EAAE,GAAC,UAAU,MAAM,CAAC,QAAM,QAsB1C;IAED;;;;OAIG;IACH,mBAHW,MAAM,QACN,MAAM,EAAE,QAWlB;IAED;;;;;;;;;OASG;IACH,4BARW,MAAM,MACN,MAAM,MACN,MAAM,MACN,MAAM,MACN,MAAM,MACN,MAAM,MACN,MAAM,QAmBhB;IAED;;;;OAIG;IACH,0BAHW,MAAM,GACJ,MAAM,CAoBlB;IAED;;;;;OAKG;IACH,wCAJW,MAAM,WACN,MAAM,GACJ,MAAM,CAoClB;IAED;;;;;OAKG;IACH,oCAJW,MAAM,WACN,MAAM,WACN,MAAM,QAwChB;IAED;;;;OAIG;IACH,kBAHW,MAAM,GACJ,IAAI,CA0GhB;IAED;;;;;OAKG;IACH,wBAqBC;IAED;;;;OAIG;IACH,yBA4BC;IAED;;;;OAIG;IACH,kBAHW,MAAM,GACJ,IAAI,CA6ChB;IAED;;;;;;OAMG;IACH,gBAoMC;IAED;;;OAGG;IACH,oBAIC;IAED;;;;OAIG;IACH,yCA8BC;IAED;;;;;OAKG;IACH,+BAJW,MAAM,EAAE,sBACR,MAAM,GACJ,MAAM,CAWlB;IAED;;;;;OAKG;IACH,0BA6BC;IAED;;;;;OAKG;IACH,cAJW,MAAM,KACN,MAAM,GACJ,OAAO,CAsCnB;CACJ"}
+{"version":3,"file":"BVH.d.ts","sourceRoot":"","sources":["../../../../../src/core/bvh2/bvh3/BVH.js"],"names":[],"mappings":"AAQA,8BAA+B;AAC/B,+BAAgC;AAChC,+BAAgC;AAChC,8BAA+B;AAE/B;;;;;GAKG;AACH,+BAFU,MAAM,CAE+B;AAE/C;;;GAGG;AACH,wBAFU,MAAM,CAEoB;AAcpC;;;;;GAKG;AACH,iCAFU,MAAM,CAEqB;AAgBrC;;;;;;GAMG;AACH;IAEI;;;;OAIG;IACH,sBAA2E;IAE3E;;;;;OAKG;IACH,+BAEC;IAED;;;;OAIG;IACH,uBAAsD;IAEtD;;;;OAIG;IACH,sBAAoD;IAEpD;;;;OAIG;IACH,mBAA8B;IAE9B;;;;OAIG;IACH,eAAW;IAEX;;;;OAIG;IACH,eAAY;IAEZ;;;;OAIG;IACH,uBAAmB;IAEnB;;;;OAIG;IACH,eAAmB;IAUnB;;;OAGG;IACH,sBAEC;IAdD;;;OAGG;IACH,mBAEC;IAkBD;;;OAGG;IACH,+BAMC;IAlBD;;;OAGG;IACH,4BAEC;IAcD,wBAgBC;IAED;;;;OAIG;IACH,uBAyBC;IAED;;OAEG;IACH,aAIC;IAED;;;OAGG;IACH,iBAFa,MAAM,CAqDlB;IAED;;;;OAIG;IACH,iBAFW,MAAM,QAMhB;IAED;;;;OAIG;IACH,iBAHW,MAAM,GACJ,OAAO,CAOnB;IAED;;;;OAIG;IACH,uBAHW,MAAM,GACJ,MAAM,CAKlB;IAED;;;;OAIG;IACH,uBAHW,MAAM,SACN,MAAM,QAOhB;IAED;;;;OAIG;IACH,oBAHW,MAAM,GACJ,MAAM,CAKlB;IAED;;;;OAIG;IACH,sBAHW,MAAM,UACN,MAAM,QAIhB;IAED;;;;OAIG;IACH,oBAHW,MAAM,GACJ,MAAM,CAKlB;IAED;;;;OAIG;IACH,sBAHW,MAAM,UACN,MAAM,QAIhB;IAED;;;;OAIG;IACH,oBAHW,MAAM,GACJ,MAAM,CAKlB;IAED;;;;OAIG;IACH,sBAHW,MAAM,UACN,MAAM,QAIhB;IAGD;;;;OAIG;IACH,oBAHW,MAAM,GACJ,MAAM,CAKlB;IAED;;;;OAIG;IACH,oBAHW,MAAM,UACN,MAAM,QAKhB;IAED;;;;OAIG;IACH,kBAHW,MAAM,UACN,MAAM,EAAE,GAAC,YAAY,QAe/B;IAED;;;;OAIG;IACH,kBAHW,MAAM,QACN,MAAM,EAAE,GAAC,UAAU,MAAM,CAAC,QAAM,QAsB1C;IAED;;;;OAIG;IACH,mBAHW,MAAM,QACN,MAAM,EAAE,QAWlB;IAED;;;;;;;;;OASG;IACH,4BARW,MAAM,MACN,MAAM,MACN,MAAM,MACN,MAAM,MACN,MAAM,MACN,MAAM,MACN,MAAM,QAmBhB;IAED;;;;OAIG;IACH,0BAHW,MAAM,GACJ,MAAM,CAoBlB;IAED;;;;;OAKG;IACH,wCAJW,MAAM,WACN,MAAM,GACJ,MAAM,CAoClB;IAED;;;;;OAKG;IACH,oCAJW,MAAM,WACN,MAAM,WACN,MAAM,QAwChB;IAED;;;;OAIG;IACH,kBAHW,MAAM,GACJ,IAAI,CA0GhB;IAED;;;;;OAKG;IACH,wBAqBC;IAED;;;;OAIG;IACH,yBA4BC;IAED;;;;OAIG;IACH,kBAHW,MAAM,GACJ,IAAI,CA6ChB;IAED;;;;;;OAMG;IACH,gBAoMC;IAED;;;OAGG;IACH,oBAIC;IAED;;;;OAIG;IACH,yCA8BC;IAED;;;;;OAKG;IACH,+BAJW,MAAM,EAAE,sBACR,MAAM,GACJ,MAAM,CAWlB;IAED;;;;;OAKG;IACH,0BA6BC;IAED;;;;;OAKG;IACH,cAJW,MAAM,KACN,MAAM,GACJ,OAAO,CAsCnB;CACJ"}

package/src/core/bvh2/bvh3/BVH.js

@@ -1,7 +1,7 @@
 import { assert } from "../../assert.js";
 import { UINT32_MAX } from "../../binary/UINT32_MAX.js";
 import { array_copy } from "../../collection/array/array_copy.js";
-import { typed_array_copy } from "../../collection/array/typed/typed_array_copy.js";
+import { array_buffer_copy } from "../../collection/array/typed/array_buffer_copy.js";
 import { aabb3_compute_surface_area } from "../../geom/3d/aabb/aabb3_compute_surface_area.js";
 import { max2 } from "../../math/max2.js";
 import { min2 } from "../../math/min2.js";
@@ -75,6 +75,16 @@ export class BVH {
      */
     __data_buffer = new ArrayBuffer(INITIAL_CAPACITY * ELEMENT_WORD_COUNT * 4);
 
+    /**
+     * Access raw data
+     * Useful for serialization
+     * If you intend to modify the data directly - make sure you fully understand the implications of doing so
+     * @returns {ArrayBuffer}
+     */
+    get data_buffer(){
+        return this.__data_buffer;
+    }
+
     /**
      *
      * @type {Float32Array}
@@ -201,7 +211,11 @@ export class BVH {
         this.__data_uint32 = new Uint32Array(new_data_buffer);
 
         // copy old data into new buffer
-        typed_array_copy(old_data_uint32, this.__data_uint32);
+        array_buffer_copy(
+            old_data_uint32.buffer, old_data_uint32.byteOffset,
+            new_data_buffer, 0,
+            Math.min(old_data_uint32.byteLength, new_data_buffer.byteLength)
+        );
 
         this.__capacity = new_capacity;
     }