@woosh/meep-engine 3.51.0 → 3.53.0

package/src/engine/graphics/render/layers/RenderLayer.js

@@ -1,95 +0,0 @@
-import { passThrough } from "../../../../core/function/passThrough.js";
-import { compareObjectsByNumericId } from "../../../../core/model/object/compareObjectsByNumericId.js";
-import { IncrementalDeltaSet } from "../visibility/IncrementalDeltaSet.js";
-import { RenderLayerState } from "./RenderLayerState.js";
-
-export class RenderLayer {
-
-    /**
-     *
-     * @type {RenderLayerState}
-     */
-    state = new RenderLayerState();
-
-    /**
-     *
-     * @type {String|null}
-     */
-    name = null;
-
-    /**
-     * Layer is managed externally, visibility will not be updated in the rendering engine
-     * @deprecated
-     * @type {boolean}
-     */
-    managed = false;
-
-    /**
-     *
-     * @type {function(*): Object3D}
-     */
-    extractRenderable = passThrough;
-
-    /**
-     * @deprecated use CameraView's visible set instead
-     * Contains visible elements across all views, if element is in at least one view - it will be here
-     * @deprecated
-     * @type {IncrementalDeltaSet<*>}
-     */
-    visibleSet = new IncrementalDeltaSet(compareObjectsByNumericId);
-
-    /**
-     * @deprecated
-     * @returns {boolean}
-     */
-    get visible() {
-        return this.state.visible;
-    }
-
-    /**
-     * @deprecated
-     * @param {boolean} v
-     */
-    set visible(v) {
-        this.state.visible = v;
-    }
-
-    /**
-     * Compute near and far clipping planes for a camera given a frustum.
-     * Note: near plane is frustum.planes[4], far plane is frustum.planes[5]
-     * @deprecated
-     * @param {Frustum} frustum
-     * @param {number} near
-     * @param {number} far
-     * @param {(near: number, far: number) => void} callback
-     * @param [thisArg]
-     */
-    computeNearFarClippingPlanes(frustum, near, far, callback, thisArg) {
-        throw new Error('deprecated');
-    }
-
-    /**
-     * @deprecated
-     * @param {*[]} destination
-     * @param {number} destination_offset
-     * @param {CameraView} view
-     * @returns {number} Number of records added to destination
-     */
-    buildVisibleSet(destination, destination_offset, view) {
-        throw new Error('deprecated');
-    }
-
-    /**
-     * Expand a (near, far) depth range to cover this layer's content that
-     * intersects a frustum. Driven by the camera's autoClip path; defaults to
-     * a no-op for layers that don't own a BVH or don't participate in depth
-     * fitting (e.g. screen-space overlays).
-     *
-     * Systems with a BVH wire this from their `startup` alongside
-     * `buildVisibleSet` — typically using
-     * {@link bvh_query_depth_range_in_frustum} against their own BVH.
-     *
-     * @type {((result:{near:number,far:number}, frustum:ArrayLike<number>, plane_normal_x:number, plane_normal_y:number, plane_normal_z:number, plane_constant:number) => void) | null}
-     */
-    compute_depth_range = null;
-}

package/src/engine/graphics/render/layers/RenderLayerManager.d.ts

@@ -1,72 +0,0 @@
-export class RenderLayerManager {
-    /**
-     * @private
-     * @type {Stack<RenderLayerManagerState>}
-     */
-    private __stateStack;
-    /**
-     *
-     * @type {List<RenderLayer>}
-     */
-    layers: List<RenderLayer>;
-    /**
-     *
-     * @returns {number}
-     */
-    getLayerCount(): number;
-    /**
-     *
-     * @param {number} i
-     * @returns {RenderLayer}
-     */
-    getLayerByIndex(i: number): RenderLayer;
-    /**
-     * Hide all layers
-     */
-    hideAll(): void;
-    /**
-     *
-     * @returns {RenderLayerManagerState}
-     */
-    pushState(): RenderLayerManagerState;
-    popState(): void;
-    /**
-     *
-     * @param {string} name
-     * @return {RenderLayer}
-     */
-    create(name: string): RenderLayer;
-    /**
-     *
-     * @param {RenderLayer} layer
-     */
-    add(layer: RenderLayer): void;
-    /**
-     *
-     * @param {RenderLayer} layer
-     * @returns {boolean}
-     */
-    remove(layer: RenderLayer): boolean;
-    /**
-     *
-     * @param {string} name
-     * @returns {RenderLayer|undefined}
-     */
-    getLayerByName(name: string): RenderLayer | undefined;
-    /**
-     *
-     * @param {function(RenderLayer)} visitor
-     * @param {*} [thisArg]
-     */
-    traverse(visitor: (arg0: RenderLayer) => any, thisArg?: any): void;
-    /**
-     * @template {T}
-     * @param {function(RenderLayer):T} mapper
-     * @returns {T[]}
-     */
-    map(mapper: (arg0: RenderLayer) => T): T[];
-}
-import List from "../../../../core/collection/list/List.js";
-import { RenderLayer } from "./RenderLayer.js";
-import { RenderLayerManagerState } from "./RenderLayerManagerState.js";
-//# sourceMappingURL=RenderLayerManager.d.ts.map

