@woosh/meep-engine 3.0.0 → 3.0.1

package/src/engine/graphics/ecs/camera/CameraSystem.js

@@ -1,331 +0,0 @@
-import { Frustum as ThreeFrustum, } from 'three';
-import { assert } from "../../../../core/assert.js";
-import { SignalBinding } from "../../../../core/events/signal/SignalBinding.js";
-import Quaternion from "../../../../core/geom/Quaternion.js";
-import { ResourceAccessKind } from "../../../../core/model/ResourceAccessKind.js";
-import { ResourceAccessSpecification } from "../../../../core/model/ResourceAccessSpecification.js";
-import { System } from '../../../ecs/System.js';
-import { Transform } from '../../../ecs/transform/Transform.js';
-import { threeUpdateTransform } from "../../util/threeUpdateTransform.js";
-import { auto_set_camera_clipping_planes } from "./auto_set_camera_clipping_planes.js";
-import { build_three_camera_object } from "./build_three_camera_object.js";
-import { Camera } from './Camera.js';
-import { frustum_from_camera } from "./frustum_from_camera.js";
-import { quaternion_invert_orientation } from "./quaternion_invert_orientation.js";
-import { set_camera_aspect_ratio } from "./set_camera_aspect_ratio.js";
-import { update_camera_transform } from "./update_camera_transform.js";
-
-
-const scratch_quat = new Quaternion();
-
-/**
- *
- * @param {THREE.Camera} object
- * @param {Quaternion} rotation
- */
-export function three_camera_set_transform_rotation(object, rotation) {
-
-    /*
-    NOTE: I'm not sure why, but three.js camera points in the opposite direction to normal objects
-    See: https://github.com/mrdoob/three.js/blob/412b99a7f26e117ea97f40eb53d010ab81aa3279/src/core/Object3D.js#L282
-     */
-
-    quaternion_invert_orientation(scratch_quat, rotation);
-
-    object.quaternion.set(
-        scratch_quat.x, scratch_quat.y, scratch_quat.z, scratch_quat.w
-    );
-
-    object.rotation.setFromQuaternion(object.quaternion);
-
-    // rotation.__setThreeEuler(camera.object.rotation); // seems unnecessary, based on Object3D.lookAt implementation
-    // camera.object.quaternion.set(rotation.x, rotation.y, rotation.z, rotation.w);
-
-    object.updateProjectionMatrix();
-    threeUpdateTransform(object);
-}
-
-export class CameraSystem extends System {
-    /**
-     *
-     * @type {EntityManager}
-     */
-    entityManager = null;
-
-    entityData = [];
-
-    /**
-     *
-     * @param {GraphicsEngine} graphics
-     * @constructor
-     */
-    constructor(graphics) {
-        super();
-
-        assert.defined(graphics, 'graphics');
-        assert.notNull(graphics, 'graphics');
-        assert.equal(graphics.isGraphicsEngine, true, 'graphics.isGraphicsEngine !== true');
-
-        this.scene = graphics.scene;
-
-        this.dependencies = [Camera, Transform];
-
-        this.components_used = [
-            ResourceAccessSpecification.from(Camera, ResourceAccessKind.Write)
-        ];
-
-        /**
-         * @type {GraphicsEngine}
-         */
-        this.graphics = graphics;
-
-        const self = this;
-
-        /**
-         *
-         * @param {number} x
-         * @param {number} y
-         * @private
-         */
-        this.__handleViewportResize = function (x, y) {
-            const em = self.entityManager;
-            if (em === null) {
-                return;
-            }
-
-            const dataset = em.dataset;
-
-            if (dataset === null) {
-                return;
-            }
-
-            dataset.traverseComponents(Camera, function (camera) {
-                set_camera_aspect_ratio(camera, x, y);
-            });
-        };
-
-        this.signalBindings = [];
-    }
-
-
-    /**
-     *
-     * @param {Transform} transform
-     * @param {Camera} camera
-     * @param entityId
-     */
-    link(camera, transform, entityId) {
-        if (camera.object === null) {
-            camera.object = build_three_camera_object(camera);
-        }
-
-        const graphics = this.graphics;
-
-        const viewportSize = graphics.viewport.size;
-
-        set_camera_aspect_ratio(camera, viewportSize.x, viewportSize.y);
-
-        this.scene.add(camera.object);
-
-        function synchronizePosition(x, y, z) {
-            assert.isNumber(x, 'x');
-            assert.isNumber(y, 'y');
-            assert.isNumber(z, 'z');
-
-            camera.object.position.set(x, y, z);
-            update_camera_transform(camera);
-        }
-
-        function synchronizeRotation() {
-            const rotation = transform.rotation;
-
-            three_camera_set_transform_rotation(camera.object, rotation);
-        }
-
-        function rebuild() {
-            camera.object = build_three_camera_object(camera);
-            set_camera_aspect_ratio(camera, viewportSize.x, viewportSize.y);
-
-            const position = transform.position;
-
-            synchronizePosition(position.x, position.y, position.z);
-            synchronizeRotation();
-
-            synchronizeActiveState(camera.active.getValue());
-        }
-
-        function synchronizeActiveState(v) {
-            if (v) {
-                graphics.camera = camera.object;
-            } else {
-                //active camera disabled
-            }
-        }
-
-        const position = transform.position;
-        const rotation = transform.rotation;
-
-        const signalBindings = [
-            new SignalBinding(position.onChanged, synchronizePosition),
-            new SignalBinding(rotation.onChanged, synchronizeRotation),
-            new SignalBinding(camera.projectionType.onChanged, rebuild),
-            new SignalBinding(camera.active.onChanged, synchronizeActiveState),
-            new SignalBinding(camera.fov.onChanged, rebuild)
-        ];
-
-        signalBindings.forEach(b => b.link());
-
-        this.entityData[entityId] = signalBindings;
-
-
-        synchronizePosition(position.x, position.y, position.z);
-        synchronizeRotation(rotation.x, rotation.y, rotation.z, rotation.w);
-        synchronizeActiveState(camera.active.getValue());
-
-        assert.notEqual(camera.object, null, 'Camera object must not be null (invariant)');
-    }
-
-    /**
-     *
-     * @param {Transform} transform
-     * @param {Camera} camera
-     * @param entityId
-     */
-    unlink(camera, transform, entityId) {
-        const data = this.entityData;
-        if (data.hasOwnProperty(entityId)) {
-            const entityData = data[entityId];
-
-            if (entityData !== void 0) {
-                entityData.forEach(b => b.unlink());
-            }
-
-            delete data[entityId];
-        }
-
-        this.scene.remove(camera.object);
-    }
-
-    async startup(entityManager) {
-        this.entityManager = entityManager;
-
-        const graphics = this.graphics;
-
-        graphics.viewport.size.onChanged.add(this.__handleViewportResize);
-
-
-        const visibilityConstructionPreHook = new SignalBinding(graphics.on.visibilityConstructionStarted, function () {
-            const em = entityManager;
-
-            const layers = graphics.layers;
-
-
-            const dataset = em.dataset;
-
-            /**
-             *
-             * @param {Camera} c
-             */
-            function visitCameraEntity(c) {
-                if (c.object === null) {
-                    return;
-                }
-
-                if (!c.active.getValue()) {
-                    return;
-                }
-
-                if (c.object.updateProjectionMatrix !== undefined) {
-                    c.object.updateProjectionMatrix();
-                    c.object.updateMatrix();
-                    c.object.updateMatrixWorld(true);
-                }
-
-                if (c.autoClip === true) {
-                    auto_set_camera_clipping_planes(c, layers);
-                } else {
-                    c.object.far = c.clip_far;
-                    c.object.near = c.clip_near;
-                }
-            }
-
-            if (dataset !== null) {
-                dataset.traverseComponents(Camera, visitCameraEntity);
-            }
-        });
-
-        visibilityConstructionPreHook.link();
-
-        this.signalBindings.push(visibilityConstructionPreHook);
-
-    }
-
-    async shutdown(entityManager) {
-        this.graphics.viewport.size.onChanged.remove(this.__handleViewportResize);
-
-        this.signalBindings.forEach(sb => sb.unlink());
-
-        this.signalBindings.splice(0, this.signalBindings.length);
-    }
-
-    /**
-     *
-     * @param {EntityComponentDataset} ecd
-     * @param {(camera: Camera, entity: number) => void} visitor
-     */
-    static traverseActiveCameras(ecd, visitor) {
-
-        ecd.traverseComponents(Camera, function (c, entity) {
-            if (c.active.getValue()) {
-                visitor(c, entity);
-            }
-        });
-    }
-
-    /**
-     *
-     * @param {EntityComponentDataset} ecd
-     * @returns {{component:(Camera|undefined), entity: number}}
-     */
-    static getFirstActiveCamera(ecd) {
-        const r = {
-            entity: -1,
-            component: undefined
-        };
-
-        this.traverseActiveCameras(ecd, (c, e) => {
-            r.entity = e;
-            r.component = c;
-        });
-
-        return r;
-    }
-
-    /**
-     *
-     * @param {EntityComponentDataset} ecd
-     * @param {function(ThreeFrustum[])} callback
-     */
-    static getActiveFrustums(ecd, callback) {
-        const frustums = [];
-
-        if (ecd !== null) {
-            ecd.traverseComponents(Camera, function (c) {
-                if (c.active.getValue()) {
-                    const camera = c.object;
-
-                    if (camera !== null) {
-                        const frustum = new ThreeFrustum();
-                        frustum_from_camera(camera, frustum);
-                        frustums.push(frustum);
-                    }
-
-                }
-            });
-        }
-
-        callback(frustums);
-    }
-}
-
-

