@woosh/meep-engine 3.33.0 → 3.34.0

package/src/engine/graphics/particles/particular/engine/emitter/ParticlePool.d.ts

@@ -1,162 +0,0 @@
-export class ParticlePool {
-    /**
-     *
-     * @param {AttributeGroupSpec} spec
-     * @constructor
-     */
-    constructor(spec: AttributeGroupSpec);
-    /**
-     *
-     * @type {BitSet}
-     */
-    occupancy: BitSet;
-    /**
-     * One per attribute of {@link spec}, in the same order, each holding {@link capacity} items.
-     *
-     * @type {AttributeData[]}
-     */
-    attributes: AttributeData[];
-    /**
-     *
-     * @type {number}
-     */
-    growFactor: number;
-    /**
-     *
-     * @type {number}
-     */
-    shrinkFactor: number;
-    /**
-     *
-     * @type {number}
-     */
-    capacity: number;
-    /**
-     *
-     * @type {AttributeGroupSpec}
-     */
-    spec: AttributeGroupSpec;
-    size(): number;
-    /**
-     *
-     * @returns {number}
-     */
-    create(): number;
-    /**
-     * Returns true if particle has discontinuous unused slots (holes)
-     * @returns {boolean}
-     */
-    hasHoles(): boolean;
-    /**
-     *
-     * @param {number} index
-     */
-    remove(index: number): void;
-    /**
-     * Remove holes from the occupancy set
-     */
-    compact(): void;
-    update(): void;
-    /**
-     * Swap two particles identified by index
-     * NOTE: Only attributes are swapped, occupancy is unaffected.
-     * @param {number} indexA
-     * @param {number} indexB
-     */
-    swap(indexA: number, indexB: number): void;
-    build(): void;
-    /**
-     *
-     * @param {number} capacity
-     */
-    growCapacity(capacity: number): void;
-    /**
-     *
-     * @param {number} newCapacity
-     */
-    shrinkCapacity(newCapacity: number): void;
-    /**
-     *
-     * @param {number} newCapacity
-     */
-    setCapacity(newCapacity: number): void;
-    /**
-     *
-     * @param {number} particleIndex
-     * @param {number} attributeIndex
-     * @returns {number}
-     */
-    readAttributeScalar(particleIndex: number, attributeIndex: number): number;
-    /**
-     *
-     * @param {number} particleIndex
-     * @param {number} attributeIndex
-     * @param {number} value
-     */
-    writeAttributeScalar(particleIndex: number, attributeIndex: number, value: number): void;
-    /**
-     *
-     * @param {number} particleIndex
-     * @param {number} attributeIndex
-     * @param {number[]} result
-     */
-    readAttributeVector2(particleIndex: number, attributeIndex: number, result: number[]): void;
-    /**
-     *
-     * @param {number} particleIndex
-     * @param {number} attributeIndex
-     * @param {number} x
-     * @param {number} y
-     */
-    writeAttributeVector2(particleIndex: number, attributeIndex: number, x: number, y: number): void;
-    /**
-     *
-     * @param {number} particleIndex
-     * @param {number} attributeIndex
-     * @param {number[]} result
-     */
-    readAttributeVector3(particleIndex: number, attributeIndex: number, result: number[]): void;
-    /**
-     *
-     * @param {number} particleIndex
-     * @param {number} attributeIndex
-     * @param {number} x
-     * @param {number} y
-     * @param {number} z
-     */
-    writeAttributeVector3(particleIndex: number, attributeIndex: number, x: number, y: number, z: number): void;
-    /**
-     *
-     * @param {number} particleIndex
-     * @param {number} attributeIndex
-     * @param {number[]} result
-     */
-    readAttributeVector4(particleIndex: number, attributeIndex: number, result: number[]): void;
-    /**
-     *
-     * @param {number} particleIndex
-     * @param {number} attributeIndex
-     * @param {number} x
-     * @param {number} y
-     * @param {number} z
-     * @param {number} w
-     */
-    writeAttributeVector4(particleIndex: number, attributeIndex: number, x: number, y: number, z: number, w: number): void;
-    /**
-     * Write the same attribute value for every particle.
-     * Assumes particles are packed (no holes).
-     * @param {number} attribute_index
-     * @param {number[]|Float32Array|Uint8Array|Uint16Array|Int8Array|Int32Array} value
-     */
-    writeAttributeForAllArray(attribute_index: number, value: number[] | Float32Array | Uint8Array | Uint16Array | Int8Array | Int32Array): void;
-    /**
-     *
-     * @param {number} attribute_index
-     * @param {number[]} result
-     */
-    computeAttributeVector3AxisAlignedBoundingBox(attribute_index: number, result: number[]): void;
-    dispose(): void;
-}
-import { BitSet } from "../../../../../../core/binary/BitSet.js";
-import { AttributeData } from "../../../../geometry/AttributeData.js";
-//# sourceMappingURL=ParticlePool.d.ts.map

