@woosh/meep-engine 2.156.0 → 2.157.0

package/src/engine/graphics/particles/particular/engine/parameter/ParameterLookupTable.js

@@ -1,427 +1,2 @@
-import { assert } from "../../../../../../core/assert.js";
-import { combine_hash } from "../../../../../../core/collection/array/combine_hash.js";
-import { isArrayEqualStrict } from "../../../../../../core/collection/array/isArrayEqualStrict.js";
-import { computeHashFloatArray } from "../../../../../../core/math/hash/computeHashFloatArray.js";
-import { inverseLerp } from "../../../../../../core/math/inverseLerp.js";
-import { max2 } from "../../../../../../core/math/max2.js";
-import { min2 } from "../../../../../../core/math/min2.js";
-import { computeHashFloat } from "../../../../../../core/primitives/numbers/computeHashFloat.js";
-import { ParameterLookupTableSerializationAdapter } from "../emitter/serde/ParameterLookupTableSerializationAdapter.js";
-import { ParameterLookupTableFlags } from "./ParameterLookupTableFlags.js";
-
-
-export class ParameterLookupTable {
-
-    /**
-     *
-     * @type {number[]|Float32Array}
-     */
-    data = [];
-
-    /**
-     *
-     * @type {number[]|Float32Array}
-     */
-    positions = [];
-
-    /**
-     * Transient value
-     * @type {number}
-     */
-    valueMin = 0;
-
-    /**
-     * Transient value
-     * @type {number}
-     */
-    valueMax = 0;
-
-    /**
-     * @private
-     * @type {number}
-     */
-    flags = ParameterLookupTableFlags.WriteMode;
-
-    /**
-     *
-     * @param {number} [itemSize]
-     * @constructor
-     */
-    constructor(itemSize = 1) {
-        assert.isNonNegativeInteger(itemSize, 'itemSize');
-
-        /**
-         *
-         * @type {number}
-         */
-        this.itemSize = itemSize;
-
-    }
-
-    /**
-     *
-     * @param {ParameterLookupTableFlags} f
-     */
-    setFlag(f) {
-        this.flags |= f;
-    }
-
-    /**
-     *
-     * @param {ParameterLookupTableFlags|number} f
-     */
-    clearFlag(f) {
-        this.flags &= ~f;
-    }
-
-    /**
-     *
-     * @param {ParameterLookupTableFlags} f
-     * @returns {boolean}
-     */
-    getFlag(f) {
-        return (this.flags & f) !== 0;
-    }
-
-    disableWriteMode() {
-        this.clearFlag(ParameterLookupTableFlags.WriteMode);
-    }
-
-    fromJSON(json) {
-        this.itemSize = json.itemSize;
-        this.write(json.data, json.positions);
-    }
-
-    toJSON() {
-        return {
-            itemSize: this.itemSize,
-            data: Array.from(this.data),
-            positions: Array.from(this.positions)
-        };
-    }
-
-    /**
-     *
-     * @deprecated Use serialization adapter instead
-     * @param {BinaryBuffer} buffer
-     */
-    toBinaryBuffer(buffer) {
-        const adapter = new ParameterLookupTableSerializationAdapter();
-
-        adapter.serialize(buffer, this);
-    }
-
-    /**
-     * @deprecated Use serialization adapter instead
-     * @param {BinaryBuffer} buffer
-     */
-    fromBinaryBuffer(buffer) {
-        const adapter = new ParameterLookupTableSerializationAdapter();
-
-        adapter.deserialize(buffer, this);
-    }
-
-    /**
-     *
-     * @param {number} position
-     * @param {number[]|Float32Array|Float64Array} result
-     */
-    sample(position, result) {
-        assert.isNumber(position, 'position');
-        assert.notNaN(position, 'position');
-        // assert.greaterThanOrEqual(position, 0, 'position');
-        // assert.ok(position >= 0 && position <= 1, `position must be between 0 and 1, instead was ${position}`);
-
-        const itemSize = this.itemSize;
-        const data = this.data;
-        const numValues = data.length / itemSize;
-
-        let i;
-
-        const positions = this.positions;
-
-        let lowIndex = numValues - 1;
-        let highIndex = lowIndex;
-        let fraction = 0;
-
-        if (position <= positions[0]) {
-
-            // special case, seek position is at or before the start of the table
-            lowIndex = 0;
-            highIndex = 0;
-
-        } else {
-
-            //find position index
-            for (i = 1; i < numValues; i++) {
-                //NOTE: no complex search is used, since for small data sizes linear scan is typically faster
-                const p = positions[i];
-
-                if (p >= position) {
-                    // next position if over the seek position
-                    highIndex = i;
-                    lowIndex = i - 1;
-
-                    fraction = inverseLerp(positions[lowIndex], p, position);
-
-                    break;
-                }
-            }
-        }
-
-
-        const low_offset = lowIndex * itemSize;
-        const high_offset = highIndex * itemSize;
-
-        for (i = 0; i < itemSize; i++) {
-            const lowValue = data[low_offset + i];
-            const highValue = data[high_offset + i];
-
-            // inlined for speed: lerp(low, high, fraction)
-            const value = lowValue * (1 - fraction) + highValue * fraction;
-
-            result[i] = value;
-        }
-    }
-
-    computeUniformPositions() {
-        const numValues = this.data.length / this.itemSize;
-
-        const positions = [];
-
-        this.positions = positions;
-
-        for (let i = 0; i < numValues; i++) {
-            positions[i] = i / (numValues - 1);
-        }
-    }
-
-    /**
-     *
-     * @param {number[]|Float64Array|Float32Array|Uint8Array} values
-     * @param {number[]|Float64Array|Float32Array} [positions]
-     */
-    write(values, positions) {
-        if (!this.getFlag(ParameterLookupTableFlags.WriteMode)) {
-            throw new Error(`Cannot write, WriteMode disabled`);
-        }
-
-        assert.isArrayLike(values, 'values');
-
-        const numValues = values.length;
-
-        assert.equal(numValues % this.itemSize, 0, `number of elements in the array[=${numValues}] is not multiple of itemSize(=${this.itemSize})`);
-
-        this.data = values;
-
-        if (positions === undefined) {
-
-            //console.warn('positions are undefined, assuming uniform distribution');
-            this.computeUniformPositions();
-
-        } else {
-
-            assert.equal(numValues / this.itemSize, positions.length, `number of positions[=${positions.length}] is not equal to number of values[=${numValues / this.itemSize}]`);
-
-            this.positions = positions;
-        }
-
-        this.computeStatistics();
-    }
-
-    /**
-     *
-     * @param {number} position
-     * @param {number[]} value
-     */
-    addValue(position, value) {
-        if (!this.getFlag(ParameterLookupTableFlags.WriteMode)) {
-            throw new Error(`Cannot add value, WriteMode disabled`);
-        }
-
-        //insert operation cannot be done on a TypedArray, so we need to make sure we are working with dynamic array
-        if (!Array.isArray(this.positions)) {
-            this.positions = Array.from(this.positions);
-        }
-
-        if (!Array.isArray(this.data)) {
-            this.data = Array.from(this.data);
-        }
-
-        //find a place to insert the value at
-        const positions = this.positions;
-        const numValues = positions.length;
-
-        let i;
-
-        for (i = 0; i < numValues; i++) {
-            const p = positions[i];
-            if (p > position) {
-                break;
-            }
-        }
-
-
-        //insert value
-        positions.splice(i, 0, position);
-
-        const spliceArgs = value.slice();
-        spliceArgs.unshift(i * this.itemSize, 0);
-
-        Array.prototype.splice.apply(this.data, spliceArgs);
-    }
-
-    /**
-     * Populates statistics values
-     */
-    computeStatistics() {
-        //first find min and max values
-        let min = Number.POSITIVE_INFINITY, max = Number.NEGATIVE_INFINITY;
-
-
-        const numElements = this.data.length;
-
-        let i;
-
-        for (i = 0; i < numElements; i++) {
-            const inputElement = this.data[i];
-
-            min = min2(min, inputElement);
-            max = max2(max, inputElement);
-        }
-
-        this.valueMin = min;
-        this.valueMax = max;
-    }
-
-    hash() {
-        const valueMax = this.valueMax;
-        const valueMin = this.valueMin;
-        if (valueMin === valueMax) {
-            //special case, all values are the same
-            return computeHashFloat(valueMin);
-        } else {
-            const dataHash = computeHashFloatArray(this.data);
-            const positionHash = computeHashFloatArray(this.positions);
-
-            return combine_hash(
-                dataHash,
-                positionHash,
-                this.itemSize
-            );
-        }
-    }
-
-    /**
-     *
-     * @param {ParameterLookupTable} other
-     * @returns {boolean}
-     */
-    equals(other) {
-        if (this === other) {
-            // identity shortcut
-            return true;
-        }
-
-        if (this.itemSize !== other.itemSize) {
-            return false;
-        }
-
-        return isArrayEqualStrict(this.data, other.data)
-            && isArrayEqualStrict(this.positions, other.positions)
-            ;
-    }
-
-    validate() {
-        //check data size
-        const data = this.data;
-        const dataLength = data.length;
-
-        const positions = this.positions;
-        const positionLength = positions.length;
-
-        if ((dataLength / this.itemSize) !== positionLength) {
-            //number of samples between position and data doesn't match
-            return false;
-        }
-
-
-        //check position values
-        let prevPosition = Number.NEGATIVE_INFINITY;
-
-        for (let i = 0; i < positionLength; i++) {
-            const position = positions[i];
-
-            if (position < 0) {
-                //position value must be greater or equal to 0
-                return false;
-            }
-
-            if (position > 1) {
-                //position must be less than or equal to 1
-                return false;
-            }
-
-            if (position <= prevPosition) {
-                //position values must always increase
-                return false;
-            }
-
-            prevPosition = position;
-        }
-
-        //all is good
-        return true;
-    }
-
-    /**
-     *
-     * @param {number} itemSize
-     * @param {number[]} values
-     * @param {number[]} [positions]
-     */
-    static from(itemSize, values, positions) {
-        const r = new ParameterLookupTable(itemSize);
-
-        r.write(values, positions);
-
-        return r;
-    }
-
-    /**
-     *
-     * @param {Color} colors
-     * @returns {ParameterLookupTable}
-     */
-    static color_uint8_uniform(...colors) {
-        assert.defined(colors, 'colors');
-
-        const r = new ParameterLookupTable(4);
-
-        const length = colors.length;
-        const values = new Uint8Array(length * 4);
-
-        for (let i = 0; i < length; i++) {
-            const color = colors[i];
-
-            const i4 = i * 4;
-
-            values[i4] = Math.round(color.r * 255);
-            values[i4 + 1] = Math.round(color.g * 255);
-            values[i4 + 2] = Math.round(color.b * 255);
-            values[i4 + 3] = Math.round(color.a * 255);
-        }
-
-        r.write(values);
-
-        r.computeUniformPositions();
-
-        return r;
-    }
-}
-
-/**
- * @readonly
- * @type {boolean}
- */
-ParameterLookupTable.prototype.isParameterLookupTable = true;
+// Re-export for path compatibility; implementation lives in core/math/lookup/ParameterLookupTable.js
+export { ParameterLookupTable } from "../../../../../../core/math/lookup/ParameterLookupTable.js";

