@woosh/meep-engine 3.4.0 → 3.6.0

package/src/shade/playground/skinned_blas_refit/place_character.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"place_character.d.ts","sourceRoot":"","sources":["../../../../../src/shade/playground/skinned_blas_refit/place_character.js"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4DG;AACH,sEAJW,MAAM,KACN,MAAM,GACJ,MAAM,CA+BlB;AAED;;;;;;;;;;;;GAYG;AACH,qCALW,MAAM,SACN,MAAM,WACN,MAAM,GACJ;IAAC,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAC,CAUlC;uBAnHsB,gCAAgC"}
+{"version":3,"file":"place_character.d.ts","sourceRoot":"","sources":["../../../../../src/shade/playground/skinned_blas_refit/place_character.js"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6DG;AACH,sEAJW,MAAM,KACN,MAAM,GACJ,MAAM,CA+BlB;AAED;;;;;;;;;;;;GAYG;AACH,qCALW,MAAM,SACN,MAAM,WACN,MAAM,GACJ;IAAC,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAC,CAUlC;uBApHsB,gCAAgC"}

package/src/shade/playground/skinned_blas_refit/place_character.js

@@ -21,7 +21,8 @@ import { Node3D } from "../../renderer/scene/Node3D.js";
  * actually sit under.
  *
  * Michelle is the shape that makes this concrete. Her file is one root carrying the centimetre
- * scale and the Z-up rotation, with the mesh node and the joint root as *siblings* beneath it:
+ * scale and the up-axis rotation (+90° about x, the file's Z-up into the renderer's Y-up), with the
+ * mesh node and the joint root as *siblings* beneath it:
  *
  * ```
  * "Character"            R=(0.70711, 0, 0, 0.70711)  S=(0.01, 0.01, 0.01)

package/src/shade/renderer/scene/bvh/StaticSceneBVH.js

@@ -390,10 +390,10 @@ export class StaticSceneBVH {
         let nearest_distance = ray.tMax;
 
         const hit_count = bvh_query_user_data_ray(
-            bvh,
-            bvh.root,
             scratch_instance_hits,
             0,
+            bvh,
+            bvh.root,
             ray.origin_x, ray.origin_y, ray.origin_z,
             ray.direction_x, ray.direction_y, ray.direction_z
         );
@@ -501,10 +501,10 @@ export class StaticSceneBVH {
         const bvh = this.instance_bvh;
 
         const hit_count = bvh_query_user_data_ray(
-            bvh,
-            bvh.root,
             scratch_instance_hits,
             0,
+            bvh,
+            bvh.root,
             ray.origin_x, ray.origin_y, ray.origin_z,
             ray.direction_x, ray.direction_y, ray.direction_z
         );

package/src/view/graphics/{WebGLContextFailureView.d.ts → GraphicsContextFailureView.d.ts}

@@ -6,7 +6,7 @@
  * case where the renderer is dead, which is not a good moment to depend on the localization pipeline
  * having the keys; an application that has them should pass localized strings in.
  */
-export class WebGLContextFailureView extends EmptyView {
+export class GraphicsContextFailureView extends EmptyView {
     /**
      * @param {string} [title]
      * @param {string} [text]
@@ -16,4 +16,4 @@ export class WebGLContextFailureView extends EmptyView {
     constructor({ title, text, action_label, action }?: string);
 }
 import EmptyView from "../elements/EmptyView.js";
-//# sourceMappingURL=WebGLContextFailureView.d.ts.map
+//# sourceMappingURL=GraphicsContextFailureView.d.ts.map

package/src/view/graphics/GraphicsContextFailureView.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"GraphicsContextFailureView.d.ts","sourceRoot":"","sources":["../../../../src/view/graphics/GraphicsContextFailureView.js"],"names":[],"mappings":"AAIA;;;;;;;GAOG;AACH;IACI;;;;;OAKG;IACH,oDALW,MAAM,EA4DhB;CACJ;sBA1EqB,0BAA0B"}

package/src/view/graphics/{WebGLContextFailureView.js → GraphicsContextFailureView.js}

@@ -10,7 +10,7 @@ import LabelView from "../common/LabelView.js";
  * case where the renderer is dead, which is not a good moment to depend on the localization pipeline
  * having the keys; an application that has them should pass localized strings in.
  */
-export class WebGLContextFailureView extends EmptyView {
+export class GraphicsContextFailureView extends EmptyView {
     /**
      * @param {string} [title]
      * @param {string} [text]

package/src/core/geom/3d/aabb/aabb3_from_three_geometry.d.ts

@@ -1,7 +0,0 @@
-/**
- *
- * @param {number[]|ArrayLike<number>|Float32Array} result
- * @param {BufferGeometry} geometry
- */
-export function aabb3_from_three_geometry(result: number[] | ArrayLike<number> | Float32Array, geometry: BufferGeometry): void;
-//# sourceMappingURL=aabb3_from_three_geometry.d.ts.map

package/src/core/geom/3d/aabb/aabb3_from_three_geometry.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"aabb3_from_three_geometry.d.ts","sourceRoot":"","sources":["../../../../../../src/core/geom/3d/aabb/aabb3_from_three_geometry.js"],"names":[],"mappings":"AAGA;;;;GAIG;AACH,kDAHW,MAAM,EAAE,GAAC,UAAU,MAAM,CAAC,GAAC,YAAY,kCAYjD"}

package/src/core/geom/3d/aabb/aabb3_from_three_geometry.js

@@ -1,18 +0,0 @@
-import { assert } from "../../../assert.js";
-import { aabb3_from_min_max } from "./aabb3_from_min_max.js";
-
-/**
- *
- * @param {number[]|ArrayLike<number>|Float32Array} result
- * @param {BufferGeometry} geometry
- */
-export function aabb3_from_three_geometry(result, geometry) {
-    const gbb = geometry.boundingBox;
-
-    assert.notNull(gbb, 'boundingBox');
-
-    const min = gbb.min;
-    const max = gbb.max;
-
-    aabb3_from_min_max(result, min, max);
-}

package/src/core/geom/3d/aabb/aabb3_from_threejs_geometry.d.ts

@@ -1,7 +0,0 @@
-/**
- * @deprecated Renamed to {@link aabb3_from_three_geometry}. This re-export is kept for backward
- * compatibility (meep is a library; old names are public surface).
- */
-export const aabb3_from_threejs_geometry: typeof aabb3_from_three_geometry;
-import { aabb3_from_three_geometry } from "./aabb3_from_three_geometry.js";
-//# sourceMappingURL=aabb3_from_threejs_geometry.d.ts.map

package/src/core/geom/3d/aabb/aabb3_from_threejs_geometry.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"aabb3_from_threejs_geometry.d.ts","sourceRoot":"","sources":["../../../../../../src/core/geom/3d/aabb/aabb3_from_threejs_geometry.js"],"names":[],"mappings":"AAEA;;;GAGG;AACH,2EAAqE;0CAN3B,gCAAgC"}

package/src/core/geom/3d/aabb/aabb3_from_threejs_geometry.js

@@ -1,7 +0,0 @@
-import { aabb3_from_three_geometry } from "./aabb3_from_three_geometry.js";
-
-/**
- * @deprecated Renamed to {@link aabb3_from_three_geometry}. This re-export is kept for backward
- * compatibility (meep is a library; old names are public surface).
- */
-export const aabb3_from_threejs_geometry = aabb3_from_three_geometry;

package/src/engine/ecs/transform/copy_three_transform.d.ts

@@ -1,7 +0,0 @@
-/**
- *
- * @param {Transform} transform
- * @param {THREE.Object3D} three_object
- */
-export function copy_three_transform(transform: Transform, three_object: THREE.Object3D): void;
-//# sourceMappingURL=copy_three_transform.d.ts.map

package/src/engine/ecs/transform/copy_three_transform.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"copy_three_transform.d.ts","sourceRoot":"","sources":["../../../../../src/engine/ecs/transform/copy_three_transform.js"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,+FASC"}

package/src/engine/ecs/transform/copy_three_transform.js

@@ -1,15 +0,0 @@
-/**
- *
- * @param {Transform} transform
- * @param {THREE.Object3D} three_object
- */
-export function copy_three_transform(transform, three_object) {
-
-    // copy object transform
-    transform.position.copy(three_object.position);
-    transform.scale.copy(three_object.scale);
-    transform.rotation.copy(three_object.quaternion);
-
-    //
-    transform.matrix.set(three_object.matrix.elements);
-}

package/src/engine/graphics/ecs/mesh-v2/DeferredBoundsQueue.d.ts

@@ -1,48 +0,0 @@
-/**
- * Collects {@link ShadedGeometry} components whose bounding box has gone stale under
- * {@link ShadedGeometryFlags.DeferredBoundsUpdate}, until the owner of the BVH is ready
- * to take the updates.
- *
- * WHY THIS EXISTS
- *
- * A {@link Transform} signals `position`, `rotation` and `scale` separately, so one
- * logical move produces several change notifications: two when a caller sets position
- * and rotation, three when the transform is written as a matrix (which is what
- * {@link TransformAttachmentSystem} does for every entity in a hierarchy, and what
- * `Transform.copy` does). Updating bounds on each of those recomputes the same box and
- * walks the same path to the BVH root several times over. Parking the component here
- * instead collapses the batch into one update per component per flush.
- *
- * Entries are appended without a membership test; {@link ShadedGeometry} carries the
- * "already queued" bit so enqueueing stays O(1) and a component appears at most once.
- */
-export class DeferredBoundsQueue {
-    /**
-     * Number of components waiting for their bounds to be applied.
-     * @returns {number}
-     */
-    get size(): number;
-    /**
-     * Park a component whose bounds have gone stale.
-     *
-     * The caller must not add a component that is already queued — see
-     * {@link ShadedGeometry.updateTransform}, which owns that bit.
-     * @param {ShadedGeometry} sg
-     * @returns {void}
-     */
-    add(sg: ShadedGeometry): void;
-    /**
-     * Apply every parked update, leaving the BVH consistent with the current transforms.
-     *
-     * Components that were unlinked while queued, or whose bounds were already settled by
-     * a read, are skipped.
-     *
-     * Must not be re-entered: nothing reached from here writes to a {@link Transform},
-     * so no component can go dirty while the batch is being applied.
-     * @returns {number} how many components actually had an update applied, which is a
-     * useful profiling signal — it is the number of BVH refits the batch cost
-     */
-    flush(): number;
-    #private;
-}
-//# sourceMappingURL=DeferredBoundsQueue.d.ts.map

package/src/engine/graphics/ecs/mesh-v2/DeferredBoundsQueue.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"DeferredBoundsQueue.d.ts","sourceRoot":"","sources":["../../../../../../src/engine/graphics/ecs/mesh-v2/DeferredBoundsQueue.js"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AACH;IAaI;;;OAGG;IACH,mBAEC;IAED;;;;;;;OAOG;IACH,yBAFa,IAAI,CAIhB;IAED;;;;;;;;;;OAUG;IACH,SAHa,MAAM,CA2BlB;;CACJ"}

package/src/engine/graphics/ecs/mesh-v2/DeferredBoundsQueue.js

@@ -1,88 +0,0 @@
-/**
- * Collects {@link ShadedGeometry} components whose bounding box has gone stale under
- * {@link ShadedGeometryFlags.DeferredBoundsUpdate}, until the owner of the BVH is ready
- * to take the updates.
- *
- * WHY THIS EXISTS
- *
- * A {@link Transform} signals `position`, `rotation` and `scale` separately, so one
- * logical move produces several change notifications: two when a caller sets position
- * and rotation, three when the transform is written as a matrix (which is what
- * {@link TransformAttachmentSystem} does for every entity in a hierarchy, and what
- * `Transform.copy` does). Updating bounds on each of those recomputes the same box and
- * walks the same path to the BVH root several times over. Parking the component here
- * instead collapses the batch into one update per component per flush.
- *
- * Entries are appended without a membership test; {@link ShadedGeometry} carries the
- * "already queued" bit so enqueueing stays O(1) and a component appears at most once.
- */
-export class DeferredBoundsQueue {
-    /**
-     * Retained between flushes and overwritten in place rather than re-allocated.
-     * Only the first {@link #size} entries are live.
-     * @type {ShadedGeometry[]}
-     */
-    #items = [];
-
-    /**
-     * @type {number}
-     */
-    #size = 0;
-
-    /**
-     * Number of components waiting for their bounds to be applied.
-     * @returns {number}
-     */
-    get size() {
-        return this.#size;
-    }
-
-    /**
-     * Park a component whose bounds have gone stale.
-     *
-     * The caller must not add a component that is already queued — see
-     * {@link ShadedGeometry.updateTransform}, which owns that bit.
-     * @param {ShadedGeometry} sg
-     * @returns {void}
-     */
-    add(sg) {
-        this.#items[this.#size++] = sg;
-    }
-
-    /**
-     * Apply every parked update, leaving the BVH consistent with the current transforms.
-     *
-     * Components that were unlinked while queued, or whose bounds were already settled by
-     * a read, are skipped.
-     *
-     * Must not be re-entered: nothing reached from here writes to a {@link Transform},
-     * so no component can go dirty while the batch is being applied.
-     * @returns {number} how many components actually had an update applied, which is a
-     * useful profiling signal — it is the number of BVH refits the batch cost
-     */
-    flush() {
-        const items = this.#items;
-        const size = this.#size;
-
-        let applied = 0;
-
-        for (let i = 0; i < size; i++) {
-            if (items[i].applyDeferredBoundsUpdate()) {
-                applied++;
-            }
-        }
-
-        // Drop the references so components unlinked while queued are not held alive
-        // until their slot happens to be overwritten — after a teardown the slots may
-        // never be reused, and each entry retains a geometry and a material.
-        //
-        // Done in one sweep rather than per entry inside the loop above: clearing each
-        // slot as it was consumed measured ~25% slower per tick on a 2000-mover scene,
-        // the store into the object array carrying a GC write barrier each time.
-        items.fill(null, 0, size);
-
-        this.#size = 0;
-
-        return applied;
-    }
-}

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

@@ -1,63 +0,0 @@
-export class SGMeshSystem extends System<any> {
-    /**
-     *
-     * @param {Engine} engine
-     */
-    constructor(engine: Engine);
-    dependencies: (typeof Transform | typeof SGMesh)[];
-    components_used: (ResourceAccessSpecification<typeof Transform> | ResourceAccessSpecification<typeof TransformAttachment> | ResourceAccessSpecification<typeof SGMesh> | ResourceAccessSpecification<typeof ShadedGeometry>)[];
-    /**
-     *
-     * @type {number[]}
-     * @private
-     */
-    private __wait_queue;
-    /**
-     *
-     * @type {number}
-     * @private
-     */
-    private __wait_queue_process_index;
-    /**
-     *
-     * @type {Engine}
-     * @private
-     */
-    private __engine;
-    /**
-     *
-     * @type {AssetManager}
-     * @private
-     */
-    private __assetManager;
-    startup(em: any): Promise<void>;
-    /**
-     *
-     * @param {number} entity
-     * @param {SGMesh} mesh
-     * @param {Transform} transform
-     */
-    process(entity: number, mesh: SGMesh, transform: Transform): Promise<void>;
-    /**
-     *
-     * @param {SGMesh} mesh
-     * @param {Transform} transform
-     * @param {number} entity
-     */
-    link(mesh: SGMesh, transform: Transform, entity: number): void;
-    /**
-     *
-     * @param {SGMesh} mesh
-     * @param {Transform} transform
-     * @param {number} entity
-     */
-    unlink(mesh: SGMesh, transform: Transform, entity: number): void;
-    update(time_delta: any): void;
-}
-import { System } from "../../../../ecs/System.js";
-import { Transform } from "../../../../ecs/transform/Transform.js";
-import { SGMesh } from "./SGMesh.js";
-import { ResourceAccessSpecification } from "../../../../../core/model/ResourceAccessSpecification.js";
-import { TransformAttachment } from "../../../../ecs/transform-attachment/TransformAttachment.js";
-import { ShadedGeometry } from "../ShadedGeometry.js";
-//# sourceMappingURL=SGMeshSystem.d.ts.map

package/src/engine/graphics/ecs/mesh-v2/aggregate/SGMeshSystem.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"SGMeshSystem.d.ts","sourceRoot":"","sources":["../../../../../../../src/engine/graphics/ecs/mesh-v2/aggregate/SGMeshSystem.js"],"names":[],"mappings":"AA8CA;IAuBI;;;OAGG;IACH,4BAgBC;IA1CD,mDAAmC;IACnC,+NAKE;IAEF;;;;OAIG;IACH,qBAAkB;IAElB;;;;OAIG;IACH,mCAA+B;IAS3B;;;;OAIG;IACH,iBAAsB;IAEtB;;;;OAIG;IACH,uBAAyC;IAG7C,gCAMC;IAED;;;;;OAKG;IACH,gBAJW,MAAM,QACN,MAAM,aACN,SAAS,iBA8GnB;IAED;;;;;OAKG;IACH,WAJW,MAAM,aACN,SAAS,UACT,MAAM,QAiBhB;IAED;;;;;OAKG;IACH,aAJW,MAAM,aACN,SAAS,UACT,MAAM,QAehB;IAED,8BAqDC;CACJ;uBAnTsB,2BAA2B;0BAGxB,wCAAwC;uBAK3C,aAAa;4CAZQ,0DAA0D;oCAKlE,6DAA6D;+BAIlE,sBAAsB"}

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;
-
-        }
-    }
-}