package/src/engine/graphics/particles/particular/engine/emitter/ParticlePool.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"ParticlePool.d.ts","sourceRoot":"","sources":["../../../../../../../../src/engine/graphics/particles/particular/engine/emitter/ParticlePool.js"],"names":[],"mappings":"AAUA;IAgCI;;;;OAIG;IACH,sCAWC;IA/CD;;;OAGG;IACH,WAFU,MAAM,CAES;IAEzB;;;;OAIG;IACH,YAFU,aAAa,EAAE,CAET;IAEhB;;;OAGG;IACH,YAFU,MAAM,CAEC;IAEjB;;;OAGG;IACH,cAFU,MAAM,CAEG;IAEnB;;;OAGG;IACH,UAFU,MAAM,CAEF;IAUV;;;OAGG;IACH,yBAAgB;IAMpB,eAEC;IAED;;;OAGG;IACH,UAFa,MAAM,CAiBlB;IAED;;;OAGG;IACH,YAFa,OAAO,CAMnB;IAED;;;OAGG;IACH,cAFW,MAAM,QAIhB;IAED;;OAEG;IACH,gBA2CC;IAED,eAOC;IAED;;;;;OAKG;IACH,aAHW,MAAM,UACN,MAAM,QAgChB;IAED,cAsBC;IAED;;;OAGG;IACH,uBAFW,MAAM,QAYhB;IAED;;;OAGG;IACH,4BAFW,MAAM,QAWhB;IAED;;;OAGG;IACH,yBAFW,MAAM,QAiBhB;IAED;;;;;OAKG;IACH,mCAJW,MAAM,kBACN,MAAM,GACJ,MAAM,CAQlB;IAED;;;;;OAKG;IACH,oCAJW,MAAM,kBACN,MAAM,SACN,MAAM,QAQhB;IAED;;;;;OAKG;IACH,oCAJW,MAAM,kBACN,MAAM,UACN,MAAM,EAAE,QAWlB;IAED;;;;;;OAMG;IACH,qCALW,MAAM,kBACN,MAAM,KACN,MAAM,KACN,MAAM,QAWhB;IAED;;;;;OAKG;IACH,oCAJW,MAAM,kBACN,MAAM,UACN,MAAM,EAAE,QAYlB;IAED;;;;;;;OAOG;IACH,qCANW,MAAM,kBACN,MAAM,KACN,MAAM,KACN,MAAM,KACN,MAAM,QAYhB;IAED;;;;;OAKG;IACH,oCAJW,MAAM,kBACN,MAAM,UACN,MAAM,EAAE,QAalB;IAED;;;;;;;;OAQG;IACH,qCAPW,MAAM,kBACN,MAAM,KACN,MAAM,KACN,MAAM,KACN,MAAM,KACN,MAAM,QAahB;IAED;;;;;OAKG;IACH,2CAHW,MAAM,SACN,MAAM,EAAE,GAAC,YAAY,GAAC,UAAU,GAAC,WAAW,GAAC,SAAS,GAAC,UAAU,QAwB3E;IAED;;;;OAIG;IACH,+DAHW,MAAM,UACN,MAAM,EAAE,QAgBlB;IAED,gBAGC;CACJ;uBAtdsB,yCAAyC;8BAIlC,uCAAuC"}

package/src/engine/graphics/particles/particular/engine/emitter/ParticlePool.js