package/src/engine/graphics/particles/particular/engine/parameter/ParameterLookupTableFlags.d.ts

@@ -1,5 +1,2 @@
-export type ParameterLookupTableFlags = number;
-export namespace ParameterLookupTableFlags {
-    let WriteMode: number;
-}
+export { ParameterLookupTableFlags } from "../../../../../../core/math/lookup/ParameterLookupTableFlags.js";
 //# sourceMappingURL=ParameterLookupTableFlags.d.ts.map

package/src/engine/graphics/particles/particular/engine/parameter/ParameterLookupTableFlags.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ParameterLookupTableFlags.d.ts","sourceRoot":"","sources":["../../../../../../../../src/engine/graphics/particles/particular/engine/parameter/ParameterLookupTableFlags.js"],"names":[],"mappings":"wCACU,MAAM"}
+{"version":3,"file":"ParameterLookupTableFlags.d.ts","sourceRoot":"","sources":["../../../../../../../../src/engine/graphics/particles/particular/engine/parameter/ParameterLookupTableFlags.js"],"names":[],"mappings":""}

package/src/engine/graphics/particles/particular/engine/parameter/ParameterLookupTableFlags.js

@@ -1,6 +1,2 @@
-/**
- * @enum {number}
- */
-export const ParameterLookupTableFlags = {
-    WriteMode: 1
-};
+// Re-export for path compatibility; implementation lives in core/math/lookup/ParameterLookupTableFlags.js
+export { ParameterLookupTableFlags } from "../../../../../../core/math/lookup/ParameterLookupTableFlags.js";

