@woosh/meep-engine 3.4.0 → 3.5.0

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

@@ -1,314 +0,0 @@
-import { min2 } from "../../../../../core/math/min2.js";
-import { ResourceAccessKind } from "../../../../../core/model/ResourceAccessKind.js";
-import { ResourceAccessSpecification } from "../../../../../core/model/ResourceAccessSpecification.js";
-import { STATIC_ASSET_CACHE } from "../../../../asset/STATIC_ASSET_CACHE.js";
-import { EntityNode } from "../../../../ecs/parent/EntityNode.js";
-import { ParentEntity } from "../../../../ecs/parent/ParentEntity.js";
-import { System } from "../../../../ecs/System.js";
-import { TransformAttachment } from "../../../../ecs/transform-attachment/TransformAttachment.js";
-import { TransformAttachmentSystem } from "../../../../ecs/transform-attachment/TransformAttachmentSystem.js";
-import { Transform } from "../../../../ecs/transform/Transform.js";
-import { assetTypeByPath } from "../../mesh/assetTypeByPath.js";
-import { ShadedGeometry } from "../ShadedGeometry.js";
-import { ShadedGeometryFlags } from "../ShadedGeometryFlags.js";
-import { three_object_to_entity_composition } from "../three_object_to_entity_composition.js";
-import { SGMesh } from "./SGMesh.js";
-import { SGMeshEvents } from "./SGMeshEvents.js";
-
-
-/**
- * @readonly
- * @type {number}
- */
-const MAX_CYCLE_COUNT = 128;
-
-/**
- * In milliseconds
- * @readonly
- * @type {number}
- */
-const MAX_CYCLE_TIME = 40;
-
-
-/**
- *
- * @param {string} url
- * @param {AssetManager} assetManager
- * @returns {Promise<THREE.Object3D>}
- */
-async function getAsset(url, assetManager) {
-
-    const assetType = assetTypeByPath(url);
-
-    const asset = await assetManager.promise(url, assetType);
-}
-
-
-export class SGMeshSystem extends System {
-    dependencies = [SGMesh, Transform];
-    components_used = [
-        ResourceAccessSpecification.from(SGMesh, ResourceAccessKind.Read | ResourceAccessKind.Write),
-        ResourceAccessSpecification.from(Transform, ResourceAccessKind.Read),
-        ResourceAccessSpecification.from(ShadedGeometry, ResourceAccessKind.Create),
-        ResourceAccessSpecification.from(TransformAttachment, ResourceAccessKind.Create),
-    ];
-
-    /**
-     *
-     * @type {number[]}
-     * @private
-     */
-    __wait_queue = [];
-
-    /**
-     *
-     * @type {number}
-     * @private
-     */
-    __wait_queue_process_index = 0;
-
-    /**
-     *
-     * @param {Engine} engine
-     */
-    constructor(engine) {
-        super();
-
-        /**
-         *
-         * @type {Engine}
-         * @private
-         */
-        this.__engine = engine;
-
-        /**
-         *
-         * @type {AssetManager}
-         * @private
-         */
-        this.__assetManager = engine.assetManager;
-    }
-
-    async startup(em) {
-
-        if (!em.hasSystem(TransformAttachmentSystem)) {
-            await em.addSystem(new TransformAttachmentSystem());
-        }
-
-    }
-
-    /**
-     *
-     * @param {number} entity
-     * @param {SGMesh} mesh
-     * @param {Transform} transform
-     */
-    async process(entity, mesh, transform) {
-        const am = this.__assetManager;
-        const ecd = this.entityManager.dataset;
-
-        const assetType = assetTypeByPath(mesh.url);
-
-        let asset;
-
-        try {
-            asset = await am.promise(mesh.url, assetType);
-        } catch (e) {
-            ecd.sendEvent(entity, SGMeshEvents.AssetLoadFailed);
-            return;
-        }
-
-        if (!ecd.entityExists(entity)) {
-            // entity no longer exists
-            return;
-        }
-
-        if (ecd.getComponent(entity, SGMesh) !== mesh) {
-            // mesh has changed
-            return;
-        }
-
-        if (asset.boundingBox !== undefined) {
-            mesh.__initial_bounds.copy(asset.boundingBox);
-
-            if (asset.has_root_transform) {
-                // TODO potentially move this to the GLTF Asset Loader to skip matrix operations here
-                mesh.__initial_bounds.applyMatrix4(asset.root_transform.matrix);
-            }
-
-        } else {
-            console.error(`No bounds for asset: ${asset.description}`);
-        }
-
-        let object;
-        const cached_object = STATIC_ASSET_CACHE.get(asset);
-
-        if (cached_object !== null) {
-            object = cached_object;
-        } else {
-            object = asset.create();
-
-            STATIC_ASSET_CACHE.set(asset, object);
-        }
-
-        let entity_node = three_object_to_entity_composition(object);
-
-        if (asset.has_root_transform) {
-            // apply root transform
-
-            const new_root = new EntityNode();
-
-            new_root.entity.add(new Transform());
-
-            entity_node.transform.copy(asset.root_transform);
-
-            new_root.addChild(entity_node);
-
-            entity_node = new_root;
-        }
-
-        // attach parent entity to link hierarchy to this entity
-        entity_node.entity.add(ParentEntity.from(entity));
-
-        mesh.__node = entity_node;
-
-        function copy_transform() {
-            entity_node.transform.copy(transform);
-        }
-
-        copy_transform();
-
-        entity_node.build(ecd);
-
-        transform.subscribe(copy_transform);
-
-        entity_node.on.destroyed.addOne(() => {
-
-            transform.unsubscribe(copy_transform);
-
-        });
-
-        const material_override = mesh.materialOverride;
-
-        // apply flags to the hierarchy
-        entity_node.traverse(node => {
-            /**
-             *
-             * @type {ShadedGeometry|null}
-             */
-            const sg = node.entity.getComponent(ShadedGeometry);
-            if (sg === null) {
-                return;
-            }
-
-            sg.writeFlag(ShadedGeometryFlags.CastShadow, mesh.castShadow);
-            sg.writeFlag(ShadedGeometryFlags.ReceiveShadow, mesh.receiveShadow);
-
-            if (material_override !== null) {
-                sg.material = material_override;
-            }
-        });
-
-
-        ecd.sendEvent(entity, SGMeshEvents.AssetLoaded);
-    }
-
-    /**
-     *
-     * @param {SGMesh} mesh
-     * @param {Transform} transform
-     * @param {number} entity
-     */
-    link(mesh, transform, entity) {
-        const p = transform.position;
-
-        // set initial bounds to single point
-        mesh.__initial_bounds.setBounds(
-            p.x, p.y, p.z,
-            p.x, p.y, p.z,
-        );
-
-        if (mesh.url === null) {
-            this.__wait_queue.push(entity);
-            return;
-        }
-
-        this.process(entity, mesh, transform);
-    }
-
-    /**
-     *
-     * @param {SGMesh} mesh
-     * @param {Transform} transform
-     * @param {number} entity
-     */
-    unlink(mesh, transform, entity) {
-        if (mesh.__node !== null) {
-            mesh.__node.destroy();
-
-            mesh.__node = null;
-        }
-
-        // check the queue
-        const i = this.__wait_queue.indexOf(entity);
-
-        if (i !== -1) {
-            this.__wait_queue.splice(i, 1);
-        }
-    }
-
-    update(time_delta) {
-
-        const entityManager = this.entityManager;
-        const dataset = entityManager.dataset;
-
-        if (dataset === null) {
-            return;
-        }
-
-        const waiting = this.__wait_queue;
-
-        let l = waiting.length;
-
-        if (l > 0) {
-
-            const time_0 = performance.now();
-
-            let pointer = this.__wait_queue_process_index;
-
-            const pointer_limit = pointer + min2(l, MAX_CYCLE_COUNT);
-
-            while (pointer < pointer_limit) {
-
-                const index = pointer % l;
-                pointer++;
-
-                const entity = waiting[index];
-
-                const mesh = dataset.getComponent(entity, SGMesh);
-
-                if (mesh.url === null) {
-                    // no URL yet
-                    continue;
-                }
-
-                waiting.splice(index, 1);
-
-                const transform = dataset.getComponent(entity, Transform);
-
-                this.process(entity, mesh, transform);
-
-                const time_1 = performance.now();
-
-                if ((time_1 - time_0) > MAX_CYCLE_TIME) {
-                    // too much time has passed
-                    break;
-                }
-
-            }
-
-            this.__wait_queue_process_index = pointer;
-
-        }
-    }
-}