@@ -1,472 +0,0 @@
-import { assert } from "../../../../../../core/assert.js";
-import { BitSet } from "../../../../../../core/binary/BitSet.js";
-import { typed_array_copy } from "../../../../../../core/collection/array/typed/typed_array_copy.js";
-import { aabb3_from_v3_array } from "../../../../../../core/geom/3d/aabb/aabb3_from_v3_array.js";
-import { max3 } from "../../../../../../core/math/max3.js";
-import { AttributeData } from "../../../../geometry/AttributeData.js";
-
-const SHRINK_THRESHOLD = 64;
-const GROW_MIN_STEP = 32;
-
-export class ParticlePool {
-    /**
-     *
-     * @type {BitSet}
-     */
-    occupancy = new BitSet();
-
-    /**
-     * One per attribute of {@link spec}, in the same order, each holding {@link capacity} items.
-     *
-     * @type {AttributeData[]}
-     */
-    attributes = [];
-
-    /**
-     *
-     * @type {number}
-     */
-    growFactor = 1.3;
-
-    /**
-     *
-     * @type {number}
-     */
-    shrinkFactor = 0.5;
-
-    /**
-     *
-     * @type {number}
-     */
-    capacity = 16;
-
-    /**
-     *
-     * @param {AttributeGroupSpec} spec
-     * @constructor
-     */
-    constructor(spec) {
-        assert.equal(spec.isAttributeGroupSpec, true, 'spec.VertexDataSpec !== true');
-
-        /**
-         *
-         * @type {AttributeGroupSpec}
-         */
-        this.spec = spec;
-
-
-        this.build();
-    }
-
-    size() {
-        return this.occupancy.size();
-    }
-
-    /**
-     *
-     * @returns {number}
-     */
-    create() {
-        //find an empty place in the pool
-        const index = this.occupancy.nextClearBit(0);
-
-        //reserve place
-        this.occupancy.set(index, true);
-
-        //ensure attribute arrays are large enough
-        const min_capacity = index + 1;
-
-        if (this.capacity < min_capacity) {
-            this.growCapacity(min_capacity);
-        }
-
-        return index;
-    }
-
-    /**
-     * Returns true if particle has discontinuous unused slots (holes)
-     * @returns {boolean}
-     */
-    hasHoles() {
-        const occupancy = this.occupancy;
-
-        return occupancy.nextClearBit(0) < occupancy.size();
-    }
-
-    /**
-     *
-     * @param {number} index
-     */
-    remove(index) {
-        this.occupancy.set(index, false);
-    }
-
-    /**
-     * Remove holes from the occupancy set
-     */
-    compact() {
-        const occupancy = this.occupancy;
-
-        const specAttributes = this.spec.attributes;
-        const numAttributes = specAttributes.length;
-
-        let holeIndex, lastIndex, attributeIndex;
-
-        holeIndex = occupancy.nextClearBit(0);
-        lastIndex = occupancy.previousSetBit(occupancy.size());
-
-        const attributes = this.attributes;
-
-        while (holeIndex < lastIndex) {
-
-            //move occupancy flag from the last to the hole
-            occupancy.set(holeIndex, true);
-            occupancy.set(lastIndex, false);
-
-            //move attribute values
-            for (attributeIndex = 0; attributeIndex < numAttributes; attributeIndex++) {
-                const attribute = attributes[attributeIndex];
-
-                const itemSize = attribute.itemSize;
-
-                /**
-                 *
-                 * @type {Float32Array}
-                 */
-                const attribute_array = attribute.array;
-
-                //do swaps in the old array
-                const targetIndex = holeIndex * itemSize;
-                const sourceIndex = lastIndex * itemSize;
-
-                attribute_array.copyWithin(targetIndex, sourceIndex, sourceIndex + itemSize);
-            }
-
-            //move hole and last cursors
-            holeIndex = occupancy.nextClearBit(holeIndex + 1);
-            lastIndex = occupancy.previousSetBit(lastIndex);
-        }
-
-    }
-
-    update() {
-        //some of the particles may have died and formed holes in the data array, compaction removes them
-        this.compact();
-
-        //attempt attribute size shrinkage
-        const size = this.occupancy.size();
-        this.shrinkCapacity(size);
-    }
-
-    /**
-     * Swap two particles identified by index
-     * NOTE: Only attributes are swapped, occupancy is unaffected.
-     * @param {number} indexA
-     * @param {number} indexB
-     */
-    swap(indexA, indexB) {
-        //assert.ok(this.occupancy.get(indexA), `indexA=${indexA} is unoccupied`);
-        //assert.ok(this.occupancy.get(indexB), `indexB=${indexB} is unoccupied`);
-
-        const attributes = this.attributes;
-        const numAttributes = attributes.length;
-
-        let i, j;
-
-        for (i = 0; i < numAttributes; i++) {
-            const attribute = attributes[i];
-
-            const itemSize = attribute.itemSize;
-
-            const offsetA = indexA * itemSize;
-            const offsetB = indexB * itemSize;
-
-            const array = attribute.array;
-
-            for (j = 0; j < itemSize; j++) {
-                const addressA = offsetA + j;
-                const addressB = offsetB + j;
-
-                const temp = array[addressA];
-
-                array[addressA] = array[addressB];
-
-                array[addressB] = temp;
-            }
-        }
-    }
-
-    build() {
-        const spec_attributes = this.spec.attributes;
-        const l = spec_attributes.length;
-
-        for (let i = 0; i < l; i++) {
-
-            /**
-             * @type {AttributeSpec}
-             */
-            const attributeSpec = spec_attributes[i];
-
-            const newAttribute = AttributeData.allocate(attributeSpec, this.capacity);
-
-            const old_attribute = this.attributes[i];
-
-            if (old_attribute !== undefined && old_attribute.count !== 0) {
-                //copy old data
-                typed_array_copy(old_attribute.array, newAttribute.array);
-            }
-
-            this.attributes[i] = newAttribute;
-        }
-    }
-
-    /**
-     *
-     * @param {number} capacity
-     */
-    growCapacity(capacity) {
-        const newCapacity = Math.floor(
-            max3(
-                capacity,
-                this.capacity * this.growFactor,
-                this.capacity + GROW_MIN_STEP
-            )
-        );
-
-        this.setCapacity(newCapacity);
-    }
-
-    /**
-     *
-     * @param {number} newCapacity
-     */
-    shrinkCapacity(newCapacity) {
-        if (
-            newCapacity < this.capacity * this.shrinkFactor
-            && newCapacity < this.capacity - SHRINK_THRESHOLD
-        ) {
-
-            this.setCapacity(newCapacity);
-
-        }
-    }
-
-    /**
-     *
-     * @param {number} newCapacity
-     */
-    setCapacity(newCapacity) {
-        if (this.capacity === newCapacity) {
-            //do nothing
-            return;
-        }
-
-        const occupancy_size = this.occupancy.size();
-
-        if (newCapacity < occupancy_size) {
-            throw new Error(`Can not set capacity (=${newCapacity}) below occupancy set size (=${occupancy_size})`);
-        }
-
-        this.capacity = newCapacity;
-
-        this.build();
-    }
-
-    /**
-     *
-     * @param {number} particleIndex
-     * @param {number} attributeIndex
-     * @returns {number}
-     */
-    readAttributeScalar(particleIndex, attributeIndex) {
-        const attribute = this.attributes[attributeIndex];
-
-        const array = attribute.array;
-
-        return array[particleIndex];
-    }
-
-    /**
-     *
-     * @param {number} particleIndex
-     * @param {number} attributeIndex
-     * @param {number} value
-     */
-    writeAttributeScalar(particleIndex, attributeIndex, value) {
-        const attribute = this.attributes[attributeIndex];
-
-        const array = attribute.array;
-
-        array[particleIndex] = value;
-    }
-
-    /**
-     *
-     * @param {number} particleIndex
-     * @param {number} attributeIndex
-     * @param {number[]} result
-     */
-    readAttributeVector2(particleIndex, attributeIndex, result) {
-        const attribute = this.attributes[attributeIndex];
-
-        const address = particleIndex * 2;
-
-        const array = attribute.array;
-
-        result[0] = array[address];
-        result[1] = array[address + 1];
-    }
-
-    /**
-     *
-     * @param {number} particleIndex
-     * @param {number} attributeIndex
-     * @param {number} x
-     * @param {number} y
-     */
-    writeAttributeVector2(particleIndex, attributeIndex, x, y) {
-        const attribute = this.attributes[attributeIndex];
-
-        const address = particleIndex * 2;
-
-        const array = attribute.array;
-
-        array[address] = x;
-        array[address + 1] = y;
-    }
-
-    /**
-     *
-     * @param {number} particleIndex
-     * @param {number} attributeIndex
-     * @param {number[]} result
-     */
-    readAttributeVector3(particleIndex, attributeIndex, result) {
-        const attribute = this.attributes[attributeIndex];
-
-        const address = particleIndex * 3;
-
-        const array = attribute.array;
-
-        result[0] = array[address];
-        result[1] = array[address + 1];
-        result[2] = array[address + 2];
-    }
-
-    /**
-     *
-     * @param {number} particleIndex
-     * @param {number} attributeIndex
-     * @param {number} x
-     * @param {number} y
-     * @param {number} z
-     */
-    writeAttributeVector3(particleIndex, attributeIndex, x, y, z) {
-        const attribute = this.attributes[attributeIndex];
-
-        const address = particleIndex * 3;
-
-        const array = attribute.array;
-
-        array[address] = x;
-        array[address + 1] = y;
-        array[address + 2] = z;
-    }
-
-    /**
-     *
-     * @param {number} particleIndex
-     * @param {number} attributeIndex
-     * @param {number[]} result
-     */
-    readAttributeVector4(particleIndex, attributeIndex, result) {
-        const attribute = this.attributes[attributeIndex];
-
-        const address = particleIndex * 4;
-
-        const array = attribute.array;
-
-        result[0] = array[address];
-        result[1] = array[address + 1];
-        result[2] = array[address + 2];
-        result[3] = array[address + 3];
-    }
-
-    /**
-     *
-     * @param {number} particleIndex
-     * @param {number} attributeIndex
-     * @param {number} x
-     * @param {number} y
-     * @param {number} z
-     * @param {number} w
-     */
-    writeAttributeVector4(particleIndex, attributeIndex, x, y, z, w) {
-        const attribute = this.attributes[attributeIndex];
-
-        const address = particleIndex * 4;
-
-        const array = attribute.array;
-
-        array[address] = x;
-        array[address + 1] = y;
-        array[address + 2] = z;
-        array[address + 3] = w;
-    }
-
-    /**
-     * Write the same attribute value for every particle.
-     * Assumes particles are packed (no holes).
-     * @param {number} attribute_index
-     * @param {number[]|Float32Array|Uint8Array|Uint16Array|Int8Array|Int32Array} value
-     */
-    writeAttributeForAllArray(attribute_index, value) {
-        const attribute = this.attributes[attribute_index];
-
-        const itemSize = attribute.itemSize;
-
-        if (value.length < itemSize) {
-            throw new Error(`Argument underflow, attribute.itemSize is '${itemSize}', but supplier argument's length is '${value.length}'`);
-        }
-
-        const n = this.size();
-
-        const destination = attribute.array;
-
-        let k;
-        for (let i = 0; i < n; i++) {
-            const offset = i * itemSize;
-
-            for (k = 0; k < itemSize; k++) {
-                destination[offset + k] = value[k];
-            }
-        }
-
-    }
-
-    /**
-     *
-     * @param {number} attribute_index
-     * @param {number[]} result
-     */
-    computeAttributeVector3AxisAlignedBoundingBox(attribute_index, result) {
-        const attribute = this.attributes[attribute_index];
-        const item_size = attribute.itemSize;
-
-        if (item_size !== 3) {
-            throw new Error(`Attribute item_size is expected to be 3, instead was '${item_size}'`);
-        }
-
-        const particle_count = this.size();
-
-        const data = attribute.array;
-
-        aabb3_from_v3_array(result, data, particle_count * 3);
-
-    }
-
-    dispose() {
-        // the pool owns nothing but its own arrays, and those go with it
-        this.attributes.length = 0;
-    }
-}

