@woosh/meep-engine 2.48.20 → 2.48.21

package/src/engine/graphics/micron/plugin/GLTFAssetTransformer.js

@@ -1,265 +0,0 @@
-import { AssetTransformer } from "../../../asset/AssetTransformer.js";
-import { BinaryBuffer } from "../../../../core/binary/BinaryBuffer.js";
-import { MicronGeometry } from "../format/MicronGeometry.js";
-import { MICRON_GEOMETRY_FIELD } from "../MICRON_GEOMETRY_FIELD.js";
-import { async_traverse_three_object } from "../../../asset/loaders/async_traverse_three_object.js";
-import { convert_three_object_to_micron } from "../convert_three_object_to_micron.js";
-import { compute_geometry_polycount } from "../../geometry/compute_geometry_polycount.js";
-import { traverseThreeObject } from "../../ecs/highlight/renderer/traverseThreeObject.js";
-import { max2 } from "../../../../core/math/max2.js";
-import {
-    deserialize_geometry_collection
-} from "../format/serialization/collection/geometry_collection_serialization.js";
-import { GLTF_MICRON_ID_FIELD } from "./GLTF_MICRON_ID_FIELD.js";
-import { computePathDirectory } from "../../../../core/path/computePathDirectory.js";
-
-export const ASSET_TYPE_ARRAY_BUFFER = "arraybuffer";
-
-const DEFAULT_THRESHOLD_POLYCOUNT = 1024;
-
-/**
- *
- * @param {THREE.Object3D} object
- * @return {number}
- */
-function max_polycount(object) {
-    let r = 0;
-
-    traverseThreeObject(object, (m) => {
-        if (m.isMesh) {
-            const geo = m.geometry;
-            if (geo !== null) {
-                r = max2(r, compute_geometry_polycount(geo))
-            }
-        }
-    });
-
-    return r;
-}
-
-/**
- *
- * @param {THREE.Object3D} object
- */
-function ensureProxy(object) {
-    if (object.isMicronMesh) {
-
-        /**
-         * @type {MicronGeometry}
-         */
-        const micron_geo = object.geometry;
-
-        if (micron_geo.proxy === null) {
-            // proxy geometry doesn't exist, build one
-            micron_geo.buildProxy();
-        }
-    }
-}
-
-class TransformContext {
-    /**
-     *
-     * @param {AssetManager} assetManager
-     * @param {AbstractAsyncMap<THREE.BufferGeometry, MicronGeometry>} cache
-     */
-    constructor(assetManager, cache) {
-        /**
-         *
-         * @type {AbstractAsyncMap<THREE.BufferGeometry, MicronGeometry>|undefined}
-         * @private
-         */
-        this.__cache = cache;
-
-        /**
-         *
-         * @type {MicronGeometry[]}
-         * @private
-         */
-        this.__active_mesh_micron_cache = [];
-
-        this.__am = assetManager;
-    }
-
-    /**
-     *
-     * @param {{userData:{}}} gltf
-     * @param {AssetDescription} ad
-     */
-    async load_mesh_micron_data(gltf, ad) {
-        // clear active cache
-        this.__active_mesh_micron_cache = [];
-
-        const micron_metadata = gltf.userData.micron;
-
-        if (micron_metadata === undefined) {
-            return;
-        }
-
-        const uri = micron_metadata.geometry_data_uri;
-        if (uri === undefined) {
-            return;
-        }
-
-        const base = computePathDirectory(ad.path);
-
-        let micron_data;
-
-        const micron_path = `${base}/${uri}`;
-
-        try {
-            micron_data = await this.__am.promise(micron_path, ASSET_TYPE_ARRAY_BUFFER, { skip_queue: true });
-        } catch (e) {
-            console.error(`Failed to load micron geometry '${micron_path}' referenced in GLTF (will skip): ${e}`);
-            return;
-        }
-
-        // deserialize micron data
-        const buffer = BinaryBuffer.fromArrayBuffer(micron_data.create());
-
-        deserialize_geometry_collection(this.__active_mesh_micron_cache, buffer);
-    }
-
-    /**
-     * @param {THREE.Object3D} object
-     * @param {{asset:AssetDescription}} ctx
-     * @return {Promise<void>}
-     */
-    async visitObjectToLoadMicron(object, ctx) {
-        if (!object.isMesh) {
-            return;
-        }
-
-        /**
-         * @type {THREE.BufferGeometry}
-         */
-        const geometry = object.geometry;
-
-        const micron_geometry_index = geometry.userData[GLTF_MICRON_ID_FIELD];
-
-        if (typeof micron_geometry_index !== "number") {
-            return;
-        }
-
-        const micron_geometry = this.__active_mesh_micron_cache[micron_geometry_index];
-
-        if (micron_geometry === undefined) {
-            console.error(`Micron geometry '${micron_geometry_index}' not found`);
-            return;
-        }
-
-        // set proxy for raycasting
-        micron_geometry.proxy = geometry;
-
-        geometry[MICRON_GEOMETRY_FIELD] = micron_geometry;
-
-        // push data into cache
-        if (this.__cache !== undefined) {
-            this.__cache.set(geometry, micron_geometry);
-        }
-    }
-
-}
-
-export class GLTFAssetTransformer extends AssetTransformer {
-    /**
-     *
-     * @param {AbstractAsyncMap<THREE.BufferGeometry, MicronGeometry>} [cache]
-     */
-    constructor(cache) {
-        super();
-
-        /**
-         *
-         * @type {AbstractAsyncMap<THREE.BufferGeometry, MicronGeometry>|undefined}
-         * @private
-         */
-        this.__cache = cache;
-
-        /**
-         *
-         * @type {AssetManager|null}
-         * @private
-         */
-        this.__am = null;
-
-        /**
-         * Minimum number of polygons required for micron to be used
-         * @type {number}
-         * @private
-         */
-        this.__threshold_polycount = DEFAULT_THRESHOLD_POLYCOUNT;
-
-        /**
-         *
-         * @type {MicronGeometry[]}
-         * @private
-         */
-        this.__active_mesh_micron_cache = [];
-
-        /**
-         * @deprecated
-         * Whether override mesh will be created for the asset, this is generally outdated
-         * @type {boolean}
-         * @private
-         */
-        this.__settings_build_override_mesh = false;
-    }
-
-    /**
-     *
-     * @param {AssetManager|null} am
-     */
-    set assetManager(am) {
-        this.__am = am;
-    }
-
-
-    /**
-     *
-     * @param {Asset} source
-     * @param {AssetDescription} asset_description
-     * @return {Promise<Asset>}
-     */
-    async transform(source, asset_description) {
-        const animationClips = source.animations;
-
-        if (animationClips !== undefined && animationClips.length > 0) {
-            // animations might cause trouble
-            console.warn(`model '${asset_description.path}' contains animations, these animations might not works as intended with micron.`);
-        }
-
-        /**
-         * @type {THREE.Object3D}
-         */
-        const root = source.create();
-
-        const context = new TransformContext(this.__am, this.__cache);
-
-        await context.load_mesh_micron_data(source.gltf, asset_description);
-
-        // attempt to load existing micron geometries
-        await async_traverse_three_object(root, context.visitObjectToLoadMicron, context, {
-            asset: asset_description
-        });
-
-        const gltf_max_polycount = max_polycount(root);
-
-        if (gltf_max_polycount < this.__threshold_polycount) {
-            // no change, geometries are too small
-            return source;
-        }
-
-        if (this.__settings_build_override_mesh) {
-            console.warn(`Deprecated OVERRIDE_MESH setting is ON, generating override mesh for asset: ${asset_description}`);
-
-            const micron_root = await convert_three_object_to_micron(root.clone(), this.__cache);
-            micron_root.boundingSphere = root.boundingSphere;
-
-            source.override_mesh = micron_root;
-
-            traverseThreeObject(micron_root, ensureProxy);
-        }
-
-        return source;
-    }
-}

