@woosh/meep-engine 2.92.14 → 2.92.15

package/package.json

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

package/src/core/geom/3d/topology/struct/binary/BinaryElementPool.d.ts

@@ -8,12 +8,6 @@ export class BinaryElementPool {
      * @param {number} initial_capacity how many items to reverse in the newly created pool
      */
     constructor(item_size: number, initial_capacity?: number);
-    /**
-     * Size of a single pool item in bytes
-     * @type {number}
-     * @private
-     */
-    private __item_size;
     /**
      * Unused slots
      * @type {number[]}
@@ -27,18 +21,60 @@ export class BinaryElementPool {
      * @private
      */
     private __free_pointer;
-    __data_buffer: ArrayBuffer;
-    __data_uint8: Uint8Array;
-    __data_uint32: Uint32Array;
-    __data_float32: Float32Array;
-    data_view: DataView;
-    __capacity: number;
     /**
      *
      * @type {number}
      * @private
      */
     private __size;
+    /**
+     * Size of a single pool item in bytes
+     * @type {number}
+     * @private
+     */
+    private __item_size;
+    /**
+     *
+     * @type {ArrayBuffer}
+     * @private
+     */
+    private __data_buffer;
+    /**
+     *
+     * @type {Uint8Array}
+     * @private
+     */
+    private __data_uint8;
+    /**
+     *
+     * @type {Uint32Array}
+     * @private
+     */
+    private __data_uint32;
+    /**
+     *
+     * @type {Float32Array}
+     * @private
+     */
+    private __data_float32;
+    data_view: DataView;
+    /**
+     *
+     * @type {number}
+     * @private
+     */
+    private __capacity;
+    /**
+     *
+     * @param {ArrayBuffer} buffer
+     * @param {number} allocated_record_count
+     */
+    fromArrayBuffer(buffer: ArrayBuffer, allocated_record_count?: number): void;
+    /**
+     * Size of a single record in bytes
+     * @return {number}
+     */
+    get item_size(): number;
     /**
      * Returns size of used region, this includes both elements that are allocated and those that aren't
      * Please note that this value does not represent number of currently active elements, if you need that - you'll need to use something else

package/src/core/geom/3d/topology/struct/binary/BinaryElementPool.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"BinaryElementPool.d.ts","sourceRoot":"","sources":["../../../../../../../../src/core/geom/3d/topology/struct/binary/BinaryElementPool.js"],"names":[],"mappings":"AAwBA;;GAEG;AACH;IAEI;;;;OAIG;IACH,uBAHW,MAAM,qBACN,MAAM,EA0ChB;IApCG;;;;OAIG;IACH,oBAA4B;IAE5B;;;;OAIG;IACH,eAAgB;IAEhB;;;;;OAKG;IACH,uBAAuB;IAEvB,2BAA2E;IAC3E,yBAAsD;IACtD,2BAAwD;IACxD,6BAA0D;IAC1D,oBAAiD;IAEjD,mBAAkC;IAElC;;;;OAIG;IACH,eAAe;IAGnB;;;;OAIG;IACH,mBAEC;IAED;;;OAGG;IACH,uBAEC;IAED;;;OAGG;IACH,+BAEC;IAED;;;OAGG;IACH,iCAEC;IAED;;OAEG;IACH,aAEC;IAED;;;;OAIG;IACH,oBAHW,MAAM,GACL,MAAM,CAMjB;IAED;;;;;OAKG;IACH,iBAHW,MAAM,GACL,MAAM,CAIjB;IAED;;;;OAIG;IACH,iBAHW,MAAM,GACL,OAAO,CAsBlB;IAED;;;;OAIG;IACH,uBAsBC;IAED;;;;OAIG;IACH,wBAQC;IAED;;;OAGG;IACH,0BAFW,MAAM,QAMhB;IAGD;;;OAGG;IACH,YAFY,MAAM,CAqBjB;IAED;;;;OAIG;IACH,2BAHW,MAAM,GACL,MAAM,CAcjB;IAED;;;;OAIG;IACH,YAFW,MAAM,QAYhB;IAED;;OAEG;IACH,cAGC;CACJ"}
+{"version":3,"file":"BinaryElementPool.d.ts","sourceRoot":"","sources":["../../../../../../../../src/core/geom/3d/topology/struct/binary/BinaryElementPool.js"],"names":[],"mappings":"AAwBA;;GAEG;AACH;IAwBI;;;;OAIG;IACH,uBAHW,MAAM,qBACN,MAAM,EAiDhB;IA1ED;;;;OAIG;IACH,eAAY;IAEZ;;;;;OAKG;IACH,uBAAmB;IAEnB;;;;OAIG;IACH,eAAW;IAaP;;;;OAIG;IACH,oBAA4B;IAG5B;;;;OAIG;IACH,sBAA2E;IAC3E;;;;OAIG;IACH,qBAAsD;IACtD;;;;OAIG;IACH,sBAAwD;IACxD;;;;OAIG;IACH,uBAA0D;IAC1D,oBAAiD;IAEjD;;;;OAIG;IACH,mBAAkC;IAItC;;;;OAIG;IACH,wBAHW,WAAW,2BACX,MAAM,QAsBhB;IAED;;;OAGG;IACH,wBAEC;IAED;;;;OAIG;IACH,mBAEC;IAED;;;OAGG;IACH,uBAEC;IAED;;;OAGG;IACH,+BAEC;IAED;;;OAGG;IACH,iCAEC;IAED;;OAEG;IACH,aAEC;IAED;;;;OAIG;IACH,oBAHW,MAAM,GACL,MAAM,CAMjB;IAED;;;;;OAKG;IACH,iBAHW,MAAM,GACL,MAAM,CAIjB;IAED;;;;OAIG;IACH,iBAHW,MAAM,GACL,OAAO,CAsBlB;IAED;;;;OAIG;IACH,uBAsBC;IAED;;;;OAIG;IACH,wBAQC;IAED;;;OAGG;IACH,0BAFW,MAAM,QAMhB;IAGD;;;OAGG;IACH,YAFY,MAAM,CAqBjB;IAED;;;;OAIG;IACH,2BAHW,MAAM,GACL,MAAM,CAcjB;IAED;;;;OAIG;IACH,YAFW,MAAM,QAYhB;IAED;;OAEG;IACH,cAGC;CACJ"}

package/src/core/geom/3d/topology/struct/binary/BinaryElementPool.js

@@ -27,6 +27,28 @@ const CAPACITY_GROW_MIN_STEP = 32;
  */
 export class BinaryElementPool {
 
+    /**
+     * Unused slots
+     * @type {number[]}
+     * @private
+     */
+    __free = [];
+
+    /**
+     * Tracks last unallocated item in the list,
+     * this separate cursor is necessary to prevent re-allocation of the 'free' array
+     * @type {number}
+     * @private
+     */
+    __free_pointer = 0;
+
+    /**
+     *
+     * @type {number}
+     * @private
+     */
+    __size = 0;
+
     /**
      *
      * @param {number} item_size in bytes
@@ -36,6 +58,8 @@ export class BinaryElementPool {
         assert.isNonNegativeInteger(item_size, 'item_size');
         assert.greaterThan(item_size, 0, 'item_size must be greater than 0');
 
+        assert.isNonNegativeInteger(initial_capacity, 'initial_capacity');
+
         /**
          * Size of a single pool item in bytes
          * @type {number}
@@ -43,35 +67,75 @@ export class BinaryElementPool {
          */
         this.__item_size = item_size;
 
+
         /**
-         * Unused slots
-         * @type {number[]}
+         *
+         * @type {ArrayBuffer}
          * @private
          */
-        this.__free = [];
-
+        this.__data_buffer = new ArrayBuffer(align_4(initial_capacity * item_size));
         /**
-         * Tracks last unallocated item in the list,
-         * this separate cursor is necessary to prevent re-allocation of the 'free' array
-         * @type {number}
+         *
+         * @type {Uint8Array}
          * @private
          */
-        this.__free_pointer = 0;
-
-        this.__data_buffer = new ArrayBuffer(align_4(initial_capacity * item_size));
         this.__data_uint8 = new Uint8Array(this.__data_buffer);
+        /**
+         *
+         * @type {Uint32Array}
+         * @private
+         */
         this.__data_uint32 = new Uint32Array(this.__data_buffer);
+        /**
+         *
+         * @type {Float32Array}
+         * @private
+         */
         this.__data_float32 = new Float32Array(this.__data_buffer);
         this.data_view = new DataView(this.__data_buffer);
 
-        this.__capacity = initial_capacity;
-
         /**
          *
          * @type {number}
          * @private
          */
-        this.__size = 0;
+        this.__capacity = initial_capacity;
+
+    }
+
+    /**
+     *
+     * @param {ArrayBuffer} buffer
+     * @param {number} allocated_record_count
+     */
+    fromArrayBuffer(buffer, allocated_record_count = 0) {
+        assert.defined(buffer, 'buffer');
+        assert.notNull(buffer, 'buffer');
+
+        const capacity = Math.floor(buffer.byteLength / this.__item_size);
+
+        assert.isNonNegativeInteger(allocated_record_count, 'allocated_record_count');
+        assert.lessThanOrEqual(allocated_record_count, capacity, 'allocated_record_count is higher than capacity');
+
+        this.__data_buffer = buffer;
+        this.__data_uint8 = new Uint8Array(buffer);
+        this.__data_uint32 = new Uint32Array(buffer);
+        this.__data_float32 = new Float32Array(buffer);
+        this.data_view = new DataView(buffer);
+
+        this.__capacity = capacity;
+
+        // drop free slots
+        this.__free_pointer = 0;
+        this.__size = allocated_record_count;
+    }
+
+    /**
+     * Size of a single record in bytes
+     * @return {number}
+     */
+    get item_size() {
+        return this.__item_size;
     }
 
     /**