package/src/engine/graphics/ecs/camera/auto_set_camera_clipping_planes.d.ts

@@ -1,10 +0,0 @@
-/**
- * Tighten the camera's near/far planes to the world-space depth range of all
- * BVH-backed render layers' content visible inside the camera's frustum. Falls
- * back to (clip_near, clip_far) when no layer contributes content.
- *
- * @param {Camera} c camera ECS component (its `object` is the THREE.Camera)
- * @param {RenderLayerManager} layers
- */
-export function auto_set_camera_clipping_planes(c: Camera, layers: RenderLayerManager): void;
-//# sourceMappingURL=auto_set_camera_clipping_planes.d.ts.map

package/src/engine/graphics/ecs/camera/auto_set_camera_clipping_planes.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"auto_set_camera_clipping_planes.d.ts","sourceRoot":"","sources":["../../../../../../src/engine/graphics/ecs/camera/auto_set_camera_clipping_planes.js"],"names":[],"mappings":"AA0BA;;;;;;;GAOG;AACH,6FAqEC"}

package/src/engine/graphics/ecs/camera/auto_set_camera_clipping_planes.js

@@ -1,105 +0,0 @@
-import { Frustum as ThreeFrustum } from "three";
-import { frustum3_planes_to_flat_from_three } from "../../../../core/geom/3d/frustum/frustum3_planes_to_flat_from_three.js";
-import { render_layers_compute_depth_range } from "../render_layers_compute_depth_range.js";
-import { frustum_from_camera } from "./frustum_from_camera.js";
-
-const CLIPPING_EPSILON = 0.001;
-const CLIPPING_NEAR_MIN = 0.5;
-const CLIPPING_FAR_DEFAULT = 100;
-
-const scratch_three_frustum = new ThreeFrustum();
-const scratch_frustum_planes = new Float32Array(24);
-const scratch_range = { near: 0, far: 0 };
-
-/**
- * Hysteresis prevents the clipping planes from thrashing as content moves
- * slightly. A shrink is only honored when it's at least this fraction of the
- * current near-to-far span; smaller shrinks are ignored, so an object briefly
- * crossing the frustum boundary doesn't trigger a re-projection.
- *
- * Loosenings (when content moves further away or closer) always apply
- * immediately — never delay including content.
- *
- * @type {number}
- */
-const HYSTERESIS = 0.33;
-
-/**
- * Tighten the camera's near/far planes to the world-space depth range of all
- * BVH-backed render layers' content visible inside the camera's frustum. Falls
- * back to (clip_near, clip_far) when no layer contributes content.
- *
- * @param {Camera} c camera ECS component (its `object` is the THREE.Camera)
- * @param {RenderLayerManager} layers
- */
-export function auto_set_camera_clipping_planes(c, layers) {
-    const camera = c.object;
-
-    if (camera === null) {
-        return;
-    }
-
-    // Capture the previous frame's tightened planes *before* overwriting them
-    // with the outer bounds below — the hysteresis further down compares the new
-    // range against them, so sampling after the overwrite would always measure
-    // against the full outer span and never let the planes tighten.
-    const old_near = camera.near;
-    const old_far = camera.far;
-
-    // Run visibility against the user-specified outer bounds, not the previous
-    // frame's tightened range — otherwise objects could be culled before we
-    // ever see them and the autoClip would shrink toward nothing.
-    camera.near = c.clip_near;
-    camera.far = c.clip_far;
-
-    frustum_from_camera(camera, scratch_three_frustum, true);
-    frustum3_planes_to_flat_from_three(scratch_three_frustum.planes, scratch_frustum_planes);
-
-    render_layers_compute_depth_range(
-        scratch_range,
-        layers,
-        scratch_frustum_planes,
-        camera.matrixWorld.elements
-    );
-
-    let new_near = scratch_range.near - CLIPPING_EPSILON;
-    let new_far = scratch_range.far + CLIPPING_EPSILON;
-
-    if (!isFinite(new_near) || new_near < CLIPPING_NEAR_MIN) {
-        new_near = CLIPPING_NEAR_MIN;
-    }
-    if (!isFinite(new_far) || new_far <= new_near) {
-        new_far = Math.max(new_near + CLIPPING_EPSILON, CLIPPING_FAR_DEFAULT);
-    }
-
-    // Clamp inside the user-specified outer bounds so the tightened range
-    // never expands past what the camera is configured to render.
-    if (new_near < c.clip_near) {
-        new_near = c.clip_near;
-    }
-    if (new_far > c.clip_far) {
-        new_far = c.clip_far;
-    }
-
-    // Hysteresis: only shrink each plane if the shrink is meaningful relative
-    // to the current span. Loosening always applies immediately.
-    const old_span = old_far - old_near;
-    const shrink_threshold = HYSTERESIS * old_span;
-
-    if (new_near > old_near && new_near - old_near < shrink_threshold) {
-        new_near = old_near;
-    }
-    if (new_far < old_far && old_far - new_far < shrink_threshold) {
-        new_far = old_far;
-    }
-
-    camera.near = new_near;
-    camera.far = new_far;
-
-    // Rebuild the projection matrix from the tightened range — CameraView
-    // reads camera.projectionMatrix directly when capturing the frame's
-    // frustum, and the wide-range matrix from the depth-query step above is
-    // now stale.
-    camera.updateProjectionMatrix();
-}
-