package/src/engine/graphics/render/layers/RenderLayerManager.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"RenderLayerManager.d.ts","sourceRoot":"","sources":["../../../../../../src/engine/graphics/render/layers/RenderLayerManager.js"],"names":[],"mappings":"AAKA;IACI;;;OAGG;IACH,qBAA2B;IAE3B;;;OAGG;IACH,QAFU,KAAK,WAAW,CAAC,CAEP;IAEpB;;;OAGG;IACH,iBAFa,MAAM,CAIlB;IAED;;;;OAIG;IACH,mBAHW,MAAM,GACJ,WAAW,CAUvB;IAED;;OAEG;IACH,gBASC;IAED;;;OAGG;IACH,aAFa,uBAAuB,CAYnC;IAED,iBAcC;IAGD;;;;OAIG;IACH,aAHW,MAAM,GACL,WAAW,CAUtB;IAED;;;OAGG;IACH,WAFW,WAAW,QAerB;IAED;;;;OAIG;IACH,cAHW,WAAW,GACT,OAAO,CAInB;IAED;;;;OAIG;IACH,qBAHW,MAAM,GACJ,WAAW,GAAC,SAAS,CAMjC;IAED;;;;OAIG;IACH,yBAHoB,WAAW,+BAK9B;IAED;;;;OAIG;IACH,mBAHoB,WAAW,SAClB,GAAG,CAIf;CACJ;iBA/JgB,0CAA0C;4BAC/B,kBAAkB;wCAEN,8BAA8B"}

package/src/engine/graphics/render/layers/RenderLayerManager.js

@@ -1,160 +0,0 @@
-import List from "../../../../core/collection/list/List.js";
-import { RenderLayer } from "./RenderLayer.js";
-import { Stack } from "../../../../core/collection/Stack.js";
-import { RenderLayerManagerState } from "./RenderLayerManagerState.js";
-
-export class RenderLayerManager {
-    /**
-     * @private
-     * @type {Stack<RenderLayerManagerState>}
-     */
-    __stateStack = new Stack();
-
-    /**
-     *
-     * @type {List<RenderLayer>}
-     */
-    layers = new List();
-
-    /**
-     *
-     * @returns {number}
-     */
-    getLayerCount() {
-        return this.layers.length;
-    }
-
-    /**
-     *
-     * @param {number} i
-     * @returns {RenderLayer}
-     */
-    getLayerByIndex(i) {
-        const result = this.layers.get(i);
-
-        if (result === undefined) {
-            throw new Error(`Layer with index ${i} not found`);
-        }
-
-        return result;
-    }
-
-    /**
-     * Hide all layers
-     */
-    hideAll() {
-        const layers = this.layers;
-        const n = layers.length;
-
-        for (let i = 0; i < n; i++) {
-            const renderLayer = layers.get(i);
-
-            renderLayer.state.visible = false;
-        }
-    }
-
-    /**
-     *
-     * @returns {RenderLayerManagerState}
-     */
-    pushState() {
-        // console.warn('RenderLayerManager.pushState');
-
-        const state = new RenderLayerManagerState();
-
-        state.read(this);
-
-        this.__stateStack.push(state);
-
-        return state;
-    }
-
-    popState() {
-        // console.warn('RenderLayerManager.popState');
-
-        if (this.__stateStack.isEmpty()) {
-            return;
-        }
-
-        /**
-         *
-         * @type {RenderLayerManagerState}
-         */
-        const state = this.__stateStack.pop();
-
-        state.write(this);
-    }
-
-
-    /**
-     *
-     * @param {string} name
-     * @return {RenderLayer}
-     */
-    create(name) {
-        const result = new RenderLayer();
-
-        result.name = name;
-
-        this.add(result);
-
-        return result;
-    }
-
-    /**
-     *
-     * @param {RenderLayer} layer
-     */
-    add(layer) {
-
-        const name = layer.name;
-
-        const existingLayer = this.getLayerByName(name);
-
-        if (existingLayer !== undefined) {
-            throw new Error(`RenderLayer named '${name}' already exists`);
-        }
-
-
-        this.layers.add(layer);
-
-    }
-
-    /**
-     *
-     * @param {RenderLayer} layer
-     * @returns {boolean}
-     */
-    remove(layer) {
-        return this.layers.removeOneOf(layer);
-    }
-
-    /**
-     *
-     * @param {string} name
-     * @returns {RenderLayer|undefined}
-     */
-    getLayerByName(name) {
-        return this.layers.find(function (layer) {
-            return layer.name === name;
-        });
-    }
-
-    /**
-     *
-     * @param {function(RenderLayer)} visitor
-     * @param {*} [thisArg]
-     */
-    traverse(visitor, thisArg) {
-        this.layers.forEach(visitor, thisArg);
-    }
-
-    /**
-     * @template {T}
-     * @param {function(RenderLayer):T} mapper
-     * @returns {T[]}
-     */
-    map(mapper) {
-        return this.layers.map(mapper);
-    }
-}

