@woosh/meep-engine 3.14.6 → 3.16.0

package/src/engine/graphics3/Trail3DSystem.d.ts

@@ -26,7 +26,7 @@ export class Trail3DSystem extends System<any> {
      * @param {GraphicsEngine} graphics
      */
     constructor(graphics: GraphicsEngine);
-    dependencies: (typeof Transform | typeof Trail3D)[];
+    dependencies: (typeof Transform64 | typeof Trail3D)[];
     /**
      * What the pass draws. Read-only — the meshes follow the entities.
      *
@@ -37,16 +37,16 @@ export class Trail3DSystem extends System<any> {
     shutdown(entityManager: any): Promise<void>;
     /**
      * @param {Trail3D} trail
-     * @param {Transform} transform
+     * @param {Transform64} transform
      * @param {number} entity
      */
-    link(trail: Trail3D, transform: Transform, entity: number): void;
+    link(trail: Trail3D, transform: Transform64, entity: number): void;
     /**
      * @param {Trail3D} trail
-     * @param {Transform} transform
+     * @param {Transform64} transform
      * @param {number} entity
      */
-    unlink(trail: Trail3D, transform: Transform, entity: number): void;
+    unlink(trail: Trail3D, transform: Transform64, entity: number): void;
     update(timeDelta: any): void;
     /**
      * @param {FrameContext} frame
@@ -66,7 +66,7 @@ export class TrailExtension extends RenderExtension {
     #private;
 }
 import { System } from "../ecs/System.js";
-import { Transform } from "../ecs/transform/Transform.js";
+import { Transform64 } from "../ecs/transform/Transform64.js";
 import Trail3D from "../graphics/ecs/trail3d/Trail3D.js";
 import { DynamicMeshBatch } from "../../shade/renderer/scene/DynamicMeshBatch.js";
 import { RenderExtension } from "../../shade/renderer/extension/RenderExtension.js";

package/src/engine/graphics3/Trail3DSystem.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Trail3DSystem.d.ts","sourceRoot":"","sources":["../../../../src/engine/graphics3/Trail3DSystem.js"],"names":[],"mappings":"AAoBA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH;IA0CI;;OAEG;IACH,sCAMC;IAlDD,oDAAoC;IAgCpC;;;;OAIG;IACH,8BAEC;IAaD,2CAIC;IAED,4CAWC;IAED;;;;OAIG;IACH,YAJW,OAAO,aACP,SAAS,UACT,MAAM,QAkBhB;IAED;;;;OAIG;IACH,cAJW,OAAO,aACP,SAAS,UACT,MAAM,QAiBhB;IAED,6BAYC;IAED;;OAEG;IACH,kCAeC;;CACJ;AAED;;GAEG;AACH;IAUI;;OAEG;IACH,oBAFW,aAAa,EAMvB;IAED,yBAEC;;CACJ;uBAnNsB,kBAAkB;0BACf,+BAA+B;oBAGrC,oCAAoC;iCALvB,gDAAgD;gCAJjD,mDAAmD"}
+{"version":3,"file":"Trail3DSystem.d.ts","sourceRoot":"","sources":["../../../../src/engine/graphics3/Trail3DSystem.js"],"names":[],"mappings":"AAoBA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH;IA0CI;;OAEG;IACH,sCAMC;IAlDD,sDAAsC;IAgCtC;;;;OAIG;IACH,8BAEC;IAaD,2CAIC;IAED,4CAWC;IAED;;;;OAIG;IACH,YAJW,OAAO,aACP,WAAW,UACX,MAAM,QAkBhB;IAED;;;;OAIG;IACH,cAJW,OAAO,aACP,WAAW,UACX,MAAM,QAiBhB;IAED,6BAYC;IAED;;OAEG;IACH,kCAeC;;CACJ;AAED;;GAEG;AACH;IAUI;;OAEG;IACH,oBAFW,aAAa,EAMvB;IAED,yBAEC;;CACJ;uBAnNsB,kBAAkB;4BACb,iCAAiC;oBAGzC,oCAAoC;iCALvB,gDAAgD;gCAJjD,mDAAmD"}

package/src/engine/graphics3/Trail3DSystem.js

@@ -1,221 +1,221 @@
-import { assert } from "../../core/assert.js";
-import { GPUDynamicMeshRenderer } from "../../shade/renderer/dynamic/GPUDynamicMeshRenderer.js";
-import { Geometry } from "../../shade/renderer/geometry/Geometry.js";
-import { FramePhase } from "../../shade/renderer/extension/FramePhase.js";
-import { RenderExtension } from "../../shade/renderer/extension/RenderExtension.js";
-import { SceneColor } from "../../shade/renderer/extension/SceneColor.js";
-import { ViewTextures } from "../../shade/renderer/extension/ViewTextures.js";
-import { DynamicMesh } from "../../shade/renderer/scene/DynamicMesh.js";
-import { DynamicMeshBatch } from "../../shade/renderer/scene/DynamicMeshBatch.js";
-import { System } from "../ecs/System.js";
-import { Transform } from "../ecs/transform/Transform.js";
-import { advance_trail } from "../graphics/ecs/trail3d/advance_trail.js";
-import { seed_trail_tube } from "../graphics/ecs/trail3d/seed_trail_tube.js";
-import Trail3D from "../graphics/ecs/trail3d/Trail3D.js";
-import { Trail3DFlags } from "../graphics/ecs/trail3d/Trail3DFlags.js";
-import {
-    TubeXFixedPhysicsSimulator
-} from "../graphics/trail/tube/simulator/TubeXFixedPhysicsSimulator.js";
-import { trail_tube_write_geometry } from "./trail/trail_tube_write_geometry.js";
-
-/**
- * Draws {@link Trail3D}'s tubes under Shade, on the dynamic-geometry path.
- *
- * **A trail is dynamic content by definition** — every knot of it is rewritten as the entity moves
- * and every knot's opacity as it ages — so it goes down S4's dedicated non-meshlet path (D5/I-10),
- * the same one particles, paths and debug shapes take.
- *
- * **The simulation is not this system's, and that is deliberate.** {@link seed_trail_tube} and
- * {@link advance_trail} are what the legacy `Trail3DSystem` runs too: the knots a trail lays down
- * are a property of the trail, not of the renderer drawing it, and two implementations of them
- * would be two trails that age differently. What is this system's is turning those knots into
- * vertices, once a frame, per trail.
- *
- * **Every trail is rewritten every frame it exists**, moving or not, because the simulator ages
- * every knot on every tick and the age is what the vertex opacity carries. There is no quiet trail
- * — a trail that has stopped is a trail fading out.
- *
- * **What the tube material had and this does not**: a texture, and per-trail depth writing. The
- * dynamic path has one pipeline, one vertex layout — position and colour — and one blend mode
- * (straight alpha over the finished scene, depth tested, never written), which is what a trail
- * wants and what the game's trails are authored as. `Trail3D.textureURL` therefore draws untinted
- * here; nothing in the game's own effects sets it to anything a flat colour does not carry.
- */
-export class Trail3DSystem extends System {
-    dependencies = [Trail3D, Transform];
-
-    /**
-     * @type {GraphicsEngine}
-     */
-    #graphics;
-
-    /**
-     * @type {GPUDynamicMeshRenderer}
-     */
-    #renderer = new GPUDynamicMeshRenderer();
-
-    /**
-     * @type {DynamicMeshBatch}
-     */
-    #batch = new DynamicMeshBatch();
-
-    /**
-     * @type {Map<number, {trail: Trail3D, transform: Transform, mesh: DynamicMesh}>}
-     */
-    #entries = new Map();
-
-    /**
-     * @type {TubeXFixedPhysicsSimulator}
-     */
-    #simulator = new TubeXFixedPhysicsSimulator();
-
-    /**
-     * @type {RenderExtension|null}
-     */
-    #extension = null;
-
-    /**
-     * What the pass draws. Read-only — the meshes follow the entities.
-     *
-     * @returns {DynamicMeshBatch}
-     */
-    get batch() {
-        return this.#batch;
-    }
-
-    /**
-     * @param {GraphicsEngine} graphics
-     */
-    constructor(graphics) {
-        super();
-
-        assert.defined(graphics, 'graphics');
-
-        this.#graphics = graphics;
-    }
-
-    async startup(entityManager) {
-        this.entityManager = entityManager;
-
-        this.#extension = this.#graphics.add_extension(new TrailExtension(this));
-    }
-
-    async shutdown(entityManager) {
-        if (this.#extension !== null) {
-            this.#graphics.remove_extension(this.#extension);
-
-            this.#extension = null;
-        }
-
-        this.#renderer.destroy();
-
-        this.#batch.clear();
-        this.#entries.clear();
-    }
-
-    /**
-     * @param {Trail3D} trail
-     * @param {Transform} transform
-     * @param {number} entity
-     */
-    link(trail, transform, entity) {
-        if (!trail.getFlag(Trail3DFlags.Built)) {
-            seed_trail_tube(trail, transform);
-        }
-
-        const mesh = DynamicMesh.from(new Geometry());
-
-        // the extrusion produces world-space vertices, so what the draw applies is identity — but a
-        // node's world transform is derived and stays unset until it is asked for
-        mesh.updateMatrices();
-
-        trail_tube_write_geometry(mesh.geometry, trail.tube);
-
-        this.#batch.add(mesh);
-
-        this.#entries.set(entity, { trail, transform, mesh });
-    }
-
-    /**
-     * @param {Trail3D} trail
-     * @param {Transform} transform
-     * @param {number} entity
-     */
-    unlink(trail, transform, entity) {
-        const entry = this.#entries.get(entity);
-
-        if (entry === undefined) {
-            return;
-        }
-
-        this.#batch.remove(entry.mesh);
-
-        // residency deliberately survives leaving the batch, so nothing else would free it
-        this.#renderer.release(entry.mesh.geometry);
-
-        this.#entries.delete(entity);
-
-        trail.dispose();
-    }
-
-    update(timeDelta) {
-        for (const entry of this.#entries.values()) {
-            const trail = entry.trail;
-
-            advance_trail(trail, entry.transform, timeDelta, this.#simulator);
-
-            // bounds are the GPU's business on this path (§4.5), so the flag the head raises has
-            // nobody else to answer it
-            trail.clearFlag(Trail3DFlags.BoundsNeedUpdate);
-
-            trail_tube_write_geometry(entry.mesh.geometry, trail.tube);
-        }
-    }
-
-    /**
-     * @param {FrameContext} frame
-     */
-    record(frame) {
-        if (this.#batch.count === 0) {
-            // nothing to draw, and the frame's colour is left exactly as it was
-            return;
-        }
-
-        const scene = frame.get(SceneColor);
-
-        scene.color = this.#renderer.graph_draw({
-            graph: frame.graph,
-            batch: this.#batch,
-            color: scene.color,
-            depth: frame.get(ViewTextures).depth,
-            camera: frame.view.camera.buffer
-        });
-    }
-}
-
-/**
- * A trail is drawn into the scene and is concealed by the fog of war like anything else in it.
- */
-export class TrailExtension extends RenderExtension {
-    name = "trails";
-
-    phase = FramePhase.AfterTransparency;
-
-    /**
-     * @type {Trail3DSystem}
-     */
-    #system;
-
-    /**
-     * @param {Trail3DSystem} system
-     */
-    constructor(system) {
-        super();
-
-        this.#system = system;
-    }
-
-    record(frame) {
-        this.#system.record(frame);
-    }
-}
+import { assert } from "../../core/assert.js";
+import { GPUDynamicMeshRenderer } from "../../shade/renderer/dynamic/GPUDynamicMeshRenderer.js";
+import { Geometry } from "../../shade/renderer/geometry/Geometry.js";
+import { FramePhase } from "../../shade/renderer/extension/FramePhase.js";
+import { RenderExtension } from "../../shade/renderer/extension/RenderExtension.js";
+import { SceneColor } from "../../shade/renderer/extension/SceneColor.js";
+import { ViewTextures } from "../../shade/renderer/extension/ViewTextures.js";
+import { DynamicMesh } from "../../shade/renderer/scene/DynamicMesh.js";
+import { DynamicMeshBatch } from "../../shade/renderer/scene/DynamicMeshBatch.js";
+import { System } from "../ecs/System.js";
+import { Transform64 } from "../ecs/transform/Transform64.js";
+import { advance_trail } from "../graphics/ecs/trail3d/advance_trail.js";
+import { seed_trail_tube } from "../graphics/ecs/trail3d/seed_trail_tube.js";
+import Trail3D from "../graphics/ecs/trail3d/Trail3D.js";
+import { Trail3DFlags } from "../graphics/ecs/trail3d/Trail3DFlags.js";
+import {
+    TubeXFixedPhysicsSimulator
+} from "../graphics/trail/tube/simulator/TubeXFixedPhysicsSimulator.js";
+import { trail_tube_write_geometry } from "./trail/trail_tube_write_geometry.js";
+
+/**
+ * Draws {@link Trail3D}'s tubes under Shade, on the dynamic-geometry path.
+ *
+ * **A trail is dynamic content by definition** — every knot of it is rewritten as the entity moves
+ * and every knot's opacity as it ages — so it goes down S4's dedicated non-meshlet path (D5/I-10),
+ * the same one particles, paths and debug shapes take.
+ *
+ * **The simulation is not this system's, and that is deliberate.** {@link seed_trail_tube} and
+ * {@link advance_trail} are what the legacy `Trail3DSystem` runs too: the knots a trail lays down
+ * are a property of the trail, not of the renderer drawing it, and two implementations of them
+ * would be two trails that age differently. What is this system's is turning those knots into
+ * vertices, once a frame, per trail.
+ *
+ * **Every trail is rewritten every frame it exists**, moving or not, because the simulator ages
+ * every knot on every tick and the age is what the vertex opacity carries. There is no quiet trail
+ * — a trail that has stopped is a trail fading out.
+ *
+ * **What the tube material had and this does not**: a texture, and per-trail depth writing. The
+ * dynamic path has one pipeline, one vertex layout — position and colour — and one blend mode
+ * (straight alpha over the finished scene, depth tested, never written), which is what a trail
+ * wants and what the game's trails are authored as. `Trail3D.textureURL` therefore draws untinted
+ * here; nothing in the game's own effects sets it to anything a flat colour does not carry.
+ */
+export class Trail3DSystem extends System {
+    dependencies = [Trail3D, Transform64];
+
+    /**
+     * @type {GraphicsEngine}
+     */
+    #graphics;
+
+    /**
+     * @type {GPUDynamicMeshRenderer}
+     */
+    #renderer = new GPUDynamicMeshRenderer();
+
+    /**
+     * @type {DynamicMeshBatch}
+     */
+    #batch = new DynamicMeshBatch();
+
+    /**
+     * @type {Map<number, {trail: Trail3D, transform: Transform, mesh: DynamicMesh}>}
+     */
+    #entries = new Map();
+
+    /**
+     * @type {TubeXFixedPhysicsSimulator}
+     */
+    #simulator = new TubeXFixedPhysicsSimulator();
+
+    /**
+     * @type {RenderExtension|null}
+     */
+    #extension = null;
+
+    /**
+     * What the pass draws. Read-only — the meshes follow the entities.
+     *
+     * @returns {DynamicMeshBatch}
+     */
+    get batch() {
+        return this.#batch;
+    }
+
+    /**
+     * @param {GraphicsEngine} graphics
+     */
+    constructor(graphics) {
+        super();
+
+        assert.defined(graphics, 'graphics');
+
+        this.#graphics = graphics;
+    }
+
+    async startup(entityManager) {
+        this.entityManager = entityManager;
+
+        this.#extension = this.#graphics.add_extension(new TrailExtension(this));
+    }
+
+    async shutdown(entityManager) {
+        if (this.#extension !== null) {
+            this.#graphics.remove_extension(this.#extension);
+
+            this.#extension = null;
+        }
+
+        this.#renderer.destroy();
+
+        this.#batch.clear();
+        this.#entries.clear();
+    }
+
+    /**
+     * @param {Trail3D} trail
+     * @param {Transform64} transform
+     * @param {number} entity
+     */
+    link(trail, transform, entity) {
+        if (!trail.getFlag(Trail3DFlags.Built)) {
+            seed_trail_tube(trail, transform);
+        }
+
+        const mesh = DynamicMesh.from(new Geometry());
+
+        // the extrusion produces world-space vertices, so what the draw applies is identity — but a
+        // node's world transform is derived and stays unset until it is asked for
+        mesh.updateMatrices();
+
+        trail_tube_write_geometry(mesh.geometry, trail.tube);
+
+        this.#batch.add(mesh);
+
+        this.#entries.set(entity, { trail, transform, mesh });
+    }
+
+    /**
+     * @param {Trail3D} trail
+     * @param {Transform64} transform
+     * @param {number} entity
+     */
+    unlink(trail, transform, entity) {
+        const entry = this.#entries.get(entity);
+
+        if (entry === undefined) {
+            return;
+        }
+
+        this.#batch.remove(entry.mesh);
+
+        // residency deliberately survives leaving the batch, so nothing else would free it
+        this.#renderer.release(entry.mesh.geometry);
+
+        this.#entries.delete(entity);
+
+        trail.dispose();
+    }
+
+    update(timeDelta) {
+        for (const entry of this.#entries.values()) {
+            const trail = entry.trail;
+
+            advance_trail(trail, entry.transform, timeDelta, this.#simulator);
+
+            // bounds are the GPU's business on this path (§4.5), so the flag the head raises has
+            // nobody else to answer it
+            trail.clearFlag(Trail3DFlags.BoundsNeedUpdate);
+
+            trail_tube_write_geometry(entry.mesh.geometry, trail.tube);
+        }
+    }
+
+    /**
+     * @param {FrameContext} frame
+     */
+    record(frame) {
+        if (this.#batch.count === 0) {
+            // nothing to draw, and the frame's colour is left exactly as it was
+            return;
+        }
+
+        const scene = frame.get(SceneColor);
+
+        scene.color = this.#renderer.graph_draw({
+            graph: frame.graph,
+            batch: this.#batch,
+            color: scene.color,
+            depth: frame.get(ViewTextures).depth,
+            camera: frame.view.camera.buffer
+        });
+    }
+}
+
+/**
+ * A trail is drawn into the scene and is concealed by the fog of war like anything else in it.
+ */
+export class TrailExtension extends RenderExtension {
+    name = "trails";
+
+    phase = FramePhase.AfterTransparency;
+
+    /**
+     * @type {Trail3DSystem}
+     */
+    #system;
+
+    /**
+     * @param {Trail3DSystem} system
+     */
+    constructor(system) {
+        super();
+
+        this.#system = system;
+    }
+
+    record(frame) {
+        this.#system.record(frame);
+    }
+}