package/src/engine/graphics/particles/particular/engine/utils/volume/prototypeParticleVolume.js

@@ -12,7 +12,7 @@ import { UnitSphereShape3D } from "../../../../../../../core/geom/3d/shape/UnitS
 import {
     shape_to_visual_entity,
     SHAPE_VISUAL_ENTITY_TAG
-} from "../../../../../../../core/geom/3d/shape/util/shape_to_visual_entity.js";
+} from "../../../../../debug/shape_to_visual_entity.js";
 import Vector1 from "../../../../../../../core/geom/Vector1.js";
 import Vector2 from "../../../../../../../core/geom/Vector2.js";
 import Vector3 from "../../../../../../../core/geom/Vector3.js";

package/src/engine/graphics/render/forward_plus/read_frustum_corner.d.ts

@@ -1,9 +1,2 @@
-/**
- *
- * @param {number[]|Float32Array|Float64Array} source
- * @param {number} source_index
- * @param {number[]|Float32Array|Float64Array} destination
- * @param {number} destination_offset
- */
-export function read_frustum_corner(source: number[] | Float32Array | Float64Array, source_index: number, destination: number[] | Float32Array | Float64Array, destination_offset: number): void;
+export { read_frustum_corner } from "../../../../core/geom/3d/frustum/read_frustum_corner.js";
 //# sourceMappingURL=read_frustum_corner.d.ts.map