package/src/engine/graphics/ecs/mesh-v2/render/adapters/AbstractRenderAdapter.d.ts

@@ -1,67 +0,0 @@
-export class AbstractRenderAdapter {
-    /**
-     *
-     * @type {number}
-     * @protected
-     */
-    protected __object_count: number;
-    /**
-     *
-     * @type {THREE.Object3D[]}
-     * @protected
-     */
-    protected __objects: THREE.Object3D[];
-    /**
-     * Sorting objects by material will help reduce context switching and number of graphics API calls
-     */
-    sort_by_material(): void;
-    /**
-     *
-     * @param {THREE.BufferGeometry} geometry
-     * @param {THREE.Material} material
-     * @param {number} instance_count
-     * @returns {number}
-     */
-    score(geometry: THREE.BufferGeometry, material: THREE.Material, instance_count: number): number;
-    /**
-     * Express intent to draw
-     * @param {ShadedGeometry} sg
-     * @returns {boolean} true if able to draw immediately, false otherwise
-     */
-    intend_draw(sg: ShadedGeometry): boolean;
-    /**
-     *
-     * @param {ShadedGeometry} sg
-     * @returns {void}
-     */
-    add(sg: ShadedGeometry): void;
-    /**
-     *
-     * @param {THREE.WebGLRenderer} renderer
-     * @param {CameraView} view
-     */
-    build_start(renderer: THREE.WebGLRenderer, view: CameraView): void;
-    build_end(): void;
-    clear(): void;
-    /**
-     * Used to perform infrequent housekeeping on the adapter's internal data structures
-     * Returns a maintenance sequence
-     * @return {Generator}
-     */
-    maintain(): Generator;
-    /**
-     * @returns {THREE.Object3D[]}
-     */
-    get objects(): THREE.Object3D[];
-    /**
-     * @returns {number}
-     */
-    get object_count(): number;
-    dispose(): void;
-    /**
-     * @readonly
-     * @type {boolean}
-     */
-    readonly isShadedGeometryRenderAdapter: boolean;
-}
-//# sourceMappingURL=AbstractRenderAdapter.d.ts.map