package/src/engine/graphics/render/layers/RenderLayerManagerState.d.ts

@@ -1,18 +0,0 @@
-export class RenderLayerManagerState {
-    /**
-     *
-     * @type {Map<String,RenderLayerState>}
-     */
-    layers: Map<string, RenderLayerState>;
-    /**
-     *
-     * @param {RenderLayerManager} manager
-     */
-    write(manager: RenderLayerManager): void;
-    /**
-     * Read the current state from {@link RenderLayerManager}
-     * @param {RenderLayerManager} manager
-     */
-    read(manager: RenderLayerManager): void;
-}
-//# sourceMappingURL=RenderLayerManagerState.d.ts.map

package/src/engine/graphics/render/layers/RenderLayerManagerState.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"RenderLayerManagerState.d.ts","sourceRoot":"","sources":["../../../../../../src/engine/graphics/render/layers/RenderLayerManagerState.js"],"names":[],"mappings":"AAAA;IACI;;;OAGG;IACH,QAFU,6BAA4B,CAEnB;IAEnB;;;OAGG;IACH,yCAWC;IAED;;;OAGG;IACH,wCAkBC;CACJ"}

package/src/engine/graphics/render/layers/RenderLayerManagerState.js

@@ -1,48 +0,0 @@
-export class RenderLayerManagerState {
-    /**
-     *
-     * @type {Map<String,RenderLayerState>}
-     */
-    layers = new Map();
-
-    /**
-     *
-     * @param {RenderLayerManager} manager
-     */
-    write(manager) {
-        // console.log('RenderLayerManagerState.write');
-
-        for (const [id, state] of this.layers) {
-
-            const layer = manager.getLayerByName(id);
-
-            layer.state.copy(state);
-
-        }
-
-    }
-
-    /**
-     * Read the current state from {@link RenderLayerManager}
-     * @param {RenderLayerManager} manager
-     */
-    read(manager) {
-
-        // console.log('RenderLayerManagerState.read');
-
-        this.layers.clear();
-
-        const layers = manager.layers;
-
-        const layerCount = layers.length;
-
-        for (let i = 0; i < layerCount; i++) {
-            const layer = layers.get(i);
-
-            const layerState = layer.state.clone();
-
-            this.layers.set(layer.name, layerState);
-        }
-
-    }
-}

package/src/engine/graphics/render/layers/RenderLayerState.d.ts

@@ -1,18 +0,0 @@
-export class RenderLayerState {
-    /**
-     * Whether the layer should be rendered or not
-     * @type {boolean}
-     */
-    visible: boolean;
-    /**
-     *
-     * @param {RenderLayerState} other
-     */
-    copy(other: RenderLayerState): void;
-    /**
-     *
-     * @returns {RenderLayerState}
-     */
-    clone(): RenderLayerState;
-}
-//# sourceMappingURL=RenderLayerState.d.ts.map

package/src/engine/graphics/render/layers/RenderLayerState.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"RenderLayerState.d.ts","sourceRoot":"","sources":["../../../../../../src/engine/graphics/render/layers/RenderLayerState.js"],"names":[],"mappings":"AAAA;IACI;;;OAGG;IACH,SAFU,OAAO,CAEF;IAEf;;;OAGG;IACH,YAFW,gBAAgB,QAI1B;IAED;;;OAGG;IACH,SAFa,gBAAgB,CAQ5B;CACJ"}