package/src/engine/graphics/render/forward_plus/read_frustum_corner.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"read_frustum_corner.d.ts","sourceRoot":"","sources":["../../../../../../src/engine/graphics/render/forward_plus/read_frustum_corner.js"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,4CALW,MAAM,EAAE,GAAC,YAAY,GAAC,YAAY,gBAClC,MAAM,eACN,MAAM,EAAE,GAAC,YAAY,GAAC,YAAY,sBAClC,MAAM,QAQhB"}
+{"version":3,"file":"read_frustum_corner.d.ts","sourceRoot":"","sources":["../../../../../../src/engine/graphics/render/forward_plus/read_frustum_corner.js"],"names":[],"mappings":""}

package/src/engine/graphics/render/forward_plus/read_frustum_corner.js

@@ -1,14 +1,2 @@
-/**
- *
- * @param {number[]|Float32Array|Float64Array} source
- * @param {number} source_index
- * @param {number[]|Float32Array|Float64Array} destination
- * @param {number} destination_offset
- */
-export function read_frustum_corner(source, source_index, destination, destination_offset) {
-    const address = source_index * 3;
-
-    destination[destination_offset] = source[address];
-    destination[destination_offset + 1] = source[address + 1];
-    destination[destination_offset + 2] = source[address + 2];
-}
+// Re-export for path compatibility; implementation lives in core/geom/3d/frustum/read_frustum_corner.js
+export { read_frustum_corner } from "../../../../core/geom/3d/frustum/read_frustum_corner.js";

package/src/engine/graphics/sh3/path_tracer/geometry/compute_triangle_group_aabb3.d.ts

@@ -1,12 +1,2 @@
-/**
- * Compute AABB for a group of triangles based on index-buffer
- * @param {number[]|Float32Array} output
- * @param {number} output_offset
- * @param {number[]|ArrayLike<number>} indices
- * @param {number[]|ArrayLike<number>} positions
- * @param {number} index_offset
- * @param {number} index_count
- * @param {number} dimension_count
- */
-export function compute_triangle_group_aabb3(output: number[] | Float32Array, output_offset: number, indices: number[] | ArrayLike<number>, positions: number[] | ArrayLike<number>, index_offset: number, index_count: number, dimension_count: number): void;
+export { compute_triangle_group_aabb3 } from "../../../../../core/geom/3d/aabb/compute_triangle_group_aabb3.js";
 //# sourceMappingURL=compute_triangle_group_aabb3.d.ts.map

package/src/engine/graphics/sh3/path_tracer/geometry/compute_triangle_group_aabb3.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"compute_triangle_group_aabb3.d.ts","sourceRoot":"","sources":["../../../../../../../src/engine/graphics/sh3/path_tracer/geometry/compute_triangle_group_aabb3.js"],"names":[],"mappings":"AAGA;;;;;;;;;GASG;AACH,qDARW,MAAM,EAAE,GAAC,YAAY,iBACrB,MAAM,WACN,MAAM,EAAE,GAAC,UAAU,MAAM,CAAC,aAC1B,MAAM,EAAE,GAAC,UAAU,MAAM,CAAC,gBAC1B,MAAM,eACN,MAAM,mBACN,MAAM,QAkChB"}
+{"version":3,"file":"compute_triangle_group_aabb3.d.ts","sourceRoot":"","sources":["../../../../../../../src/engine/graphics/sh3/path_tracer/geometry/compute_triangle_group_aabb3.js"],"names":[],"mappings":""}

package/src/engine/graphics/sh3/path_tracer/geometry/compute_triangle_group_aabb3.js