package/src/engine/graphics/ecs/mesh-v2/render/adapters/AbstractRenderAdapter.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"AbstractRenderAdapter.d.ts","sourceRoot":"","sources":["../../../../../../../../src/engine/graphics/ecs/mesh-v2/render/adapters/AbstractRenderAdapter.js"],"names":[],"mappings":"AA4BA;IACI;;;;OAIG;IACH,0BAHU,MAAM,CAGG;IAEnB;;;;OAIG;IACH,qBAHU,gBAAgB,CAGX;IAEf;;OAEG;IACH,yBAEC;IAED;;;;;;OAMG;IACH,gFAHW,MAAM,GACJ,MAAM,CAIlB;IAED;;;;OAIG;IACH,iCAFa,OAAO,CAInB;IAED;;;;OAIG;IACH,yBAFa,IAAI,CAIhB;IAGD;;;;OAIG;IACH,mEAEC;IAED,kBAEC;IAED,cAEC;IAED;;;;OAIG;IACH,YAFY,SAAS,CAIpB;IAED;;OAEG;IACH,gCAEC;IAED;;OAEG;IACH,2BAEC;IAED,gBAEC;IAGL;;;OAGG;IACH,wCAFU,OAAO,CAE4C;CAN5D"}

package/src/engine/graphics/ecs/mesh-v2/render/adapters/AbstractRenderAdapter.js