package/src/engine/graphics/particles/particular/engine/emitter/computeEmissionFunction.d.ts

@@ -1,10 +0,0 @@
-/**
- *
- * @param {EmissionFromType} emissionType
- * @param {EmissionShapeType} emissionShape
- * @returns {(random: function, result: (number[]|Float32Array|Float64Array), result_offset: number) => void}
- */
-export function computeEmissionFunction(emissionType: EmissionFromType, emissionShape: EmissionShapeType): (random: Function, result: (number[] | Float32Array | Float64Array), result_offset: number) => void;
-import { EmissionFromType } from "./EmissionFromType.js";
-import { EmissionShapeType } from "./EmissionShapeType.js";
-//# sourceMappingURL=computeEmissionFunction.d.ts.map

package/src/engine/graphics/particles/particular/engine/emitter/computeEmissionFunction.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"computeEmissionFunction.d.ts","sourceRoot":"","sources":["../../../../../../../../src/engine/graphics/particles/particular/engine/emitter/computeEmissionFunction.js"],"names":[],"mappings":"AAQA;;;;;GAKG;AACH,sDAJW,gBAAgB,iBAChB,iBAAiB,GACf,CAAC,MAAM,UAAU,EAAE,MAAM,EAAE,CAAC,MAAM,EAAE,GAAC,YAAY,GAAC,YAAY,CAAC,EAAE,aAAa,EAAE,MAAM,KAAK,IAAI,CAwB3G;iCAlCgC,uBAAuB;kCAFtB,wBAAwB"}