package/src/engine/graphics/micron/plugin/GLTF_MICRON_ID_FIELD.js

@@ -1,5 +0,0 @@
-/**
- *
- * @type {string}
- */
-export const GLTF_MICRON_ID_FIELD = '@micron_geometry_index';

package/src/engine/graphics/micron/plugin/MicronRenderPlugin.d.ts

@@ -1,8 +0,0 @@
-import {EnginePlugin} from "../../../plugin/EnginePlugin";
-import {Camera, Object3D, WebGLRenderer} from "three";
-
-export class MicronRenderPlugin extends EnginePlugin {
-
-    render(renderer: WebGLRenderer, camera: Camera, elements: Object3D[]): void
-
-}

package/src/engine/graphics/micron/plugin/MicronRenderPlugin.js

@@ -1,150 +0,0 @@
-import { EnginePlugin } from "../../../plugin/EnginePlugin.js";
-import { VGThreeRenderer } from "../render/v1/VGThreeRenderer.js";
-import { RenderLayer } from "../../render/layers/RenderLayer.js";
-import { RenderPassType } from "../../render/RenderPassType.js";
-import { ArrayBufferLoader } from "../../../asset/loaders/ArrayBufferLoader.js";
-import { ASSET_TYPE_ARRAY_BUFFER, GLTFAssetTransformer } from "./GLTFAssetTransformer.js";
-import { ShadedGeometrySystem } from "../../ecs/mesh-v2/ShadedGeometrySystem.js";
-import { MicronShadedGeometryRenderAdapter } from "./shaded_geometry/MicronShadedGeometryRenderAdapter.js";
-
-/**
- *
- * @type {string}
- */
-const STORAGE_KEY = '@plugin/virtual-geometry-micron/geometry-cache';
-
-export class MicronRenderPlugin extends EnginePlugin {
-    constructor() {
-        super();
-
-        this.id = "micron-renderer";
-
-        this.__vgtr = new VGThreeRenderer();
-
-        const layer = new RenderLayer();
-        layer.name = 'micron';
-        layer.managed = true;
-        layer.renderPass = RenderPassType.Opaque;
-
-        this.__vgtr.on.contextAdded.add(ctx => {
-            const visibleSet = layer.visibleSet;
-
-            const mesh = ctx.mesh;
-
-            visibleSet.elements.push(mesh);
-            visibleSet.size++;
-
-        });
-
-
-        /**
-         *
-         * @type {GLTFAssetTransformer}
-         * @private
-         */
-        this.__asset_transformer = new GLTFAssetTransformer();
-
-        /**
-         *
-         * @type {ShadedGeometrySystem|null}
-         * @private
-         */
-        this.__sg_system = null;
-    }
-
-    /**
-     *
-     * @param {System} system
-     * @private
-     */
-    __handle_system_added(system) {
-        if (this.__sg_system !== null) {
-            return;
-        }
-
-        if (!(system instanceof ShadedGeometrySystem)) {
-            return;
-        }
-
-        /**
-         *
-         * @type {ShadedGeometrySystem|null}
-         */
-        const sg_system = system;
-
-        sg_system.register_render_adapter(2, () => {
-            const adapter = new MicronShadedGeometryRenderAdapter(this.__cache);
-
-            adapter.ctx = this.__vgtr.ctx;
-
-            return adapter;
-        });
-
-        this.__sg_system = sg_system;
-    }
-
-    /**
-     *
-     * @param {System} system
-     * @private
-     */
-    __handle_system_removed(system) {
-        if (this.__sg_system === null) {
-            return;
-        }
-
-        if (!(system instanceof ShadedGeometrySystem)) {
-            return;
-        }
-
-        if (this.__sg_system !== system) {
-            return;
-        }
-
-        this.__sg_system.unregister_render_adapter(2);
-    }
-
-    async startup() {
-
-        const engine = this.engine;
-
-        const am = engine.assetManager;
-
-        // ensure that "arraybuffer" asset loader is present
-        if (am.getLoaderByType(ASSET_TYPE_ARRAY_BUFFER) === undefined) {
-            am.registerLoader(ASSET_TYPE_ARRAY_BUFFER, new ArrayBufferLoader({
-                fetch_priority: "low" // hint to fetch data in background
-            }));
-        }
-
-        this.__asset_transformer.assetManager = am;
-
-        am.registerTransformer("model/gltf", this.__asset_transformer);
-        am.registerTransformer("model/gltf+json", this.__asset_transformer);
-
-        engine.entityManager.on.systemAdded.add(this.__handle_system_added, this);
-        engine.entityManager.on.systemRemoved.add(this.__handle_system_removed, this);
-
-        engine.entityManager.systems.forEach(this.__handle_system_added, this);
-
-        await super.startup();
-    }
-
-    async shutdown() {
-        const engine = this.engine;
-
-        const am = engine.assetManager;
-
-        am.unregisterTransformer("model/gltf", this.__asset_transformer);
-        am.unregisterTransformer("model/gltf+json", this.__asset_transformer);
-
-        this.__asset_transformer.assetManager = null;
-
-        engine.entityManager.on.systemAdded.remove(this.__handle_system_added, this);
-        engine.entityManager.on.systemRemoved.remove(this.__handle_system_removed, this);
-
-        engine.entityManager.systems.forEach(this.__handle_system_removed, this);
-
-        await super.shutdown();
-    }
-}