@@ -1,130 +0,0 @@
-import {
-    array_quick_sort_by_comparator
-} from "../../../../../../core/collection/array/array_quick_sort_by_comparator.js";
-
-/**
- *
- * @param {THREE.Object3D|{material?:Material}} a
- * @param {THREE.Object3D|{material?:Material}} b
- * @returns {number}
- */
-function compare_by_material(a, b) {
-
-    const a_mat = a.material;
-    const b_mat = b.material;
-
-    if (a_mat === b_mat) {
-        return 0;
-    }
-
-    if (a_mat === undefined) {
-        return 1;
-    } else if (b_mat === undefined) {
-        return -1;
-    }
-
-    return a_mat.id - b_mat.id;
-}
-
-export class AbstractRenderAdapter {
-    /**
-     *
-     * @type {number}
-     * @protected
-     */
-    __object_count = 0;
-
-    /**
-     *
-     * @type {THREE.Object3D[]}
-     * @protected
-     */
-    __objects = [];
-
-    /**
-     * Sorting objects by material will help reduce context switching and number of graphics API calls
-     */
-    sort_by_material() {
-        array_quick_sort_by_comparator(this.__objects, compare_by_material, null, 0, this.__object_count - 1);
-    }
-
-    /**
-     *
-     * @param {THREE.BufferGeometry} geometry
-     * @param {THREE.Material} material
-     * @param {number} instance_count
-     * @returns {number}
-     */
-    score(geometry, material, instance_count) {
-        return 0;
-    }
-
-    /**
-     * Express intent to draw
-     * @param {ShadedGeometry} sg
-     * @returns {boolean} true if able to draw immediately, false otherwise
-     */
-    intend_draw(sg) {
-        return true;
-    }
-
-    /**
-     *
-     * @param {ShadedGeometry} sg
-     * @returns {void}
-     */
-    add(sg) {
-        throw new Error('Not Implemented');
-    }
-
-
-    /**
-     *
-     * @param {THREE.WebGLRenderer} renderer
-     * @param {CameraView} view
-     */
-    build_start(renderer, view) {
-
-    }
-
-    build_end() {
-
-    }
-
-    clear() {
-        this.__object_count = 0;
-    }
-
-    /**
-     * Used to perform infrequent housekeeping on the adapter's internal data structures
-     * Returns a maintenance sequence
-     * @return {Generator}
-     */
-    * maintain() {
-        // override as necessary
-    }
-
-    /**
-     * @returns {THREE.Object3D[]}
-     */
-    get objects() {
-        return this.__objects;
-    }
-
-    /**
-     * @returns {number}
-     */
-    get object_count() {
-        return this.__object_count;
-    }
-
-    dispose() {
-
-    }
-}
-
-/**
- * @readonly
- * @type {boolean}
- */
-AbstractRenderAdapter.prototype.isShadedGeometryRenderAdapter = true;

package/src/engine/graphics/ecs/mesh-v2/render/adapters/SGCacheKey.d.ts

@@ -1,42 +0,0 @@
-export class SGCacheKey {
-    /**
-     * ID of geometry
-     * @type {number}
-     */
-    geometry: number;
-    /**
-     * ID of material
-     * @type {number}
-     */
-    material: number;
-    /**
-     *
-     * @type {DrawMode}
-     */
-    mode: DrawMode;
-    /**
-     *
-     * @type {number}
-     */
-    flags: number;
-    hash(): number;
-    /**
-     *
-     * @param {SGCacheKey} other
-     * @returns {boolean}
-     */
-    equals(other: SGCacheKey): boolean;
-    /**
-     *
-     * @param {SGCacheKey} other
-     */
-    copy(other: SGCacheKey): void;
-    clone(): SGCacheKey;
-    /**
-     *
-     * @param {ShadedGeometry} sg
-     */
-    fromSG(sg: ShadedGeometry): void;
-}
-import { DrawMode } from "../../DrawMode.js";
-//# sourceMappingURL=SGCacheKey.d.ts.map