package/src/engine/graphics/ecs/camera/build_three_camera_object.d.ts

@@ -1,7 +0,0 @@
-/**
- *
- * @param {Camera} component
- * @returns {THREE.PerspectiveCamera| THREE.OrthographicCamera}
- */
-export function build_three_camera_object(component: Camera): THREE.PerspectiveCamera | THREE.OrthographicCamera;
-//# sourceMappingURL=build_three_camera_object.d.ts.map

package/src/engine/graphics/ecs/camera/build_three_camera_object.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"build_three_camera_object.d.ts","sourceRoot":"","sources":["../../../../../../src/engine/graphics/ecs/camera/build_three_camera_object.js"],"names":[],"mappings":"AAGA;;;;GAIG;AACH,8DAFa,MAAM,iBAAiB,GAAE,MAAM,kBAAkB,CAsB7D"}

package/src/engine/graphics/ecs/camera/build_three_camera_object.js

@@ -1,29 +0,0 @@
-import { OrthographicCamera as ThreeOrthographicCamera, PerspectiveCamera as ThreePerspectiveCamera } from "three";
-import { ProjectionType } from "./ProjectionType.js";
-
-/**
- *
- * @param {Camera} component
- * @returns {THREE.PerspectiveCamera| THREE.OrthographicCamera}
- */
-export function build_three_camera_object(component) {
-
-    let result;
-    switch (component.projectionType.getValue()) {
-        default:
-            console.error(`Unsupported camera projection type "${component.projectionType.getValue()}", defaulting to perspective projection`);
-        //fallthrough
-        case ProjectionType.Perspective:
-            result = new ThreePerspectiveCamera(component.fov.getValue(), 1, 1, 50);
-            break;
-        case ProjectionType.Orthographic:
-            result = new ThreeOrthographicCamera(-10, 10, 20, -20, 1, 1);
-            break;
-    }
-
-
-    result.far = component.clip_far;
-    result.near = component.clip_near;
-
-    return result;
-}

