@woosh/meep-engine 3.3.0 → 3.5.0

package/src/engine/graphics/ecs/light/shadow/compute_view_frustum_aabb_in_space.js

@@ -1,62 +0,0 @@
-import { assert } from "../../../../../core/assert.js";
-import { frustum_compute_corners } from "../../../../../core/geom/3d/frustum/frustum_compute_corners.js";
-import {
-    frustum_from_projection_matrix_array
-} from "../../../../../core/geom/3d/frustum/frustum_from_projection_matrix_array.js";
-import { v3_matrix4_multiply } from "../../../../../core/geom/vec3/v3_matrix4_multiply.js";
-
-const scratch_planes = new Float32Array(24);
-const scratch_corners = new Float32Array(24);
-const scratch_point = new Float32Array(3);
-
-/**
- * Compute the AABB of a camera's view-frustum corners after they are projected
- * into another space (e.g. a shadow camera's local space).
- *
- * The view-projection matrix is fed to Gribb-Hartmann to extract 6 inward-facing
- * planes; the 8 corners are then solved as triple-plane intersections in world
- * space and transformed by the target-space matrix.
- *
- * @param {AABB3} result bounds in target space
- * @param {ArrayLike<number>} view_projection_matrix column-major projection * view of the source camera
- * @param {ArrayLike<number>} target_space_matrix column-major world -> target space transform
- */
-export function compute_view_frustum_aabb_in_space(
-    result,
-    view_projection_matrix,
-    target_space_matrix
-) {
-    assert.defined(result, 'result');
-    assert.isArrayLike(view_projection_matrix, 'view_projection_matrix');
-    assert.greaterThanOrEqual(view_projection_matrix.length, 16, 'view_projection_matrix.length');
-    assert.isArrayLike(target_space_matrix, 'target_space_matrix');
-    assert.greaterThanOrEqual(target_space_matrix.length, 16, 'target_space_matrix.length');
-
-    frustum_from_projection_matrix_array(scratch_planes, view_projection_matrix);
-    frustum_compute_corners(scratch_corners, 0, scratch_planes, 0);
-
-    let x0 = Number.POSITIVE_INFINITY;
-    let y0 = Number.POSITIVE_INFINITY;
-    let z0 = Number.POSITIVE_INFINITY;
-
-    let x1 = Number.NEGATIVE_INFINITY;
-    let y1 = Number.NEGATIVE_INFINITY;
-    let z1 = Number.NEGATIVE_INFINITY;
-
-    for (let i = 0; i < 8; i++) {
-        v3_matrix4_multiply(scratch_point, 0, scratch_corners, i * 3, target_space_matrix);
-
-        const x = scratch_point[0];
-        const y = scratch_point[1];
-        const z = scratch_point[2];
-
-        if (x < x0) x0 = x;
-        if (x > x1) x1 = x;
-        if (y < y0) y0 = y;
-        if (y > y1) y1 = y;
-        if (z < z0) z0 = z;
-        if (z > z1) z1 = z;
-    }
-
-    result.setBounds(x0, y0, z0, x1, y1, z1);
-}

package/src/engine/graphics/ecs/light/shadow/extend_shadow_camera_near_for_casters.d.ts

@@ -1,30 +0,0 @@
-/**
- * Push the shadow camera's near plane back toward the light to include any
- * occluder whose shadow would fall within the camera's x/y bounds, even when
- * the occluder itself sits outside the main view frustum.
- *
- * Without this step the textbook "fit shadow camera to view frustum" leaves
- * the near plane at the closest receiver — a brick floating just above the
- * view frustum gets clipped out of the shadow map and casts no shadow on the
- * ground below.
- *
- * Algorithm:
- *   1. Take the shadow camera's existing left/right/top/bottom (already fit
- *      to receivers) as the x/y extents of a light-local query box. Extend z
- *      to a wide range so any caster along the light direction is captured.
- *   2. Transform the 6 box planes to world space via the shadow camera's
- *      matrixWorld.
- *   3. Walk every render layer's BVH through `compute_depth_range` against
- *      this world-space volume, measured along the shadow camera's view
- *      direction.
- *   4. If the closest depth found is smaller than the camera's current near,
- *      replace near with it.
- *
- * Far is intentionally left alone: casters behind the farthest receiver (in
- * light direction) can't shadow anything in the view.
- *
- * @param {THREE.OrthographicCamera} shadow_camera
- * @param {RenderLayerManager} layers
- */
-export function extend_shadow_camera_near_for_casters(shadow_camera: THREE.OrthographicCamera, layers: RenderLayerManager): void;
-//# sourceMappingURL=extend_shadow_camera_near_for_casters.d.ts.map