package/src/engine/graphics3/camera_sync_from_transform.d.ts

@@ -15,7 +15,7 @@
  * The camera's matrices are refreshed, so what is read afterwards is this pose and not the last.
  *
  * @param {Camera} camera
- * @param {Transform} transform
+ * @param {Transform64} transform
  */
-export function camera_sync_from_transform(camera: Camera, transform: Transform): void;
+export function camera_sync_from_transform(camera: Camera, transform: Transform64): void;
 //# sourceMappingURL=camera_sync_from_transform.d.ts.map

package/src/engine/graphics3/camera_sync_from_transform.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"camera_sync_from_transform.d.ts","sourceRoot":"","sources":["../../../../src/engine/graphics3/camera_sync_from_transform.js"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;GAkBG;AACH,uFAOC"}
+{"version":3,"file":"camera_sync_from_transform.d.ts","sourceRoot":"","sources":["../../../../src/engine/graphics3/camera_sync_from_transform.js"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;GAkBG;AACH,yFAQC"}

package/src/engine/graphics3/camera_sync_from_transform.js

@@ -17,12 +17,13 @@ import { assert } from "../../core/assert.js";
  * The camera's matrices are refreshed, so what is read afterwards is this pose and not the last.
  *
  * @param {Camera} camera
- * @param {Transform} transform
+ * @param {Transform64} transform
  */
 export function camera_sync_from_transform(camera, transform) {
     assert.defined(camera, 'camera');
     assert.defined(transform, 'transform');
 
+    // both sides are Transform64 now, so this is one buffer copy
     camera.transform.copy(transform);
 
     camera.update();

package/src/engine/graphics3/debug/gizmo_view_from_camera.js

@@ -23,11 +23,11 @@ export function gizmo_view_from_camera(view, camera, viewport_height, line_width
     assert.isNumber(viewport_height, 'viewport_height');
     assert.isNumber(line_width, 'line_width');
 
-    const position = camera.transform.position;
+    const position = camera.transform;
 
-    view.eye[0] = position.x;
-    view.eye[1] = position.y;
-    view.eye[2] = position.z;
+    view.eye[0] = position.translation_x;
+    view.eye[1] = position.translation_y;
+    view.eye[2] = position.translation_z;
 
     /*
      The third row of the view matrix is the direction view depth grows *away* from, whichever way

package/src/engine/graphics3/particles/GPUParticularRenderer.d.ts

@@ -19,6 +19,12 @@ export class GPUParticularRenderer {
      * @returns {number}
      */
     get count(): number;
+    /**
+     * How many layer records the last pack wrote — the occupied rows of the emitter table.
+     *
+     * @returns {number}
+     */
+    get record_count(): number;
     /**
      * Record the billboard draw into `graph`, over the colour it is given.
      *

package/src/engine/graphics3/particles/GPUParticularRenderer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"GPUParticularRenderer.d.ts","sourceRoot":"","sources":["../../../../../src/engine/graphics3/particles/GPUParticularRenderer.js"],"names":[],"mappings":"AAkCA;;;;;;;;;;;;;GAaG;AACH;IAsGI;;;;OAIG;IACH,oBAEC;IAqSD;;;;;;;;;;;;;;OAcG;IACH;QAX4B,KAAK;QACT,KAAK,EAAlB,MAAM;QACO,KAAK,EAAlB,MAAM;QACyB,MAAM,EAArC,0BAAwB;QACA,QAAQ,EAAhC,iBAAiB;QACD,KAAK;QACO,eAAe,EAA3C,MAAM,EAAE,GAAC,YAAY;QACO,YAAY,EAAxC,MAAM,EAAE,GAAC,YAAY;QACO,SAAS,EAArC,MAAM,EAAE,GAAC,YAAY;QACnB,MAAM,CAiBlB;IAqFD;;;OAGG;IACH,gBA2BC;;CACJ"}
+{"version":3,"file":"GPUParticularRenderer.d.ts","sourceRoot":"","sources":["../../../../../src/engine/graphics3/particles/GPUParticularRenderer.js"],"names":[],"mappings":"AAuCA;;;;;;;;;;;;;GAaG;AACH;IAwGI;;;;OAIG;IACH,oBAEC;IAED;;;;OAIG;IACH,2BAEC;IAkTD;;;;;;;;;;;;;;OAcG;IACH;QAX4B,KAAK;QACT,KAAK,EAAlB,MAAM;QACO,KAAK,EAAlB,MAAM;QACyB,MAAM,EAArC,0BAAwB;QACA,QAAQ,EAAhC,iBAAiB;QACD,KAAK;QACO,eAAe,EAA3C,MAAM,EAAE,GAAC,YAAY;QACO,YAAY,EAAxC,MAAM,EAAE,GAAC,YAAY;QACO,SAAS,EAArC,MAAM,EAAE,GAAC,YAAY;QACnB,MAAM,CAiBlB;IAqFD;;;OAGG;IACH,gBA2BC;;CACJ"}