package/src/engine/graphics/ecs/camera/frustum_from_camera.d.ts

@@ -1,8 +0,0 @@
-/**
- *
- * @param {Camera|ThreePerspectiveCamera} camera Three.js camera object
- * @param {Frustum|THREE.Frustum|ThreeFrustum} result Three.js frustum object
- * @param update_projection
- */
-export function frustum_from_camera(camera: Camera | ThreePerspectiveCamera, result: Frustum | THREE.Frustum | ThreeFrustum, update_projection?: boolean): void;
-//# sourceMappingURL=frustum_from_camera.d.ts.map

package/src/engine/graphics/ecs/camera/frustum_from_camera.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"frustum_from_camera.d.ts","sourceRoot":"","sources":["../../../../../../src/engine/graphics/ecs/camera/frustum_from_camera.js"],"names":[],"mappings":"AAIA;;;;;GAKG;AACH,4CAJW,+BAA6B,UAC7B,UAAQ,MAAM,OAAO,eAAa,qCAY5C"}

package/src/engine/graphics/ecs/camera/frustum_from_camera.js

@@ -1,20 +0,0 @@
-import { Matrix4 } from "three";
-
-const matrix4 = new Matrix4();
-
-/**
- *
- * @param {Camera|ThreePerspectiveCamera} camera Three.js camera object
- * @param {Frustum|THREE.Frustum|ThreeFrustum} result Three.js frustum object
- * @param update_projection
- */
-export function frustum_from_camera(camera, result, update_projection = true) {
-    if (update_projection) {
-        camera.updateProjectionMatrix();
-    }
-
-    // construct view projection matrix
-    matrix4.multiplyMatrices(camera.projectionMatrix, camera.matrixWorldInverse);
-
-    result.setFromProjectionMatrix(matrix4);
-}