package/src/engine/graphics/ecs/light/shadow/extend_shadow_camera_near_for_casters.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"extend_shadow_camera_near_for_casters.d.ts","sourceRoot":"","sources":["../../../../../../../src/engine/graphics/ecs/light/shadow/extend_shadow_camera_near_for_casters.js"],"names":[],"mappings":"AAeA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,iIAiCC"}

package/src/engine/graphics/ecs/light/shadow/extend_shadow_camera_near_for_casters.js

@@ -1,77 +0,0 @@
-import { frustum3_matrix4_project_n } from "../../../../../core/geom/3d/frustum/frustum3_matrix4_project_n.js";
-import { frustum3_from_aabb } from "../../../../../core/geom/3d/frustum/frustum3_from_aabb.js";
-import { render_layers_compute_depth_range } from "../../render_layers_compute_depth_range.js";
-
-const scratch_local_planes = new Float32Array(24);
-const scratch_world_planes = new Float32Array(24);
-const scratch_range = { near: 0, far: 0 };
-
-// Half-extent of the z range used for the caster query. We want any object in
-// the column above the receivers regardless of how far it sits along the light
-// direction, so the query volume is effectively unbounded in z; the BVH walk's
-// AABB-vs-frustum test is happy with a wide-but-finite range and avoids
-// infinities propagating through plane math.
-const CASTER_QUERY_HALF_RANGE = 1e7;
-
-/**
- * Push the shadow camera's near plane back toward the light to include any
- * occluder whose shadow would fall within the camera's x/y bounds, even when
- * the occluder itself sits outside the main view frustum.
- *
- * Without this step the textbook "fit shadow camera to view frustum" leaves
- * the near plane at the closest receiver — a brick floating just above the
- * view frustum gets clipped out of the shadow map and casts no shadow on the
- * ground below.
- *
- * Algorithm:
- *   1. Take the shadow camera's existing left/right/top/bottom (already fit
- *      to receivers) as the x/y extents of a light-local query box. Extend z
- *      to a wide range so any caster along the light direction is captured.
- *   2. Transform the 6 box planes to world space via the shadow camera's
- *      matrixWorld.
- *   3. Walk every render layer's BVH through `compute_depth_range` against
- *      this world-space volume, measured along the shadow camera's view
- *      direction.
- *   4. If the closest depth found is smaller than the camera's current near,
- *      replace near with it.
- *
- * Far is intentionally left alone: casters behind the farthest receiver (in
- * light direction) can't shadow anything in the view.
- *
- * @param {THREE.OrthographicCamera} shadow_camera
- * @param {RenderLayerManager} layers
- */
-export function extend_shadow_camera_near_for_casters(shadow_camera, layers) {
-    if (layers === null) {
-        return;
-    }
-
-    const x0 = shadow_camera.left;
-    const x1 = shadow_camera.right;
-    const y0 = shadow_camera.bottom;
-    const y1 = shadow_camera.top;
-
-    frustum3_from_aabb(
-        scratch_local_planes, 0,
-        x0, y0, -CASTER_QUERY_HALF_RANGE,
-        x1, y1, CASTER_QUERY_HALF_RANGE
-    );
-
-    frustum3_matrix4_project_n(
-        scratch_world_planes, 0,
-        scratch_local_planes, 0,
-        6,
-        shadow_camera.matrixWorld.elements
-    );
-
-    render_layers_compute_depth_range(
-        scratch_range,
-        layers,
-        scratch_world_planes,
-        shadow_camera.matrixWorld.elements
-    );
-
-    if (isFinite(scratch_range.near) && scratch_range.near < shadow_camera.near) {
-        shadow_camera.near = scratch_range.near;
-    }
-}

package/src/engine/graphics/ecs/light/shadow/setShadowCameraDimensionsDiscrete.d.ts

@@ -1,13 +0,0 @@
-/**
- *
- * @param {Vector2} mapSize
- * @param camera
- * @param {number} x0
- * @param {number} y0
- * @param {number} z0
- * @param {number} x1
- * @param {number} y1
- * @param {number} z1
- */
-export function setShadowCameraDimensionsDiscrete(mapSize: Vector2, camera: any, x0: number, y0: number, z0: number, x1: number, y1: number, z1: number): void;
-//# sourceMappingURL=setShadowCameraDimensionsDiscrete.d.ts.map