@@ -1,46 +1,2 @@
-import { max2 } from "../../../../../core/math/max2.js";
-import { min2 } from "../../../../../core/math/min2.js";
-
-/**
- * Compute AABB for a group of triangles based on index-buffer
- * @param {number[]|Float32Array} output
- * @param {number} output_offset
- * @param {number[]|ArrayLike<number>} indices
- * @param {number[]|ArrayLike<number>} positions
- * @param {number} index_offset
- * @param {number} index_count
- * @param {number} dimension_count
- */
-export function compute_triangle_group_aabb3(
-    output,
-    output_offset,
-    indices,
-    positions,
-    index_offset,
-    index_count,
-    dimension_count
-) {
-
-    let i = 0;
-    for (; i < dimension_count; i++) {
-        // min bound
-        output[output_offset + i] = Infinity;
-        // max bound
-        output[output_offset + i + dimension_count] = -Infinity;
-    }
-
-    for (i = 0; i < index_count; i++) {
-        for (let j = 0; j < 3; j++) {
-            const index = indices[index_offset + i * 3 + j];
-
-            const i3 = index * dimension_count;
-
-            for (let k = 0; k < dimension_count; k++) {
-                const v = positions[i3 + k];
-
-                output[output_offset + k] = min2(output[output_offset + k], v);
-                output[output_offset + k + dimension_count] = max2(output[output_offset + k + dimension_count], v);
-            }
-        }
-    }
-}
+// Re-export for path compatibility; implementation lives in core/geom/3d/aabb/compute_triangle_group_aabb3.js
+export { compute_triangle_group_aabb3 } from "../../../../../core/geom/3d/aabb/compute_triangle_group_aabb3.js";

package/src/engine/graphics/sh3/prototypeSH3Probe.js

@@ -21,7 +21,7 @@ import { Color } from "../../../core/color/Color.js";
 import { kelvin_to_rgb } from "../../../core/color/kelvin/kelvin_to_rgb.js";
 import { AABB3 } from "../../../core/geom/3d/aabb/AABB3.js";
 import { compose_matrix4_array } from "../../../core/geom/3d/mat4/compose_matrix4_array.js";
-import { visualize_tetrahedral_mesh } from "../../../core/geom/3d/tetrahedra/visualize_tetrahedral_mesh.js";
+import { visualize_tetrahedral_mesh } from "../debug/visualize_tetrahedral_mesh.js";
 import Quaternion from "../../../core/geom/Quaternion.js";
 import { v3_length } from "../../../core/geom/vec3/v3_length.js";
 import Vector3 from "../../../core/geom/Vector3.js";

package/src/engine/graphics/texture/3d/scs3d_sample_linear3.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Trilinearly sample THREE single-channel 3D grids at the same fractional
+ * position, sharing one set of corner indices and interpolation weights.
+ *
+ * Identical result to calling {@link scs3d_sample_linear} once per channel —
+ * but the index/weight computation (the majority of the scalar sampler's work)
+ * is done once instead of three times. The fluid advection kernels sample
+ * velocity_x/y/z at a common back-traced point per cell, which makes this the
+ * hot sampling path.
+ *
+ * Positions outside the grid are clamped to the edge, channel-independently
+ * identical to the scalar sampler.
+ *
+ * @param {Float32Array|number[]} out  length-3 destination, one value per channel
+ * @param {Float32Array} data_0
+ * @param {Float32Array} data_1
+ * @param {Float32Array} data_2
+ * @param {number} res_x
+ * @param {number} res_y
+ * @param {number} res_z
+ * @param {number} x
+ * @param {number} y
+ * @param {number} z
+ * @return {Float32Array|number[]} `out`, for chaining.
+ */
+export function scs3d_sample_linear3(out: Float32Array | number[], data_0: Float32Array, data_1: Float32Array, data_2: Float32Array, res_x: number, res_y: number, res_z: number, x: number, y: number, z: number): Float32Array | number[];
+//# sourceMappingURL=scs3d_sample_linear3.d.ts.map

package/src/engine/graphics/texture/3d/scs3d_sample_linear3.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scs3d_sample_linear3.d.ts","sourceRoot":"","sources":["../../../../../../src/engine/graphics/texture/3d/scs3d_sample_linear3.js"],"names":[],"mappings":"AAGA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,0CAZW,YAAY,GAAC,MAAM,EAAE,UACrB,YAAY,UACZ,YAAY,UACZ,YAAY,SACZ,MAAM,SACN,MAAM,SACN,MAAM,KACN,MAAM,KACN,MAAM,KACN,MAAM,GACL,YAAY,GAAC,MAAM,EAAE,CAsDhC"}