package/src/engine/graphics/particles/particular/engine/emitter/computeEmissionFunction.js

@@ -1,37 +0,0 @@
-import { EmissionShapeType } from "./EmissionShapeType.js";
-import { random_point_in_point } from "../../../../../../core/geom/random/random_point_in_point.js";
-import { EmissionFromType } from "./EmissionFromType.js";
-import { random_point_in_sphere } from "../../../../../../core/geom/random/random_point_in_sphere.js";
-import { random_point_on_sphere } from "../../../../../../core/geom/random/random_point_on_sphere.js";
-import { random_point_in_box } from "../../../../../../core/geom/random/random_point_in_box.js";
-import { random_point_on_box } from "../../../../../../core/geom/random/random_point_on_box.js";
-
-/**
- *
- * @param {EmissionFromType} emissionType
- * @param {EmissionShapeType} emissionShape
- * @returns {(random: function, result: (number[]|Float32Array|Float64Array), result_offset: number) => void}
- */
-export function computeEmissionFunction(emissionType, emissionShape) {
-    if (emissionShape === EmissionShapeType.Point) {
-        return random_point_in_point;
-    } else if (emissionShape === EmissionShapeType.Sphere) {
-        if (emissionType === EmissionFromType.Volume) {
-            return random_point_in_sphere;
-        } else if (emissionType === EmissionFromType.Shell) {
-            return random_point_on_sphere;
-        } else {
-            throw new TypeError('Unsupported EmissionFrom Type');
-        }
-    } else if (emissionShape === EmissionShapeType.Box) {
-        if (emissionType === EmissionFromType.Volume) {
-            return random_point_in_box;
-        } else if (emissionType === EmissionFromType.Shell) {
-            return random_point_on_box;
-        } else {
-            throw new TypeError('Unsupported EmissionFrom Type');
-        }
-    } else {
-        throw new TypeError('Unsupported emission shape');
-    }
-}

package/src/engine/graphics/particles/particular/engine/emitter/distance_to_camera.d.ts

@@ -1,9 +0,0 @@
-/**
- *
- * @param {number} index
- * @param {number[]|Float32Array} positionArray
- * @param {Vector3} planeNormal
- * @return {number}
- */
-export function distance_to_camera(index: number, positionArray: number[] | Float32Array, planeNormal: Vector3): number;
-//# sourceMappingURL=distance_to_camera.d.ts.map

package/src/engine/graphics/particles/particular/engine/emitter/distance_to_camera.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"distance_to_camera.d.ts","sourceRoot":"","sources":["../../../../../../../../src/engine/graphics/particles/particular/engine/emitter/distance_to_camera.js"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,0CALW,MAAM,iBACN,MAAM,EAAE,GAAC,YAAY,yBAEpB,MAAM,CAmBjB"}