package/src/engine/graphics/ecs/camera/set_camera_aspect_ratio.d.ts

@@ -1,9 +0,0 @@
-/**
- *
- * @param {Camera} camera
- * @param {number} width
- * @param {number} height
- */
-export function set_camera_aspect_ratio(camera: Camera, width: number, height: number): void;
-import { Camera } from "./Camera.js";
-//# sourceMappingURL=set_camera_aspect_ratio.d.ts.map

package/src/engine/graphics/ecs/camera/set_camera_aspect_ratio.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"set_camera_aspect_ratio.d.ts","sourceRoot":"","sources":["../../../../../../src/engine/graphics/ecs/camera/set_camera_aspect_ratio.js"],"names":[],"mappings":"AAEA;;;;;GAKG;AACH,gDAJW,MAAM,SACN,MAAM,UACN,MAAM,QAuChB;uBA7CsB,aAAa"}

package/src/engine/graphics/ecs/camera/set_camera_aspect_ratio.js

@@ -1,46 +0,0 @@
-import { Camera } from "./Camera.js";
-
-/**
- *
- * @param {Camera} camera
- * @param {number} width
- * @param {number} height
- */
-export function set_camera_aspect_ratio(camera, width, height) {
-    const c = camera.object;
-
-    if (c === null) {
-        return;
-    }
-
-    const aspect = width / height;
-
-    switch (camera.projectionType.getValue()) {
-        case Camera.ProjectionType.Perspective:
-            c.aspect = aspect;
-            break;
-        case Camera.ProjectionType.Orthographic:
-            //use smaller values to get a bit of a "zoom" on the world
-            const w = c.right - c.left;
-            const h = c.top - c.bottom;
-
-            const existingAspect = w / h;
-
-            const aspectDelta = aspect - existingAspect;
-
-            if (aspectDelta > 0) {
-                const d = h * aspectDelta;
-                c.left -= d / 2;
-                c.right += d / 2;
-            } else if (aspectDelta < 0) {
-                const d = -h * aspectDelta;
-
-                c.top += d / 2;
-                c.bottom -= d / 2;
-            }
-
-            break;
-    }
-
-    c.updateProjectionMatrix();
-}