package/src/engine/graphics/render/layers/RenderLayerState.js

@@ -1,27 +0,0 @@
-export class RenderLayerState {
-    /**
-     * Whether the layer should be rendered or not
-     * @type {boolean}
-     */
-    visible = true;
-
-    /**
-     *
-     * @param {RenderLayerState} other
-     */
-    copy(other) {
-        this.visible = other.visible;
-    }
-
-    /**
-     *
-     * @returns {RenderLayerState}
-     */
-    clone() {
-        const r = new RenderLayerState();
-
-        r.copy(this);
-
-        return r;
-    }
-}

package/src/engine/graphics/render/layers/RenderLayerUtils.d.ts

@@ -1,8 +0,0 @@
-/**
- *
- * @param {function(function(Plane))} traversePlanes
- * @param {number} [bias=0]
- * @returns {Function}
- */
-export function buildPlanarRenderLayerClipPlaneComputationMethod(traversePlanes: (arg0: (arg0: Plane) => any) => any, bias?: number): Function;
-//# sourceMappingURL=RenderLayerUtils.d.ts.map

package/src/engine/graphics/render/layers/RenderLayerUtils.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"RenderLayerUtils.d.ts","sourceRoot":"","sources":["../../../../../../src/engine/graphics/render/layers/RenderLayerUtils.js"],"names":[],"mappings":"AAGA;;;;;GAKG;AACH,6HAHW,MAAM,YAgGhB"}

package/src/engine/graphics/render/layers/RenderLayerUtils.js

@@ -1,103 +0,0 @@
-import { v3_distance_above_plane } from "../../../../core/geom/vec3/v3_distance_above_plane.js";
-import { plane3_compute_3_plane_intersection_from_three } from "../../../../core/geom/3d/plane/plane3_compute_3_plane_intersection_from_three.js";
-
-/**
- *
- * @param {function(function(Plane))} traversePlanes
- * @param {number} [bias=0]
- * @returns {Function}
- */
-export function buildPlanarRenderLayerClipPlaneComputationMethod(traversePlanes, bias = 0) {
-
-    /**
-     *
-     * @type {number[]}
-     */
-    const p = [];
-
-    const adjacentPlanePairs = [
-        [],
-        [],
-        [],
-        []
-    ];
-
-    const range = {
-        near: 0,
-        far: 0
-    };
-
-    let nearPlane;
-
-    /**
-     *
-     * @param {Plane} objectPlane
-     */
-    function visitPlane(objectPlane) {
-
-        for (let i = 0; i < 4; i++) {
-            const pair = adjacentPlanePairs[i];
-
-            const p0 = pair[0];
-            const p1 = pair[1];
-
-            const planeIntersection = plane3_compute_3_plane_intersection_from_three(p, 0, p0, p1, objectPlane);
-
-            if (!planeIntersection) {
-                //no intersection
-                continue;
-            }
-
-
-            const plane_normal = nearPlane.normal;
-
-            const distanceToNearPlane = v3_distance_above_plane(p[0], p[1], p[2], plane_normal.x, plane_normal.y, plane_normal.z, nearPlane.constant);
-
-            //update near and far plane distances
-            if (distanceToNearPlane > 0 && distanceToNearPlane < range.near) {
-                range.near = distanceToNearPlane;
-            }
-
-            if (distanceToNearPlane > range.far) {
-                range.far = distanceToNearPlane;
-            }
-        }
-
-    }
-
-    /**
-     *
-     * @param {Frustum} frustum
-     * @param {number} near
-     * @param {number} far
-     * @param {(near: number, far: number) => void} visitor
-     */
-    return function (frustum, near, far, visitor, thisArg) {
-
-        const frustumPlanes = frustum.planes;
-
-        nearPlane = frustumPlanes[5];
-
-        adjacentPlanePairs[0][0] = frustumPlanes[0];
-        adjacentPlanePairs[0][1] = frustumPlanes[2];
-
-        adjacentPlanePairs[1][0] = frustumPlanes[0];
-        adjacentPlanePairs[1][1] = frustumPlanes[3];
-
-        adjacentPlanePairs[2][0] = frustumPlanes[1];
-        adjacentPlanePairs[2][1] = frustumPlanes[2];
-
-        adjacentPlanePairs[3][0] = frustumPlanes[1];
-        adjacentPlanePairs[3][1] = frustumPlanes[3];
-
-        range.near = near;
-        range.far = far;
-
-        traversePlanes(visitPlane);
-
-        if (range.near <= range.far) {
-            visitor.call(thisArg, range.near - bias, range.far + bias);
-        }
-    };
-
-}