package/src/engine/graphics/ecs/light/shadow/setShadowCameraDimensionsDiscrete.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"setShadowCameraDimensionsDiscrete.d.ts","sourceRoot":"","sources":["../../../../../../../src/engine/graphics/ecs/light/shadow/setShadowCameraDimensionsDiscrete.js"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,qFAPW,MAAM,MACN,MAAM,MACN,MAAM,MACN,MAAM,MACN,MAAM,MACN,MAAM,QAiChB"}

package/src/engine/graphics/ecs/light/shadow/setShadowCameraDimensionsDiscrete.js

@@ -1,43 +0,0 @@
-/**
- *
- * @param {Vector2} mapSize
- * @param camera
- * @param {number} x0
- * @param {number} y0
- * @param {number} z0
- * @param {number} x1
- * @param {number} y1
- * @param {number} z1
- */
-export function setShadowCameraDimensionsDiscrete(
-    mapSize,
-    camera,
-    x0,
-    y0,
-    z0,
-    x1,
-    y1,
-    z1
-) {
-    const dX = x1 - x0;
-    const dY = y1 - y0;
-
-    const shadow_map_width = mapSize.x;
-    const shadow_map_height = mapSize.y;
-
-    const rX = dX / shadow_map_width;
-    const rY = dY / shadow_map_height;
-
-    //set start coordinate to pixel-snapped position
-    const x0_d = x0 - x0 % rX - rX / 2;
-    const y0_d = y0 - y0 % rY - rY / 2;
-
-    const x1_d = x0_d + (dX) * ((shadow_map_width + 1) / shadow_map_width);
-    const y1_d = y0_d + (dY) * ((shadow_map_height + 1) / shadow_map_height);
-
-    camera.left = x0_d;
-    camera.right = x1_d;
-
-    camera.bottom = y0_d;
-    camera.top = y1_d;
-}

package/src/engine/graphics/ecs/light/three/light2type.d.ts

@@ -1,8 +0,0 @@
-/**
- *
- * @param {Light} light
- * @returns {LightType}
- */
-export function light2type(light: Light): LightType;
-import { LightType } from "../LightType.js";
-//# sourceMappingURL=light2type.d.ts.map

package/src/engine/graphics/ecs/light/three/light2type.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"light2type.d.ts","sourceRoot":"","sources":["../../../../../../../src/engine/graphics/ecs/light/three/light2type.js"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,0CAFa,SAAS,CAcrB;0BAnByB,iBAAiB"}

package/src/engine/graphics/ecs/light/three/light2type.js

@@ -1,20 +0,0 @@
-import { LightType } from "../LightType.js";
-
-/**
- *
- * @param {Light} light
- * @returns {LightType}
- */
-export function light2type(light) {
-    if (light.isPointLight) {
-        return LightType.POINT;
-    } else if (light.isSpotLight) {
-        return LightType.SPOT;
-    } else if (light.isDirectionalLight) {
-        return LightType.DIRECTION;
-    } else if (light.isAmbientLight) {
-        return LightType.AMBIENT;
-    } else {
-        throw new Error('Unsupported light type');
-    }
-}

package/src/engine/graphics/ecs/mesh/applyTransformToThreeObject.d.ts

@@ -1,7 +0,0 @@
-/**
- *
- * @param {Object3D} m
- * @param {Transform} t
- */
-export function applyTransformToThreeObject(m: Object3D, t: Transform): void;
-//# sourceMappingURL=applyTransformToThreeObject.d.ts.map

package/src/engine/graphics/ecs/mesh/applyTransformToThreeObject.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"applyTransformToThreeObject.d.ts","sourceRoot":"","sources":["../../../../../../src/engine/graphics/ecs/mesh/applyTransformToThreeObject.js"],"names":[],"mappings":"AAGA;;;;GAIG;AACH,6EAIC"}

package/src/engine/graphics/ecs/mesh/applyTransformToThreeObject.js

@@ -1,13 +0,0 @@
-import { rootObject3DFastMatrixUpdate } from "./rootObject3DFastMatrixUpdate.js";
-import { copy_transform_to_threejs_object } from "../../copy_transform_to_threejs_object.js";
-
-/**
- *
- * @param {Object3D} m
- * @param {Transform} t
- */
-export function applyTransformToThreeObject(m, t) {
-    copy_transform_to_threejs_object(m, t);
-
-    rootObject3DFastMatrixUpdate(m);
-}

package/src/engine/graphics/ecs/mesh-v2/DeferredBoundsQueue.d.ts

@@ -1,48 +0,0 @@
-/**
- * Collects {@link ShadedGeometry} components whose bounding box has gone stale under
- * {@link ShadedGeometryFlags.DeferredBoundsUpdate}, until the owner of the BVH is ready
- * to take the updates.
- *
- * WHY THIS EXISTS
- *
- * A {@link Transform} signals `position`, `rotation` and `scale` separately, so one
- * logical move produces several change notifications: two when a caller sets position
- * and rotation, three when the transform is written as a matrix (which is what
- * {@link TransformAttachmentSystem} does for every entity in a hierarchy, and what
- * `Transform.copy` does). Updating bounds on each of those recomputes the same box and
- * walks the same path to the BVH root several times over. Parking the component here
- * instead collapses the batch into one update per component per flush.
- *
- * Entries are appended without a membership test; {@link ShadedGeometry} carries the
- * "already queued" bit so enqueueing stays O(1) and a component appears at most once.
- */
-export class DeferredBoundsQueue {
-    /**
-     * Number of components waiting for their bounds to be applied.
-     * @returns {number}
-     */
-    get size(): number;
-    /**
-     * Park a component whose bounds have gone stale.
-     *
-     * The caller must not add a component that is already queued — see
-     * {@link ShadedGeometry.updateTransform}, which owns that bit.
-     * @param {ShadedGeometry} sg
-     * @returns {void}
-     */
-    add(sg: ShadedGeometry): void;
-    /**
-     * Apply every parked update, leaving the BVH consistent with the current transforms.
-     *
-     * Components that were unlinked while queued, or whose bounds were already settled by
-     * a read, are skipped.
-     *
-     * Must not be re-entered: nothing reached from here writes to a {@link Transform},
-     * so no component can go dirty while the batch is being applied.
-     * @returns {number} how many components actually had an update applied, which is a
-     * useful profiling signal — it is the number of BVH refits the batch cost
-     */
-    flush(): number;
-    #private;
-}
-//# sourceMappingURL=DeferredBoundsQueue.d.ts.map

package/src/engine/graphics/ecs/mesh-v2/DeferredBoundsQueue.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"DeferredBoundsQueue.d.ts","sourceRoot":"","sources":["../../../../../../src/engine/graphics/ecs/mesh-v2/DeferredBoundsQueue.js"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AACH;IAaI;;;OAGG;IACH,mBAEC;IAED;;;;;;;OAOG;IACH,yBAFa,IAAI,CAIhB;IAED;;;;;;;;;;OAUG;IACH,SAHa,MAAM,CA2BlB;;CACJ"}

package/src/engine/graphics/ecs/mesh-v2/DeferredBoundsQueue.js

@@ -1,88 +0,0 @@
-/**
- * Collects {@link ShadedGeometry} components whose bounding box has gone stale under
- * {@link ShadedGeometryFlags.DeferredBoundsUpdate}, until the owner of the BVH is ready
- * to take the updates.
- *
- * WHY THIS EXISTS
- *
- * A {@link Transform} signals `position`, `rotation` and `scale` separately, so one
- * logical move produces several change notifications: two when a caller sets position
- * and rotation, three when the transform is written as a matrix (which is what
- * {@link TransformAttachmentSystem} does for every entity in a hierarchy, and what
- * `Transform.copy` does). Updating bounds on each of those recomputes the same box and
- * walks the same path to the BVH root several times over. Parking the component here
- * instead collapses the batch into one update per component per flush.
- *
- * Entries are appended without a membership test; {@link ShadedGeometry} carries the
- * "already queued" bit so enqueueing stays O(1) and a component appears at most once.
- */
-export class DeferredBoundsQueue {
-    /**
-     * Retained between flushes and overwritten in place rather than re-allocated.
-     * Only the first {@link #size} entries are live.
-     * @type {ShadedGeometry[]}
-     */
-    #items = [];
-
-    /**
-     * @type {number}
-     */
-    #size = 0;
-
-    /**
-     * Number of components waiting for their bounds to be applied.
-     * @returns {number}
-     */
-    get size() {
-        return this.#size;
-    }
-
-    /**
-     * Park a component whose bounds have gone stale.
-     *
-     * The caller must not add a component that is already queued — see
-     * {@link ShadedGeometry.updateTransform}, which owns that bit.
-     * @param {ShadedGeometry} sg
-     * @returns {void}
-     */
-    add(sg) {
-        this.#items[this.#size++] = sg;
-    }
-
-    /**
-     * Apply every parked update, leaving the BVH consistent with the current transforms.
-     *
-     * Components that were unlinked while queued, or whose bounds were already settled by
-     * a read, are skipped.
-     *
-     * Must not be re-entered: nothing reached from here writes to a {@link Transform},
-     * so no component can go dirty while the batch is being applied.
-     * @returns {number} how many components actually had an update applied, which is a
-     * useful profiling signal — it is the number of BVH refits the batch cost
-     */
-    flush() {
-        const items = this.#items;
-        const size = this.#size;
-
-        let applied = 0;
-
-        for (let i = 0; i < size; i++) {
-            if (items[i].applyDeferredBoundsUpdate()) {
-                applied++;
-            }
-        }
-
-        // Drop the references so components unlinked while queued are not held alive
-        // until their slot happens to be overwritten — after a teardown the slots may
-        // never be reused, and each entry retains a geometry and a material.
-        //
-        // Done in one sweep rather than per entry inside the loop above: clearing each
-        // slot as it was consumed measured ~25% slower per tick on a 2000-mover scene,
-        // the store into the object array carrying a GC write barrier each time.
-        items.fill(null, 0, size);
-
-        this.#size = 0;
-
-        return applied;
-    }
-}

package/src/engine/graphics/ecs/mesh-v2/aggregate/SGMeshSystem.d.ts

@@ -1,63 +0,0 @@
-export class SGMeshSystem extends System<any> {
-    /**
-     *
-     * @param {Engine} engine
-     */
-    constructor(engine: Engine);
-    dependencies: (typeof Transform | typeof SGMesh)[];
-    components_used: (ResourceAccessSpecification<typeof Transform> | ResourceAccessSpecification<typeof TransformAttachment> | ResourceAccessSpecification<typeof SGMesh> | ResourceAccessSpecification<typeof ShadedGeometry>)[];
-    /**
-     *
-     * @type {number[]}
-     * @private
-     */
-    private __wait_queue;
-    /**
-     *
-     * @type {number}
-     * @private
-     */
-    private __wait_queue_process_index;
-    /**
-     *
-     * @type {Engine}
-     * @private
-     */
-    private __engine;
-    /**
-     *
-     * @type {AssetManager}
-     * @private
-     */
-    private __assetManager;
-    startup(em: any): Promise<void>;
-    /**
-     *
-     * @param {number} entity
-     * @param {SGMesh} mesh
-     * @param {Transform} transform
-     */
-    process(entity: number, mesh: SGMesh, transform: Transform): Promise<void>;
-    /**
-     *
-     * @param {SGMesh} mesh
-     * @param {Transform} transform
-     * @param {number} entity
-     */
-    link(mesh: SGMesh, transform: Transform, entity: number): void;
-    /**
-     *
-     * @param {SGMesh} mesh
-     * @param {Transform} transform
-     * @param {number} entity
-     */
-    unlink(mesh: SGMesh, transform: Transform, entity: number): void;
-    update(time_delta: any): void;
-}
-import { System } from "../../../../ecs/System.js";
-import { Transform } from "../../../../ecs/transform/Transform.js";
-import { SGMesh } from "./SGMesh.js";
-import { ResourceAccessSpecification } from "../../../../../core/model/ResourceAccessSpecification.js";
-import { TransformAttachment } from "../../../../ecs/transform-attachment/TransformAttachment.js";
-import { ShadedGeometry } from "../ShadedGeometry.js";
-//# sourceMappingURL=SGMeshSystem.d.ts.map

package/src/engine/graphics/ecs/mesh-v2/aggregate/SGMeshSystem.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"SGMeshSystem.d.ts","sourceRoot":"","sources":["../../../../../../../src/engine/graphics/ecs/mesh-v2/aggregate/SGMeshSystem.js"],"names":[],"mappings":"AA8CA;IAuBI;;;OAGG;IACH,4BAgBC;IA1CD,mDAAmC;IACnC,+NAKE;IAEF;;;;OAIG;IACH,qBAAkB;IAElB;;;;OAIG;IACH,mCAA+B;IAS3B;;;;OAIG;IACH,iBAAsB;IAEtB;;;;OAIG;IACH,uBAAyC;IAG7C,gCAMC;IAED;;;;;OAKG;IACH,gBAJW,MAAM,QACN,MAAM,aACN,SAAS,iBA8GnB;IAED;;;;;OAKG;IACH,WAJW,MAAM,aACN,SAAS,UACT,MAAM,QAiBhB;IAED;;;;;OAKG;IACH,aAJW,MAAM,aACN,SAAS,UACT,MAAM,QAehB;IAED,8BAqDC;CACJ;uBAnTsB,2BAA2B;0BAGxB,wCAAwC;uBAK3C,aAAa;4CAZQ,0DAA0D;oCAKlE,6DAA6D;+BAIlE,sBAAsB"}