@woosh/meep-engine 3.23.0 → 3.25.0

package/src/shade/renderer/scene/InstanceBatch.js

@@ -1,235 +0,0 @@
-import { assert } from "../../../core/assert.js";
-import { array_remove_first } from "../../../core/collection/array/array_remove_first.js";
-import { isArrayEqualStrict } from "../../../core/collection/array/isArrayEqualStrict.js";
-import { AABB3 } from "../../../core/geom/3d/aabb/AABB3.js";
-
-/**
- * @typedef {import("../material/ShadeMaterial.js").ShadeMaterial} ShadeMaterial
- * @typedef {import("./Mesh.js").Mesh} Mesh
- * @typedef {import("./Node3D.js").Node3D} Node3D
- */
-
-/**
- * The renderable side of a {@link Scene} — every {@link Node3D} that the
- * GPU's `transforms` table needs a row for, plus the cached mesh-only
- * filter rendering iterates.
- *
- * Storage is a flat `Node3D[]`. Anything `Mesh`-shaped feeds the
- * {@link instances} view (the renderable subset); everything else (anchor
- * rigs, attachment points, future skeleton joints) still earns a row in
- * the GPU scene-graph because the propagation pass needs to walk the
- * whole hierarchy regardless of which nodes happen to carry geometry.
- *
- * Lights live in {@link Scene.lights}, separately, and are not added
- * here — they have their own GPU pipeline that doesn't share the
- * `transforms` table.
- */
-export class InstanceBatch {
-    /**
-     * Every node ever added — meshes and non-mesh Node3Ds alike. Ordered
-     * by insertion. Consumers that only need geometry-bearing instances
-     * should go through {@link instances} instead, which caches a Mesh-
-     * only filter of this list.
-     *
-     * @type {Node3D[]}
-     */
-    #nodes = [];
-
-    /**
-     *
-     * @type {number}
-     */
-    #version = 0;
-
-    /**
-     * Cached mesh-only view of {@link #nodes}, refreshed lazily on read
-     * whenever {@link #version} drifts.
-     *
-     * @type {Mesh[]}
-     */
-    #cached_instances = [];
-
-    /**
-     * @type {number}
-     */
-    #cached_instances_version = -1;
-
-    /**
-     *
-     * @type {ShadeMaterial[]}
-     */
-    #cached_materials = [];
-
-    /**
-     * @type {number}
-     */
-    #cached_materials_version = -1;
-
-    /**
-     * Set of all materials used in this scene.
-     * Primarily useful for rendering.
-     * @type {ShadeMaterial[]}
-     */
-    get materials() {
-        if (this.#cached_materials_version !== this.#version) {
-            const set = new Set();
-
-            const meshes = this.instances;
-            for (let i = 0; i < meshes.length; i++) {
-                set.add(meshes[i].material);
-            }
-
-            this.#cached_materials_version = this.#version;
-            this.#cached_materials = Array.from(set);
-        }
-
-        return this.#cached_materials;
-    }
-
-    /**
-     *
-     * @param {boolean} v
-     */
-    set needsUpdate(v) {
-        assert.isBoolean(v, 'v');
-
-        if (v) {
-            this.#version++;
-        }
-    }
-
-    /**
-     *
-     * @return {number}
-     */
-    get version() {
-        return this.#version;
-    }
-
-    /**
-     * The mesh-only subset of {@link nodes} — what the rasterization
-     * pipeline iterates. Cached so repeated calls within the same
-     * version are O(1).
-     *
-     * @returns {Mesh[]}
-     */
-    get instances() {
-        if (this.#cached_instances_version !== this.#version) {
-            const out = [];
-            const all = this.#nodes;
-            const n = all.length;
-            for (let i = 0; i < n; i++) {
-                const node = all[i];
-                if (node.isMesh === true) {
-                    out.push(node);
-                }
-            }
-            this.#cached_instances = out;
-            this.#cached_instances_version = this.#version;
-        }
-        return this.#cached_instances;
-    }
-
-    /**
-     * Every node in the batch — the input the GPU scene-graph propagation
-     * pass iterates. Order is insertion order; {@link instances} is
-     * a stable subset.
-     *
-     * @returns {Node3D[]}
-     */
-    get nodes() {
-        return this.#nodes;
-    }
-
-
-    /**
-     * Add a node. Accepts any {@link Node3D} — meshes, anchors, future
-     * skeleton joints. Meshes will additionally appear in
-     * {@link instances} (cached).
-     *
-     * @param {Node3D} node
-     */
-    add(node) {
-        assert.defined(node, 'node');
-        assert.equal(node.isNode3D, true, 'node.isNode3D !== true');
-
-        this.#nodes.push(node);
-
-        this.#version++;
-    }
-
-    /**
-     *
-     * @return {AABB3}
-     */
-    get bounding_box() {
-        const result = new AABB3();
-        result.setNegativelyInfiniteBounds();
-
-        const meshes = this.instances;
-        const n = meshes.length;
-        for (let i = 0; i < n; i++) {
-
-            const box = new AABB3(...meshes[i].bounding_box);
-
-            if (box.width === 0 && box.height === 0 && box.depth === 0) {
-                // ignore 0-size elements as they do not contribute visually
-                continue;
-            }
-
-            result.expandToFit(box);
-
-        }
-
-        return result;
-    }
-
-    /**
-     *
-     * @returns {number}
-     */
-    computeTriangleCount() {
-        let result = 0;
-
-        const meshes = this.instances;
-        const count = meshes.length;
-        for (let i = 0; i < count; i++) {
-            const mesh = meshes[i];
-
-            result += mesh.geometry.getIndexCount() / 3;
-        }
-
-        return result;
-    }
-
-    /**
-     * Remove a node (mesh or otherwise). Returns true if the node was
-     * found and dropped.
-     *
-     * @param {Node3D} node
-     * @returns {boolean}
-     */
-    remove(node) {
-
-        const removed = array_remove_first(this.#nodes, node);
-
-        if (removed) {
-            this.#version++;
-        }
-
-        return removed;
-    }
-
-    hash() {
-        return 0;
-    }
-
-    /**
-     *
-     * @param {InstanceBatch} other
-     */
-    equals(other) {
-        return isArrayEqualStrict(this.#nodes, other.#nodes);
-    }
-
-}

package/src/shade/renderer/scene/Mesh.d.ts

@@ -1,55 +0,0 @@
-/**
- * @typedef {import("../geometry/MeshletGeometry.js").MeshletGeometry} MeshletGeometry
- * @typedef {import("../material/ShadeMaterial.js").ShadeMaterial} ShadeMaterial
- */
-export class Mesh extends Node3D {
-    /**
-     *
-     * @param {MeshletGeometry} geometry
-     * @param {ShadeMaterial} material
-     * @param {number[]|Float32Array|Float64Array} [transform] 4x4 affine matrix, column-major
-     * @return {Mesh}
-     */
-    static from(geometry: MeshletGeometry, material: ShadeMaterial, transform?: number[] | Float32Array | Float64Array): Mesh;
-    /**
-     * @type {MeshletGeometry}
-     */
-    geometry: MeshletGeometry;
-    /**
-     * @type {ShadeMaterial}
-     */
-    material: ShadeMaterial;
-    /**
-     * World-space AABB
-     * @type {Float32Array}
-     */
-    bounding_box: Float32Array;
-    /**
-     *
-     * @type {Float32Array}
-     */
-    bounding_sphere: Float32Array;
-    /**
-     *
-     * @returns {Mesh}
-     */
-    clone(): Mesh;
-    /**
-     *
-     * @param {Mesh} other
-     */
-    copy(other: Mesh): void;
-    /**
-     *
-     * @param {Mesh} other
-     * @returns {boolean}
-     */
-    equals(other: Mesh): boolean;
-    updateBoundsBasic(): void;
-    updateBoundsTight(): void;
-    isMesh: boolean;
-}
-export type MeshletGeometry = import("../geometry/MeshletGeometry.js").MeshletGeometry;
-export type ShadeMaterial = import("../material/ShadeMaterial.js").ShadeMaterial;
-import { Node3D } from "./Node3D.js";
-//# sourceMappingURL=Mesh.d.ts.map

package/src/shade/renderer/scene/Mesh.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"Mesh.d.ts","sourceRoot":"","sources":["../../../../../src/shade/renderer/scene/Mesh.js"],"names":[],"mappings":"AAUA;;;GAGG;AAEH;IA2HI;;;;;;OAMG;IACH,sBALW,eAAe,YACf,aAAa,cACb,MAAM,EAAE,GAAC,YAAY,GAAC,YAAY,GACjC,IAAI,CAoBf;IAnJD;;OAEG;IACH,UAFU,eAAe,CAEhB;IAET;;OAEG;IACH,UAFU,aAAa,CAEd;IAET;;;OAGG;IACH,cAFU,YAAY,CAEa;IAEnC;;;OAGG;IACH,iBAFU,YAAY,CAEgB;IAEtC;;;OAGG;IACH,SAFa,IAAI,CAQhB;IAED;;;OAGG;IACH,YAFW,IAAI,QAiBd;IAED;;;;OAIG;IACH,cAHW,IAAI,GACF,OAAO,CAQnB;IAQD,0BAOC;IAED,0BAqCC;IA+BL,gBAAqB;CAHpB;8BAzJY,OAAO,gCAAgC,EAAE,eAAe;4BACxD,OAAO,8BAA8B,EAAE,aAAa;uBAJ1C,aAAa"}

package/src/shade/renderer/scene/Mesh.js

@@ -1,168 +0,0 @@
-import { assert } from "../../../core/assert.js";
-import { AABB3 } from "../../../core/geom/3d/aabb/AABB3.js";
-import { aabb3_from_v3_array_transformed } from "../../../core/geom/3d/aabb/aabb3_from_v3_array_transformed.js";
-import { aabb3_matrix4_project } from "../../../core/geom/3d/aabb/aabb3_matrix4_project.js";
-import { sphere_matrix4_transform } from "../../../core/geom/3d/sphere/sphere_matrix4_transform.js";
-import { epsilonEquals } from "../../../core/math/epsilonEquals.js";
-import { optional_equality } from "../../../core/model/object/optional_equality.js";
-import { StandardAttributes } from "../geometry/StandardAttributes.js";
-import { Node3D } from "./Node3D.js";
-
-/**
- * @typedef {import("../geometry/MeshletGeometry.js").MeshletGeometry} MeshletGeometry
- * @typedef {import("../material/ShadeMaterial.js").ShadeMaterial} ShadeMaterial
- */
-
-export class Mesh extends Node3D {
-    /**
-     * @type {MeshletGeometry}
-     */
-    geometry;
-
-    /**
-     * @type {ShadeMaterial}
-     */
-    material;
-
-    /**
-     * World-space AABB
-     * @type {Float32Array}
-     */
-    bounding_box = new Float32Array(6);
-
-    /**
-     *
-     * @type {Float32Array}
-     */
-    bounding_sphere = new Float32Array(4);
-
-    /**
-     *
-     * @returns {Mesh}
-     */
-    clone() {
-        const r = new Mesh();
-
-        r.copy(this);
-
-        return r;
-    }
-
-    /**
-     *
-     * @param {Mesh} other
-     */
-    copy(other) {
-
-        if (this === other) {
-            // special case
-            return;
-        }
-
-        super.copy(other);
-
-        this.geometry = other.geometry;
-        this.material = other.material;
-        this.name = other.name;
-
-        this.bounding_box.set(other.bounding_box);
-        this.bounding_sphere.set(other.bounding_sphere);
-    }
-
-    /**
-     *
-     * @param {Mesh} other
-     * @returns {boolean}
-     */
-    equals(other) {
-        return this.name === other.name
-            && optional_equality(this.geometry, other.geometry)
-            && optional_equality(this.material, other.material)
-            && this.transform_global.equals(other.transform_global)
-            ;
-    }
-
-    updateMatrices() {
-        super.updateMatrices();
-
-        this.updateBoundsBasic();
-    }
-
-    updateBoundsBasic() {
-        // a Transform64's matrix starts at element 0, so the transform is its own mat4 argument —
-        // going through `.matrix` would allocate a view per call for nothing
-        const m = this.transform_global;
-
-        aabb3_matrix4_project(this.bounding_box, this.geometry.bounding_box, m);
-        sphere_matrix4_transform(this.bounding_sphere, this.geometry.bounding_sphere, m);
-    }
-
-    updateBoundsTight() {
-
-        const t = this.transform_global;
-
-        const unrotated = epsilonEquals(t.rotation_x, 0)
-            && epsilonEquals(t.rotation_y, 0)
-            && epsilonEquals(t.rotation_z, 0)
-            && epsilonEquals(t.rotation_w, 1);
-
-        if (unrotated) {
-            // no rotation component, can safely scale/translate geometry bounds to get tight fit
-            this.updateBoundsBasic();
-
-        } else {
-
-            throw new Error('not implemented');
-
-            const position_attribute = this.geometry.getAttribute(StandardAttributes.Position);
-            const position_array = position_attribute.data;
-
-            {
-                const bounds = new AABB3();
-
-                aabb3_from_v3_array_transformed(
-                    bounds,
-                    position_array, position_array.length,
-                    this.transform_global
-                );
-
-                bounds.writeToArray(this.bounding_box, 0);
-            }
-
-            {
-                // todo do a tight sphere bounds
-                sphere_matrix4_transform(this.bounding_sphere, this.geometry.bounding_sphere, this.transform_global);
-            }
-        }
-    }
-
-    /**
-     *
-     * @param {MeshletGeometry} geometry
-     * @param {ShadeMaterial} material
-     * @param {number[]|Float32Array|Float64Array} [transform] 4x4 affine matrix, column-major
-     * @return {Mesh}
-     */
-    static from(geometry, material, transform) {
-        assert.defined(geometry, 'geometry');
-        assert.defined(material, 'material');
-
-        assert.equal(geometry.isMeshletGeometry, true, 'geometry.isMeshletGeometry !== true');
-
-        const r = new Mesh();
-
-        r.geometry = geometry;
-        r.material = material;
-
-        if (transform !== undefined) {
-            r.transform_local.fromMatrix(transform);
-        }
-
-        r.updateMatrices();
-
-        return r;
-    }
-}
-
-
-Mesh.prototype.isMesh = true;

package/src/shade/renderer/scene/Node3D.d.ts

@@ -1,140 +0,0 @@
-/**
- * Note that hierarchy only exists on the CPU side
- * The only transform that GPU will see is the {@link transform_global}
- */
-export class Node3D {
-    /**
-     * Stable numeric id, unique across every Node3D instance (meshes,
-     * lights, scenes, anchors). Used as the key in
-     * `GPUSceneContext.id_mapping` to look up the node's row in the
-     * GPU `transforms` table — the binding survives table compaction
-     * or rebuild because it's tied to the JS object's identity, not
-     * its position in any array.
-     *
-     * @type {number}
-     * @readonly
-     */
-    readonly id: number;
-    /**
-     * Human-readable name
-     * @type {string}
-     */
-    name: string;
-    /**
-     * Bumped by {@link updateMatrices}. The renderer compares it against the version it last
-     * uploaded for this node's row, so a node that has not moved since the previous frame costs
-     * nothing beyond the comparison — that is what keeps per-frame scene upkeep proportional to
-     * what changed rather than to scene size.
-     *
-     * A caller that mutates `transform_local` without calling {@link updateMatrices} leaves
-     * `transform_global` stale, and this counter says so: both are derived, and neither is
-     * refreshed until the call is made.
-     *
-     * @returns {number}
-     */
-    get version(): number;
-    /**
-     * @param {boolean} v
-     */
-    set needsUpdate(v: boolean);
-    /**
-     * Who writes this node's TRS in the GPU `transforms` table. Declared, never inferred — see
-     * {@link TransformAuthority} for what each side owns and why guessing does not work.
-     *
-     * @type {TransformAuthority}
-     */
-    transform_authority: TransformAuthority;
-    /**
-     * World transform, **derived** — {@link updateMatrices} recomputes it from
-     * {@link transform_local} and the parent chain, so writing it directly is undone the moment
-     * anything refreshes. Place a node through its local transform.
-     *
-     * @type {Transform64}
-     */
-    transform_global: Transform64;
-    /**
-     * Local transform, and the node's own truth. Passive: setting a component does not refresh the
-     * matrix, and nothing downstream sees the change until {@link updateMatrices} runs.
-     *
-     * @type {Transform64}
-     */
-    transform_local: Transform64;
-    parent: any;
-    /**
-     *
-     * @type {Node3D[]}
-     */
-    children: Node3D[];
-    /**
-     * Orient this node so its local +Z axis points along `v`. Preserves
-     * position. A zero-length input is a no-op. Recomputes
-     * `transform_global` so the new orientation is visible immediately.
-     *
-     * @param {Vector3|number[]} v
-     */
-    set forward(v: Vector3);
-    /**
-     * Orientation vector — `(0,0,1)` rotated by the node's global transform. Freshly allocated;
-     * hold on to it rather than reading this in a loop.
-     *
-     * @return {Vector3}
-     */
-    get forward(): Vector3;
-    /**
-     * Orientation vector — `(1,0,0)` rotated by the node's global transform. Freshly allocated;
-     * hold on to it rather than reading this in a loop.
-     *
-     * @return {Vector3}
-     */
-    get right(): Vector3;
-    /**
-     * @param {Vector3|number[]} v
-     */
-    set position(v: Float64Array);
-    /**
-     * Live view over the local transform's own storage, freshly allocated on every access. Writing
-     * through it does not refresh anything — {@link updateMatrices} still has to run.
-     *
-     * @returns {Float64Array}
-     */
-    get position(): Float64Array;
-    copy(other: any): void;
-    clone(): Node3D;
-    /**
-     *
-     * @param {function(Node3D)} callback
-     * @param {*} [thisArg]
-     */
-    traverse(callback: (arg0: Node3D) => any, thisArg?: any): void;
-    /**
-     * Recompose this node's world transform and every descendant's.
-     *
-     * The local matrix is refreshed first because nothing else will: a `Transform64` does not track
-     * its own components, and {@link Transform64.multiplyTransforms} composes through matrices. Skip
-     * it and the node would be placed where it was the last time someone asked.
-     */
-    updateMatrices(): void;
-    /**
-     *
-     * @param {Node3D[]} children
-     */
-    addChildren(children: Node3D[]): void;
-    /**
-     *
-     * @param {Node3D} child
-     */
-    addChild(child: Node3D): void;
-    /**
-     * Type tag — lets `instanceof`-free callers (e.g. `InstanceBatch.add`)
-     * accept anything that conforms to the Node3D shape.
-     *
-     * @readonly
-     * @type {boolean}
-     */
-    readonly isNode3D: boolean;
-    #private;
-}
-import { TransformAuthority } from "./TransformAuthority.js";
-import { Transform64 } from "../../../engine/ecs/transform/Transform64.js";
-import Vector3 from "../../../core/geom/Vector3.js";
-//# sourceMappingURL=Node3D.d.ts.map

package/src/shade/renderer/scene/Node3D.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"Node3D.d.ts","sourceRoot":"","sources":["../../../../../src/shade/renderer/scene/Node3D.js"],"names":[],"mappings":"AAQA;;;GAGG;AACH;IAEI;;;;;;;;;;OAUG;IACH,aAHU,MAAM,CAGE;IAElB;;;OAGG;IACH,MAFU,MAAM,CAEP;IAOT;;;;;;;;;;;OAWG;IACH,sBAEC;IAED;;OAEG;IACH,4BAIC;IAED;;;;;OAKG;IACH,qBAFU,kBAAkB,CAEiB;IAE7C;;;;;;OAMG;IACH,kBAFU,WAAW,CAEgB;IAErC;;;;;OAKG;IACH,iBAFU,WAAW,CAEe;IAEpC,YAAc;IAEd;;;OAGG;IACH,UAFU,MAAM,EAAE,CAEL;IAYb;;;;;;OAMG;IACH,wBAMC;IAvBD;;;;;OAKG;IACH,uBAEC;IAiBD;;;;;OAKG;IACH,qBAEC;IAED;;OAEG;IACH,8BAEC;IAED;;;;;OAKG;IACH,6BAEC;IAED,uBAKC;IAED,gBAmBC;IAED;;;;OAIG;IACH,0BAHoB,MAAM,+BASzB;IAED;;;;;;OAMG;IACH,uBA0BC;IAED;;;OAGG;IACH,sBAFW,MAAM,EAAE,QAOlB;IAED;;;OAGG;IACH,gBAFW,MAAM,QAchB;IAIL;;;;;;OAMG;IACH,mBAFU,OAAO,CAEQ;;CATxB;mCAzPkC,yBAAyB;4BADhC,8CAA8C;oBAHtD,+BAA+B"}