@woosh/meep-engine 3.0.0 → 3.0.2

package/src/engine/graphics/ecs/animation/animator/graph/AnimationTransition.js

@@ -1,151 +1,151 @@
-import { lerp } from "../../../../../../core/math/lerp.js";
-import { BlendStateMatrix } from "../blending/BlendStateMatrix.js";
-import { clamp01 } from "../../../../../../core/math/clamp01.js";
-
-export class AnimationTransition {
-    /**
-     *
-     * @type {AnimationTransitionDefinition}
-     */
-    def = null;
-
-    /**
-     *
-     * @type {AnimationState}
-     */
-    source = null;
-
-    /**
-     *
-     * @type {AnimationState}
-     */
-    target = null;
-
-    /**
-     *
-     * @type {AnimationGraph}
-     */
-    graph = null;
-
-    /**
-     * Execution time of the transition, starts at 0 when transition is started
-     * @type {number}
-     */
-    time = 0;
-
-    /**
-     *
-     * @type {BlendStateMatrix}
-     */
-    blendState = null;
-
-    /**
-     *
-     * @param {AnimationTransition} other
-     * @returns {boolean}
-     */
-    equals(other) {
-        if (this === other) {
-            return true;
-        }
-
-        return this.def.equals(other.def);
-    }
-
-    /**
-     * @returns {number}
-     */
-    hash() {
-        return this.def.hash();
-    }
-
-    initialize() {
-
-        const graphDefinition = this.graph.def;
-
-        this.blendState = graphDefinition.createBlendState();
-
-    }
-
-    start() {
-        this.time = 0;
-    }
-
-    /**
-     *
-     * @return {number}
-     */
-    computeNormalizedTime() {
-        return this.time / this.def.duration;
-    }
-
-    /**
-     *
-     * @return {boolean}
-     */
-    isFinished() {
-        return this.time >= this.def.duration;
-    }
-
-    updateBlendsState() {
-        const t = clamp01(this.computeNormalizedTime());
-
-        BlendStateMatrix.lerp(this.blendState, this.source.blendState, this.target.blendState, t);
-    }
-
-    /**
-     *
-     * @param {number} timeDelta in seconds
-     */
-    tick(timeDelta) {
-        const normalizeTime = this.computeNormalizedTime();
-
-        const actualTimeScale = lerp(this.source.timeScale, this.target.timeScale, normalizeTime);
-
-        const actualTimeDelta = timeDelta * actualTimeScale;
-
-        this.time += actualTimeDelta;
-    }
-
-    /**
-     * Perform transition
-     */
-    transition() {
-        this.start();
-        this.updateBlendsState();
-
-
-        this.graph.transition(this);
-    }
-
-    /**
-     *
-     * @param {number} entity
-     * @param {EntityComponentDataset} ecd
-     */
-    link(entity, ecd) {
-        /**
-         *
-         * @type {AnimationTransitionDefinition}
-         */
-        const def = this.def;
-
-        ecd.addEntityEventListener(entity, def.event, this.transition, this);
-    }
-
-    /**
-     *
-     * @param {number} entity
-     * @param {EntityComponentDataset} ecd
-     */
-    unlink(entity, ecd) {
-
-        /**
-         *
-         * @type {AnimationTransitionDefinition}
-         */
-        const def = this.def;
-
-        ecd.removeEntityEventListener(entity, def.event, this.transition, this);
-    }
-}
+import { lerp } from "../../../../../../core/math/lerp.js";
+import { BlendStateMatrix } from "../blending/BlendStateMatrix.js";
+import { clamp01 } from "../../../../../../core/math/clamp01.js";
+
+export class AnimationTransition {
+    /**
+     *
+     * @type {AnimationTransitionDefinition}
+     */
+    def = null;
+
+    /**
+     *
+     * @type {AnimationState}
+     */
+    source = null;
+
+    /**
+     *
+     * @type {AnimationState}
+     */
+    target = null;
+
+    /**
+     *
+     * @type {AnimationGraphController}
+     */
+    graph = null;
+
+    /**
+     * Execution time of the transition, starts at 0 when transition is started
+     * @type {number}
+     */
+    time = 0;
+
+    /**
+     *
+     * @type {BlendStateMatrix}
+     */
+    blendState = null;
+
+    /**
+     *
+     * @param {AnimationTransition} other
+     * @returns {boolean}
+     */
+    equals(other) {
+        if (this === other) {
+            return true;
+        }
+
+        return this.def.equals(other.def);
+    }
+
+    /**
+     * @returns {number}
+     */
+    hash() {
+        return this.def.hash();
+    }
+
+    initialize() {
+
+        const graphDefinition = this.graph.def;
+
+        this.blendState = graphDefinition.createBlendState();
+
+    }
+
+    start() {
+        this.time = 0;
+    }
+
+    /**
+     *
+     * @return {number}
+     */
+    computeNormalizedTime() {
+        return this.time / this.def.duration;
+    }
+
+    /**
+     *
+     * @return {boolean}
+     */
+    isFinished() {
+        return this.time >= this.def.duration;
+    }
+
+    updateBlendsState() {
+        const t = clamp01(this.computeNormalizedTime());
+
+        BlendStateMatrix.lerp(this.blendState, this.source.blendState, this.target.blendState, t);
+    }
+
+    /**
+     *
+     * @param {number} timeDelta in seconds
+     */
+    tick(timeDelta) {
+        const normalizeTime = this.computeNormalizedTime();
+
+        const actualTimeScale = lerp(this.source.timeScale, this.target.timeScale, normalizeTime);
+
+        const actualTimeDelta = timeDelta * actualTimeScale;
+
+        this.time += actualTimeDelta;
+    }
+
+    /**
+     * Perform transition
+     */
+    transition() {
+        this.start();
+        this.updateBlendsState();
+
+
+        this.graph.transition(this);
+    }
+
+    /**
+     *
+     * @param {number} entity
+     * @param {EntityComponentDataset} ecd
+     */
+    link(entity, ecd) {
+        /**
+         *
+         * @type {AnimationTransitionDefinition}
+         */
+        const def = this.def;
+
+        ecd.addEntityEventListener(entity, def.event, this.transition, this);
+    }
+
+    /**
+     *
+     * @param {number} entity
+     * @param {EntityComponentDataset} ecd
+     */
+    unlink(entity, ecd) {
+
+        /**
+         *
+         * @type {AnimationTransitionDefinition}
+         */
+        const def = this.def;
+
+        ecd.removeEntityEventListener(entity, def.event, this.transition, this);
+    }
+}

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