package/src/engine/graphics/ecs/mesh-v2/render/adapters/SGCacheKey.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"SGCacheKey.d.ts","sourceRoot":"","sources":["../../../../../../../../src/engine/graphics/ecs/mesh-v2/render/adapters/SGCacheKey.js"],"names":[],"mappings":"AAEA;IACI;;;OAGG;IACH,UAFU,MAAM,CAEF;IACd;;;OAGG;IACH,UAFU,MAAM,CAEF;IACd;;;OAGG;IACH,MAFU,QAAQ,CAEQ;IAE1B;;;OAGG;IACH,OAFU,MAAM,CAEN;IAEV,eAEC;IAED;;;;OAIG;IACH,cAHW,UAAU,GACR,OAAO,CAOnB;IAED;;;OAGG;IACH,YAFW,UAAU,QAOpB;IAED,oBAMC;IAED;;;OAGG;IACH,iCAKC;CACJ;yBAtEwB,mBAAmB"}

package/src/engine/graphics/ecs/mesh-v2/render/adapters/SGCacheKey.js

@@ -1,71 +0,0 @@
-import { DrawMode } from "../../DrawMode.js";
-
-export class SGCacheKey {
-    /**
-     * ID of geometry
-     * @type {number}
-     */
-    geometry = -1;
-    /**
-     * ID of material
-     * @type {number}
-     */
-    material = -1;
-    /**
-     *
-     * @type {DrawMode}
-     */
-    mode = DrawMode.Triangles;
-
-    /**
-     *
-     * @type {number}
-     */
-    flags = 0;
-
-    hash() {
-        return this.geometry ^ this.material;
-    }
-
-    /**
-     *
-     * @param {SGCacheKey} other
-     * @returns {boolean}
-     */
-    equals(other) {
-        return this.geometry === other.geometry
-            && this.material === other.material
-            && this.mode === other.mode
-            && this.flags === other.flags;
-    }
-
-    /**
-     *
-     * @param {SGCacheKey} other
-     */
-    copy(other) {
-        this.geometry = other.geometry;
-        this.material = other.material;
-        this.mode = other.mode;
-        this.flags = other.flags;
-    }
-
-    clone() {
-        const r = new SGCacheKey();
-
-        r.copy(this);
-
-        return r;
-    }
-
-    /**
-     *
-     * @param {ShadedGeometry} sg
-     */
-    fromSG(sg) {
-        this.geometry = sg.geometry.id;
-        this.material = sg.material.id;
-        this.mode = sg.mode;
-        this.flags = sg.flags;
-    }
-}

package/src/engine/graphics/ecs/mesh-v2/render/optimization/RuntimeDrawMethodOptimizer.d.ts

@@ -1,20 +0,0 @@
-export class RuntimeDrawMethodOptimizer {
-    /**
-     *
-     * @type {ShadedGeometrySystem|null}
-     * @private
-     */
-    private __system;
-    /**
-     *
-     * @type {Generator<number>}
-     * @private
-     */
-    private __entity_iterator;
-    /**
-     *
-     * @returns {boolean} true if a change was made, false otherwise
-     */
-    step(): boolean;
-}
-//# sourceMappingURL=RuntimeDrawMethodOptimizer.d.ts.map

package/src/engine/graphics/ecs/mesh-v2/render/optimization/RuntimeDrawMethodOptimizer.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"RuntimeDrawMethodOptimizer.d.ts","sourceRoot":"","sources":["../../../../../../../../src/engine/graphics/ecs/mesh-v2/render/optimization/RuntimeDrawMethodOptimizer.js"],"names":[],"mappings":"AAGA;IACI;;;;OAIG;IACH,iBAAgB;IAEhB;;;;OAIG;IACH,0BAAyB;IAEzB;;;OAGG;IACH,QAFa,OAAO,CAqGnB;CACJ"}