package/src/engine/graphics/render/make_bvh_visibility_builder.d.ts

@@ -1,10 +0,0 @@
-/**
- * Assumes that BVH stored entity IDs
- * @param {EntityManager} em
- * @param {BVH} bvh
- * @param {function(Object3D[],number,number,EntityComponentDataset)} extract
- * @param {*} [extract_context]
- * @returns {(function(Object3D[], number, CameraView): number)|*}
- */
-export function make_bvh_visibility_builder(em: EntityManager, bvh: BVH, extract: (arg0: Object3D[], arg1: number, arg2: number, arg3: EntityComponentDataset) => any, extract_context?: any): ((arg0: Object3D[], arg1: number, arg2: CameraView) => number) | any;
-//# sourceMappingURL=make_bvh_visibility_builder.d.ts.map

package/src/engine/graphics/render/make_bvh_visibility_builder.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"make_bvh_visibility_builder.d.ts","sourceRoot":"","sources":["../../../../../src/engine/graphics/render/make_bvh_visibility_builder.js"],"names":[],"mappings":"AAKA;;;;;;;GAOG;AACH,yFAJoB,UAAU,QAAC,MAAM,QAAC,MAAM,gEAE/B,QAAU,UAAU,QAAE,MAAM,uBAAe,MAAM,CAAC,MAAE,CAoDhE"}

package/src/engine/graphics/render/make_bvh_visibility_builder.js

@@ -1,64 +0,0 @@
-import { assert } from "../../../core/assert.js";
-import {
-    bvh_query_user_data_intersects_frustum
-} from "../../../core/bvh2/bvh3/query/bvh_query_user_data_intersects_frustum.js";
-
-/**
- * Assumes that BVH stored entity IDs
- * @param {EntityManager} em
- * @param {BVH} bvh
- * @param {function(Object3D[],number,number,EntityComponentDataset)} extract
- * @param {*} [extract_context]
- * @returns {(function(Object3D[], number, CameraView): number)|*}
- */
-export function make_bvh_visibility_builder(em, bvh, extract, extract_context) {
-    assert.defined(em, 'em');
-    assert.defined(bvh, 'bvh');
-    assert.isFunction(extract, 'extract');
-
-    const scratch_array = [];
-
-    /**
-     *
-     * @param {*[]} destination
-     * @param {number} destination_offset
-     * @param {CameraView} view
-     * @returns {number} Number of records added to destination
-     */
-    function compute(destination, destination_offset, view) {
-
-        if (em === null) {
-            return 0;
-        }
-
-        const dataset = em.dataset;
-
-        if (dataset === null) {
-            return 0;
-        }
-
-        const matches = bvh_query_user_data_intersects_frustum(
-            scratch_array, 0,
-            bvh, view.frustum
-        );
-
-        let additions = 0;
-
-        for (let i = 0; i < matches; i++) {
-            const entity = scratch_array[i];
-
-            const offset = destination_offset + additions;
-
-            const elements_from_entity = extract.call(extract_context, destination, offset, entity, dataset);
-
-            assert.isNonNegativeInteger(elements_from_entity, 'additions');
-
-            additions += elements_from_entity;
-        }
-
-        return additions;
-    }
-
-    return compute;
-
-}

package/src/engine/graphics/render/view/CameraViewFlags.d.ts

@@ -1,7 +0,0 @@
-export type CameraViewFlags = number;
-export namespace CameraViewFlags {
-    let Active: number;
-    let AdaptivePlaneNear: number;
-    let AdaptivePlaneFar: number;
-}
-//# sourceMappingURL=CameraViewFlags.d.ts.map

package/src/engine/graphics/render/view/CameraViewFlags.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"CameraViewFlags.d.ts","sourceRoot":"","sources":["../../../../../../src/engine/graphics/render/view/CameraViewFlags.js"],"names":[],"mappings":"8BAEU,MAAM"}

package/src/engine/graphics/render/view/CameraViewFlags.js

@@ -1,9 +0,0 @@
-/**
- *
- * @enum {number}
- */
-export const CameraViewFlags = {
-    Active: 1,
-    AdaptivePlaneNear: 2,
-    AdaptivePlaneFar: 4,
-};