@@ -3,25 +3,23 @@
  */
 export class Camera {
     /**
+     * Whether clipping planes should be automatically calculated or not.
+     *
+     * **Nothing reads this.** The pass that tightened the planes measured the depth range of the
+     * renderer's own layers, which no renderer has offered since the three path was removed; the
+     * field stays because it is on the wire and a level carries it.
      *
-     * @param {Camera|THREE.PerspectiveCamera|THREE.OrthographicCamera} camera
-     * @param {number} x
-     * @param {number} y
-     * @param {Vector3} out_source
-     * @param {Vector3} out_direction
-     */
-    static projectRay(camera: Camera | THREE.PerspectiveCamera | THREE.OrthographicCamera, x: number, y: number, out_source: Vector3, out_direction: Vector3): void;
-    /**
-     * Whether clipping planes should be automatically calculated or not
      * @type {boolean}
      */
     autoClip: boolean;
     /**
      * Tunable parameter to prevent clipping planes from thrashing. Clipping planes must move by a certain portion of the current span before frustum gets shrunken
+     *
+     * Inert for the same reason as {@link autoClip}, and kept for the same one.
+     *
      * @type {number}
      */
     autoClipHysteresis: number;
-    object: any;
     /**
      *
      * @type {Vector1}
@@ -38,29 +36,44 @@ export class Camera {
      */
     active: ObservedBoolean;
     /**
-     * Near clipping plane
+     * Far clipping plane
      * @type {number}
-     * @private
      */
-    private __clip_far;
+    clip_far: number;
     /**
-     * Far clipping plane
+     * Near clipping plane
      * @type {number}
-     * @private
      */
-    private __clip_near;
+    clip_near: number;
+    /**
+     * The planes of the frame this camera last drew — six
+     * `[normal_x, normal_y, normal_z, constant]` tuples, the layout every frustum query in the tree
+     * reads — or `null` when it has not drawn one.
+     *
+     * A method rather than a property because it is not one: the inspector draws a row for every
+     * readable property a component has, and this is an answer the renderer gave, not a field
+     * anybody authors. The planes are rewritten under the caller every tick.
+     *
+     * @returns {Float32Array|null}
+     */
+    getFrustumPlanes(): Float32Array | null;
+    /**
+     * Record the planes the frame was drawn with.
+     *
+     * The renderer's camera is what computes them, because the frustum a gameplay query wants is
+     * the one the picture was actually drawn with; deriving a second one from the field of view
+     * here would need the aspect ratio, which belongs to whatever surface the frame is going out at
+     * and not to a camera entity.
+     *
+     * @param {Float32Array|number[]} planes six `[normal_x, normal_y, normal_z, constant]` tuples
+     */
+    publishFrustum(planes: Float32Array | number[]): void;
     /**
      *
      * @param {Quaternion} output
      * @param {Quaternion} input
      */
     getReciprocalRotation(output: Quaternion, input: Quaternion): void;
-    set clip_far(arg: number);
-    get clip_far(): number;
-    set clip_near(arg: number);
-    get clip_near(): number;
-    updateMatrices(): void;
-    projectRay(x: any, y: any, source: any, target: any): void;
     /**
      *
      * @param {Camera} other
@@ -76,31 +89,7 @@ export class Camera {
         active: boolean;
     };
     fromJSON(json: any): void;
-    /**
-     *
-     * @param {Matrix4} result
-     */
-    computeProjectionMatrix(result: Matrix4): boolean;
-    /**
-     *
-     * @param {Vector3} out
-     * @param {number} origin_x
-     * @param {number} origin_y
-     * @param {number} origin_z
-     * @param {number} direction_x
-     * @param {number} direction_y
-     * @param {number} direction_z
-     * @param {number} plane_index
-     */
-    rayPlaneIntersection(out: Vector3, origin_x: number, origin_y: number, origin_z: number, direction_x: number, direction_y: number, direction_z: number, plane_index: number): void;
-    /**
-     *
-     * @param {number} x
-     * @param {number} y
-     * @param {number} z
-     * @param {Vector3} result
-     */
-    projectWorldPointOntoNearPlane(x: number, y: number, z: number, result: Vector3): void;
+    #private;
 }
 export namespace Camera {
     export let typeName: string;
@@ -108,6 +97,5 @@ export namespace Camera {
 }
 import Vector1 from "../../../../core/geom/Vector1.js";
 import ObservedBoolean from "../../../../core/model/ObservedBoolean.js";
-import Vector3 from "../../../../core/geom/Vector3.js";
 import { ProjectionType } from "./ProjectionType.js";
 //# sourceMappingURL=Camera.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"Camera.d.ts","sourceRoot":"","sources":["../../../../../../src/engine/graphics/ecs/camera/Camera.js"],"names":[],"mappings":"AAaA;;GAEG;AACH;IA8II;;;;;;;OAOG;IACH,0BANW,MAAM,GAAC,MAAM,iBAAiB,GAAC,MAAM,kBAAkB,KACvD,MAAM,KACN,MAAM,cACN,OAAO,iBACP,OAAO,QA+CjB;IAlMD;;;OAGG;IACH,UAFU,OAAO,CAEA;IAEjB;;;OAGG;IACH,oBAFU,MAAM,CAEU;IAE1B,YAAc;IAEd;;;OAGG;IACH,KAFU,OAAO,CAEK;IAEtB;;;OAGG;IACH,oBAA8E;IAE9E;;;OAGG;IACH,QAFU,eAAe,CAEU;IAEnC;;;;OAIG;IACH,mBAAiB;IAEjB;;;;OAIG;IACH,oBAAkB;IAElB;;;;OAIG;IACH,mEAEC;IAMD,0BAMC;IAVD,uBAEC;IAcD,2BAMC;IAVD,wBAEC;IAUD,uBAaC;IAED,2DAEC;IAED;;;OAGG;IACH,YAFW,MAAM,QAUhB;IAED;;;OAGG;IACH,SAFa,MAAM,CAQlB;IAED;;;MAKC;IAED,0BAQC;IAyDD;;;OAGG;IACH,kDAUC;IAED;;;;;;;;;;OAUG;IACH,0BATW,OAAO,YACP,MAAM,YACN,MAAM,YACN,MAAM,eACN,MAAM,eACN,MAAM,eACN,MAAM,eACN,MAAM,QAyBhB;IAED;;;;;;OAMG;IACH,kCALW,MAAM,KACN,MAAM,KACN,MAAM,UACN,OAAO,QAqBjB;CACJ;;;;;oBAhSmB,kCAAkC;4BAE1B,2CAA2C;oBADnD,kCAAkC;+BAIvB,qBAAqB"}
+{"version":3,"file":"Camera.d.ts","sourceRoot":"","sources":["../../../../../../src/engine/graphics/ecs/camera/Camera.js"],"names":[],"mappings":"AAMA;;GAEG;AACH;IACI;;;;;;;;OAQG;IACH,UAFU,OAAO,CAEA;IAEjB;;;;;;OAMG;IACH,oBAFU,MAAM,CAEU;IAY1B;;;OAGG;IACH,KAFU,OAAO,CAEK;IAEtB;;;OAGG;IACH,oBAA8E;IAE9E;;;OAGG;IACH,QAFU,eAAe,CAEU;IAEnC;;;OAGG;IACH,UAFU,MAAM,CAED;IAEf;;;OAGG;IACH,WAFU,MAAM,CAEA;IAEhB;;;;;;;;;;OAUG;IACH,oBAFa,YAAY,GAAC,IAAI,CAQ7B;IAED;;;;;;;;;OASG;IACH,uBAFW,YAAY,GAAC,MAAM,EAAE,QAM/B;IAED;;;;OAIG;IACH,mEAEC;IAED;;;OAGG;IACH,YAFW,MAAM,QAUhB;IAED;;;OAGG;IACH,SAFa,MAAM,CAQlB;IAED;;;MAKC;IAED,0BAQC;;CAEJ;;;;;oBA7JmB,kCAAkC;4BAC1B,2CAA2C;+BAExC,qBAAqB"}