package/src/engine/graphics/micron/plugin/serialization/BufferGeometrySerializationAdapter.js

@@ -1,176 +0,0 @@
-import { BinaryClassSerializationAdapter } from "../../../../ecs/storage/binary/BinaryClassSerializationAdapter.js";
-import { BufferAttribute, BufferGeometry } from "three";
-
-function typed_array_to_enum(array) {
-    if (array instanceof Uint8Array) {
-        return 0;
-    } else if (array instanceof Uint16Array) {
-        return 1;
-    } else if (array instanceof Uint32Array) {
-        return 2;
-    } else if (array instanceof Uint8Array) {
-        return 3;
-    } else if (array instanceof Uint16Array) {
-        return 4;
-    } else if (array instanceof Uint32Array) {
-        return 5;
-    } else if (array instanceof Float32Array) {
-        return 6;
-    } else if (array instanceof Float64Array) {
-        return 7;
-    } else {
-        throw new Error('Unsupported array type');
-    }
-}
-
-function marker_to_typed_array_constructor(marker) {
-    switch (marker) {
-        case 0:
-            return Uint8Array;
-        case 1:
-            return Uint16Array;
-        case 2:
-            return Uint32Array;
-        case 3:
-            return Int8Array;
-        case 4:
-            return Int16Array;
-        case 5:
-            return Int32Array;
-        case 6:
-            return Float32Array;
-        case 7:
-            return Float64Array;
-        default:
-            throw new Error('Unsupported marker');
-    }
-}
-
-/**
- *
- * @param {BinaryBuffer} buffer
- * @param {Uint8Array|Float32Array|ArrayLike<number>} value
- */
-function write_typed_array(buffer, value) {
-
-    buffer.writeUint8(typed_array_to_enum(value));
-    buffer.writeUintVar(value.byteLength);
-
-    const data = new Uint8Array(value.buffer, value.byteOffset, value.byteLength);
-    buffer.writeBytes(data, 0, value.byteLength);
-}
-
-function read_typed_array(buffer) {
-    const type_marker = buffer.readUint8();
-    const byte_length = buffer.readUintVar();
-
-    const array = new Uint8Array(byte_length);
-
-    buffer.readBytes(array, 0, byte_length);
-
-    // re-interpret bytes
-    const TypedArray = marker_to_typed_array_constructor(type_marker);
-
-    return new TypedArray(array.buffer, 0);
-}
-
-/**
- *
- * @param {BinaryBuffer} buffer
- * @param {BufferAttribute} value
- */
-function write_attribute(buffer, value) {
-    buffer.writeUTF8String(value.name);
-    buffer.writeUintVar(value.itemSize);
-    buffer.writeUint8(value.normalized ? 1 : 0);
-    buffer.writeUint32(value.usage);
-
-    write_typed_array(buffer, value.array);
-}
-
-/**
- *
- * @param {BinaryBuffer} buffer
- * @returns {BufferAttribute}
- */
-function read_attribute(buffer) {
-    const name = buffer.readUTF8String();
-    const itemSize = buffer.readUintVar();
-    const normalized = buffer.readUint8() !== 0;
-    const usage = buffer.readUint32();
-
-    const array = read_typed_array(buffer);
-
-    const attribute = new BufferAttribute(array, itemSize, normalized);
-
-    attribute.usage = usage;
-    attribute.name = name;
-
-    return attribute;
-}
-
-export class BufferGeometrySerializationAdapter extends BinaryClassSerializationAdapter {
-    constructor() {
-        super();
-
-        this.klass = BufferGeometry;
-    }
-
-    /**
-     *
-     * @param {BinaryBuffer} buffer
-     * @param {BufferGeometry} value
-     */
-    serialize(buffer, value) {
-        // write index if one exists
-        const index = value.getIndex();
-        if (index === null) {
-            buffer.writeUint8(0);
-        } else {
-            buffer.writeUint8(1);
-
-            write_attribute(buffer, index);
-        }
-
-        const attributes = value.attributes;
-        const attribute_keys = Object.keys(attributes);
-
-        const attribute_count = attribute_keys.length;
-        buffer.writeUintVar(attribute_count);
-
-        for (let i = 0; i < attribute_count; i++) {
-            const attribute_key = attribute_keys[i];
-
-            buffer.writeUTF8String(attribute_key);
-
-            const attribute = attributes[attribute_key];
-
-            write_attribute(buffer, attribute);
-        }
-    }
-
-    /**
-     *
-     * @param {BinaryBuffer} buffer
-     * @param {BufferGeometry} value
-     */
-    deserialize(buffer, value) {
-        const index_flag = buffer.readUint8();
-
-        if (index_flag !== 0) {
-            value.setIndex(read_attribute(buffer));
-        } else {
-            value.setIndex(null);
-        }
-
-        const attribute_count = buffer.readUintVar();
-
-        for (let i = 0; i < attribute_count; i++) {
-            const attribute_key = buffer.readUTF8String();
-
-            const attribute = read_attribute(buffer);
-
-            value.setAttribute(attribute_key, attribute);
-        }
-    }
-}