package/src/engine/graphics/ecs/camera/unprojectPoint.d.ts

@@ -1,9 +0,0 @@
-/**
- *
- * @param {Vector3} result
- * @param {Vector3} input
- * @param {number[]} projection_matrix_inverse inverse of projection matrix
- * @param {number[]} world_matrix world transform
- */
-export function unprojectPoint(result: Vector3, input: Vector3, projection_matrix_inverse: number[], world_matrix: number[]): void;
-//# sourceMappingURL=unprojectPoint.d.ts.map

package/src/engine/graphics/ecs/camera/unprojectPoint.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"unprojectPoint.d.ts","sourceRoot":"","sources":["../../../../../../src/engine/graphics/ecs/camera/unprojectPoint.js"],"names":[],"mappings":"AAEA;;;;;;GAMG;AACH,2FAHW,MAAM,EAAE,gBACR,MAAM,EAAE,QAMlB"}

package/src/engine/graphics/ecs/camera/unprojectPoint.js

@@ -1,14 +0,0 @@
-//
-
-/**
- *
- * @param {Vector3} result
- * @param {Vector3} input
- * @param {number[]} projection_matrix_inverse inverse of projection matrix
- * @param {number[]} world_matrix world transform
- */
-export function unprojectPoint(result, input, projection_matrix_inverse, world_matrix) {
-    result.copy(input);
-    result.applyMatrix4(projection_matrix_inverse);
-    result.applyMatrix4(world_matrix);
-}

package/src/engine/graphics/ecs/camera/update_camera_transform.d.ts

@@ -1,6 +0,0 @@
-/**
- *
- * @param {Camera} camera
- */
-export function update_camera_transform(camera: Camera): void;
-//# sourceMappingURL=update_camera_transform.d.ts.map

package/src/engine/graphics/ecs/camera/update_camera_transform.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"update_camera_transform.d.ts","sourceRoot":"","sources":["../../../../../../src/engine/graphics/ecs/camera/update_camera_transform.js"],"names":[],"mappings":"AAEA;;;GAGG;AACH,8DAUC"}

package/src/engine/graphics/ecs/camera/update_camera_transform.js

@@ -1,17 +0,0 @@
-import { threeUpdateTransform } from "../../util/threeUpdateTransform.js";
-
-/**
- *
- * @param {Camera} camera
- */
-export function update_camera_transform(camera) {
-
-    const three_camera = camera.object;
-
-    if (three_camera === null) {
-        return;
-    }
-
-    three_camera.updateProjectionMatrix();
-    threeUpdateTransform(three_camera);
-}