@directivegames/genesys.js 3.1.24

package/dist/src/components/visual/GLTFMeshComponent.js

@@ -0,0 +1,411 @@
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var _a;
+var GLTFMeshComponent_1;
+import * as THREE from 'three';
+import * as SkeletonUtils from 'three/examples/jsm/utils/SkeletonUtils.js';
+import { ENABLE_LIGHTMAPS } from '../../const.js';
+import { AssetPath } from '../../storage/storageProvider.js';
+import { EngineClass } from '../../systems/ClassRegistry.js';
+import { Delegate } from '../../utils/Delegate.js';
+import { AsyncTaskWorker, IAsyncLoadableTag } from '../../utils/IAsyncLoadable.js';
+import { resourceManager } from '../../utils/ResourceManager.js';
+import { isNode } from '../../utils/Utils.js';
+import { PrimitiveComponent } from '../PrimitiveComponent.js';
+let GLTFMeshComponent = GLTFMeshComponent_1 = class GLTFMeshComponent extends PrimitiveComponent {
+    static get DEFAULT_OPTIONS() {
+        return {
+            ...PrimitiveComponent.DEFAULT_OPTIONS,
+            modelUrl: undefined,
+            material: undefined,
+            materials: undefined,
+            excludeFromNavigation: false,
+            useDynamicMaterials: false,
+        };
+    }
+    /**
+       * Creates a new GLTFMeshComponent with the specified options
+       * @param options Configuration options including the model URL
+       */
+    constructor(options = {}) {
+        super(options);
+        Object.defineProperty(this, _a, {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: true
+        });
+        Object.defineProperty(this, "onMeshLoaded", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: new Delegate()
+        });
+        Object.defineProperty(this, "model", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: null
+        });
+        /** The last loaded glTF result, including animations and other data */
+        Object.defineProperty(this, "gltf", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: null
+        });
+        Object.defineProperty(this, "_asyncTaskWorker", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: new AsyncTaskWorker()
+        });
+        if (this.options.modelUrl) {
+            this.loadModel(AssetPath.fromString(this.options.modelUrl));
+        }
+    }
+    async waitForLoad() {
+        await this._asyncTaskWorker.waitUntilComplete();
+    }
+    isLoading() {
+        return this._asyncTaskWorker.isRunning();
+    }
+    /**
+       * Asynchronously loads a GLTF model from the specified URL
+       * @param url The URL to load the GLTF model from
+       * @returns Promise that resolves when the model is loaded
+       * @throws Error if the model fails to load
+       */
+    async loadModel(path) {
+        await this._asyncTaskWorker.runTask(async () => {
+            this.options.modelUrl = path.initialPath;
+            const gltf = await resourceManager.loadModel(path);
+            if (!gltf) {
+                return;
+            }
+            this.model?.removeFromParent();
+            this.gltf = gltf;
+            // NOTE: the returned gltf is the same instance under the same url so we need to instantiate for this particular component
+            this.model = SkeletonUtils.clone(gltf.scene);
+            // CRITICAL: SkeletonUtils.clone() creates shallow copies of geometries, meaning multiple instances
+            // share the same geometry objects. This causes issues when systems like lightmapping modify
+            // geometries by adding UV2 coordinates - the changes affect all instances.
+            // This is a workaround and should be replaced down the line with a better solution.
+            if (ENABLE_LIGHTMAPS) {
+                this.deepCloneGeometries(this.model);
+            }
+            if (!isNode()) {
+                if (this.options.material) {
+                    await this.setMaterial(this.options.material);
+                }
+                else if (this.options.materials) {
+                    await this.setMaterials(this.options.materials);
+                }
+            }
+            this.add(this.model);
+            this.updateMatrixWorld(true);
+            this.gltf = gltf;
+            // Refresh physics representation if component is already in scene and playing
+            this.refreshPhysics();
+            this.model.traverse((child) => {
+                if (child instanceof THREE.Mesh) {
+                    this.bindObject3DProperties(child, ['castShadow', 'receiveShadow']);
+                }
+            });
+            // Clone materials if useDynamicMaterials is enabled and we're playing
+            // Must happen AFTER materials are loaded and applied
+            if (this.options.useDynamicMaterials && this.getActor()?.isPlaying()) {
+                this.cloneMaterials();
+            }
+            // Call all callbacks
+            this.onMeshLoaded.invoke(this, this.model);
+        });
+    }
+    /**
+     * Deep clones all geometries in the model to ensure each instance has unique geometry objects
+     * This prevents shared geometry issues when systems modify geometries (e.g., adding UV2 coordinates)
+     * This is a workaround and should be replaced down the line with a better solution.
+     */
+    deepCloneGeometries(object) {
+        object.traverse((child) => {
+            if (child instanceof THREE.Mesh && child.geometry) {
+                // Clone the geometry to create a unique instance for this component
+                child.geometry = child.geometry.clone();
+                //TODO: Might need to clone the material as well
+            }
+        });
+    }
+    /**
+     * Clones all materials in the model to create unique instances
+     * This allows runtime material modifications without affecting other instances
+     */
+    cloneMaterials() {
+        if (!this.model)
+            return;
+        this.model.traverse((child) => {
+            if (child instanceof THREE.Mesh && child.material) {
+                if (Array.isArray(child.material)) {
+                    // Clone each material in the array
+                    child.material = child.material.map(mat => mat.clone());
+                }
+                else {
+                    // Clone single material
+                    child.material = child.material.clone();
+                }
+            }
+        });
+    }
+    /**
+     * Refreshes the physics representation of this component
+     * Should be called when the model is loaded or changed significantly
+     */
+    refreshPhysics() {
+        const actor = this.getActor();
+        if (actor?.isPlaying() && this.isPhysicsEnabled()) {
+            const physicsEngine = this.getPhysicsEngine();
+            if (physicsEngine) {
+                // Remove existing physics representation
+                physicsEngine.removeComponent(this);
+                // Create new physics representation based on the loaded model
+                this.motionType = physicsEngine.addComponent(this) ?? null;
+            }
+        }
+    }
+    /**
+     * Sets a material to override all materials in the model
+     * @param material The material to use for the entire model
+     */
+    async setMaterial(material) {
+        if (typeof material === 'string') {
+            this.options.material = material;
+            if (!material) {
+                // TODO: better way to reset to default material?
+                if (!material && typeof this.options.modelUrl === 'string') {
+                    await this.loadModel(AssetPath.fromString(this.options.modelUrl));
+                    return;
+                }
+            }
+        }
+        const loadedMaterial = await resourceManager.loadGenericMaterial(material);
+        if (loadedMaterial) {
+            const allMeshes = this.getAllMeshes();
+            for (const mesh of allMeshes) {
+                mesh.material = loadedMaterial;
+            }
+        }
+    }
+    /**
+     * Sets materials to override specific material slots in the model
+     * @param materials Array of materials to use for specific slots (by index)
+     */
+    async setMaterials(materials) {
+        this.options.materials = materials;
+        const allMeshes = this.getAllMeshes();
+        // Load all materials first
+        const loadedMaterials = await Promise.all(materials.map(mat => resourceManager.loadGenericMaterial(mat)));
+        // Apply materials by index
+        loadedMaterials.forEach((material, index) => {
+            if (material && index < allMeshes.length) {
+                allMeshes[index].material = material;
+            }
+        });
+    }
+    /**
+     * Gets the actual loaded material at a specific slot (mesh index)
+     * @param index The slot/mesh index to get the material from
+     * @returns The THREE.Material at that slot, or null if index is out of bounds
+     */
+    getMaterialBySlot(index) {
+        const allMeshes = this.getAllMeshes();
+        if (index < 0 || index >= allMeshes.length) {
+            return null;
+        }
+        return allMeshes[index].material;
+    }
+    /**
+     * Sets the material at a specific slot (mesh index)
+     * @param index The slot/mesh index to set the material for
+     * @param material The material to apply to that slot
+     */
+    async setMaterialBySlot(index, material) {
+        const allMeshes = this.getAllMeshes();
+        if (index < 0 || index >= allMeshes.length) {
+            console.warn(`GLTFMeshComponent: Invalid slot index ${index}. Valid range is 0-${allMeshes.length - 1}`);
+            return;
+        }
+        const loadedMaterial = await resourceManager.loadGenericMaterial(material);
+        if (loadedMaterial) {
+            allMeshes[index].material = loadedMaterial;
+        }
+    }
+    /**
+     * Gets the loaded THREE.Group model instance
+     * @returns The loaded model group, or null if no model is loaded
+     */
+    getModel() {
+        return this.model;
+    }
+    /**
+     * Gets the template model that's kept by resource manager
+     * @returns the template model
+     */
+    getModelTemplate() {
+        return this.gltf?.scene ?? null;
+    }
+    /**
+     * Gets the loaded GLTF model instance
+     * @returns The loaded GLTF model, or null if no model is loaded
+     */
+    getGLTF() {
+        return this.gltf;
+    }
+    /**
+     * Gets the loaded animations from the GLTF model
+     * @returns The loaded animations, or an empty array if no animations are loaded
+     */
+    getAnimations() {
+        return this.gltf?.animations ?? [];
+    }
+    /**
+     * Finds and returns the first skinned mesh in the model, if any
+     * @returns An object containing the skinned mesh and its skeleton, or null if none found
+     */
+    getSkinnedMeshData() {
+        if (!this.model)
+            return null;
+        return this.getAllSkinnedMeshes()[0] ?? null;
+    }
+    /**
+     * Finds all skinned meshes in the model
+     * @returns Array of objects containing skinned meshes and their skeletons
+     */
+    getAllSkinnedMeshes() {
+        if (!this.model)
+            return [];
+        const results = [];
+        for (const mesh of this.getAllMeshes()) {
+            if (mesh instanceof THREE.SkinnedMesh) {
+                if (mesh.skeleton && mesh.skeleton.bones && mesh.skeleton.bones.length > 0) {
+                    results.push({
+                        skinnedMesh: mesh,
+                        skeleton: mesh.skeleton
+                    });
+                }
+            }
+        }
+        return results;
+    }
+    /**
+     * Returns the first mesh in the model, if any
+     * @returns The first mesh, or null if no mesh found
+     */
+    getMesh() {
+        return this.getAllMeshes()[0] ?? null;
+    }
+    /**
+     * Returns all meshes in the model
+     * @returns Array of meshes
+     */
+    getAllMeshes() {
+        const meshes = [];
+        this.model?.traverse((object) => {
+            if (object instanceof THREE.Mesh) {
+                meshes.push(object);
+            }
+        });
+        return meshes;
+    }
+    /**
+       * Checks if the model has been successfully loaded
+       * @returns true if the model is loaded, false otherwise
+       */
+    isModelLoaded() {
+        return !!this.model;
+    }
+    onEditorPropertyChanged(path, value, result) {
+        super.onEditorPropertyChanged(path, value, result);
+        if (path === 'modelUrl') {
+            this.loadModel(AssetPath.fromString(value));
+        }
+        else if (path === 'material') {
+            this.setMaterial(value);
+        }
+        else if (path.startsWith('materials')) {
+            // If material (singular) is set, it takes precedence
+            if (!this.options.material && this.options.materials) {
+                this.setMaterials(this.options.materials);
+            }
+        }
+    }
+    calcBoundingBox() {
+        console.log('Calculating bounding box for GLTFMeshComponent', this.getActor()?.editorData?.displayName);
+        this._boundingBox = GLTFMeshComponent_1.calcBoundingBoxFromGLTFModel(this.getModel(), this.getActor()?.editorData?.displayName);
+    }
+    static calcBoundingBoxFromGLTF(gltf) {
+        if (!gltf || !gltf.scene) {
+            console.warn('GLTFMeshComponent: No GLTF scene available to calculate bounding box. Has the model finished loading?');
+            return new THREE.Box3();
+        }
+        return GLTFMeshComponent_1.calcBoundingBoxFromGLTFModel(gltf.scene);
+    }
+    static calcBoundingBoxFromGLTFModel(gltfScene, context) {
+        if (!gltfScene) {
+            console.warn('GLTFMeshComponent: No GLTF scene available to calculate bounding box. Has the model finished loading?', context);
+            return new THREE.Box3();
+        }
+        const boundingBox = new THREE.Box3();
+        gltfScene.traverse((child) => {
+            if (child instanceof THREE.Mesh) {
+                child.updateMatrixWorld(true);
+                child.geometry.computeBoundingBox();
+                const box = new THREE.Box3();
+                box.copy(child.geometry.boundingBox);
+                box.applyMatrix4(child.matrixWorld);
+                boundingBox.union(box);
+            }
+        });
+        return boundingBox;
+    }
+    describe(options) {
+        const result = super.describe(options);
+        if (options?.includeDetails) {
+            result.modelUrl = this.options.modelUrl;
+            result.material = this.options.material;
+            result.materials = this.options.materials;
+            result.useDynamicMaterials = this.options.useDynamicMaterials;
+        }
+        ;
+        return result;
+    }
+    //====================================================================================================
+    // Editor Functions
+    //====================================================================================================
+    getEditorClassIcon() {
+        return 'Icon_GLTFMesh';
+    }
+};
+_a = IAsyncLoadableTag;
+Object.defineProperty(GLTFMeshComponent, "EDITOR_CLASS_META", {
+    enumerable: true,
+    configurable: true,
+    writable: true,
+    value: {
+        ...PrimitiveComponent.EDITOR_CLASS_META,
+        modelUrl: { type: ['model'] },
+        material: { type: ['material'] },
+        materials: { array: { child: { type: ['material'] } } },
+    }
+});
+GLTFMeshComponent = GLTFMeshComponent_1 = __decorate([
+    EngineClass('GLTFMeshComponent'),
+    __metadata("design:paramtypes", [Object])
+], GLTFMeshComponent);
+export { GLTFMeshComponent };
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiR0xURk1lc2hDb21wb25lbnQuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi8uLi8uLi9zcmMvY29tcG9uZW50cy92aXN1YWwvR0xURk1lc2hDb21wb25lbnQudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6Ijs7Ozs7Ozs7Ozs7QUFpQkEsT0FBTyxLQUFLLEtBQUssTUFBTSxPQUFPLENBQUM7QUFDL0IsT0FBTyxLQUFLLGFBQWEsTUFBTSwyQ0FBMkMsQ0FBQztBQUUzRSxPQUFPLEVBQUUsZ0JBQWdCLEVBQUUsTUFBTSxnQkFBZ0IsQ0FBQztBQUNsRCxPQUFPLEVBQUUsU0FBUyxFQUFFLE1BQU0sa0NBQWtDLENBQUM7QUFDN0QsT0FBTyxFQUFFLFdBQVcsRUFBRSxNQUFNLGdDQUFnQyxDQUFDO0FBQzdELE9BQU8sRUFBRSxRQUFRLEVBQUUsTUFBTSx5QkFBeUIsQ0FBQztBQUNuRCxPQUFPLEVBQUUsZUFBZSxFQUFFLGlCQUFpQixFQUFFLE1BQU0sK0JBQStCLENBQUM7QUFDbkYsT0FBTyxFQUFFLGVBQWUsRUFBRSxNQUFNLGdDQUFnQyxDQUFDO0FBQ2pFLE9BQU8sRUFBRSxNQUFNLEVBQUUsTUFBTSxzQkFBc0IsQ0FBQztBQUM5QyxPQUFPLEVBQUUsa0JBQWtCLEVBQUUsTUFBTSwwQkFBMEIsQ0FBQztBQW9CdkQsSUFBTSxpQkFBaUIseUJBQXZCLE1BQU0saUJBQWtCLFNBQVEsa0JBQTRDO0lBaUJqRixNQUFNLEtBQWMsZUFBZTtRQUNqQyxPQUFPO1lBQ0wsR0FBRyxrQkFBa0IsQ0FBQyxlQUFlO1lBQ3JDLFFBQVEsRUFBRSxTQUFTO1lBQ25CLFFBQVEsRUFBRSxTQUFTO1lBQ25CLFNBQVMsRUFBRSxTQUFTO1lBQ3BCLHFCQUFxQixFQUFFLEtBQUs7WUFDNUIsbUJBQW1CLEVBQUUsS0FBSztTQUMzQixDQUFDO0lBQ0osQ0FBQztJQUVEOzs7U0FHSztJQUNMLFlBQVksVUFBb0MsRUFBRTtRQUNoRCxLQUFLLENBQUMsT0FBTyxDQUFDLENBQUM7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

package/dist/src/components/visual/InstancedGltfMeshComponent.d.ts

@@ -0,0 +1,75 @@
+/**
+ * InstancedGltfMeshComponent loads a GLTF model and creates instanced meshes for each child mesh.
+ *
+ * This component automatically loads a GLTF model and creates one THREE.InstancedMesh for each
+ * mesh found in the model. This is ideal for rendering large numbers of complex models
+ * efficiently, such as trees, buildings, or other detailed objects that contain multiple
+ * sub-meshes.
+ *
+ * The component manages instance matrices and colors internally, providing methods
+ * to update individual instances or all instances at once across all child meshes.
+ *
+ * Recommended usage (for humans and AI assistants):
+ * - Use when you need to render many copies of a complex GLTF model efficiently.
+ * - Perfect for vegetation, buildings, vehicles, or any detailed models with multiple parts.
+ * - Each child mesh in the GLTF becomes its own instanced mesh for optimal performance.
+ * - Call updateInstanceMatrix() after modifying instance transforms.
+ * - Use setInstanceColor() for per-instance color variations.
+ */
+import * as THREE from 'three';
+import { IAsyncLoadableTag } from '../../utils/IAsyncLoadable.js';
+import { BaseInstancedMeshComponent } from './BaseInstancedMeshComponent.js';
+import type { BaseInstancedMeshComponentOptions } from './BaseInstancedMeshComponent.js';
+import type { EditorClassMeta, EditorPropertyChangedResult } from '../../utils/EditorClassMeta.js';
+import type { IAsyncLoadable } from '../../utils/IAsyncLoadable.js';
+export interface InstancedGltfMeshComponentOptions extends BaseInstancedMeshComponentOptions {
+    modelUrl?: string;
+}
+export declare class InstancedGltfMeshComponent extends BaseInstancedMeshComponent<InstancedGltfMeshComponentOptions> implements IAsyncLoadable {
+    readonly [IAsyncLoadableTag] = true;
+    private _modelUrl;
+    private modelTemplate;
+    private _asyncTaskWorker;
+    static readonly EDITOR_CLASS_META: EditorClassMeta;
+    static get DEFAULT_OPTIONS(): InstancedGltfMeshComponentOptions;
+    /**
+     * Creates a new InstancedGltfMeshComponent with the specified options
+     * @param options Configuration options for the instanced GLTF mesh component
+     */
+    constructor(options?: InstancedGltfMeshComponentOptions);
+    /**
+     * Gets the current model URL
+     * @returns The model URL or null if not set
+     */
+    getModelUrl(): string | null;
+    /**
+       * Gets the loaded THREE.Group model instance
+       * @returns The loaded model group, or null if no model is loaded
+       */
+    getModelTemplate(): THREE.Object3D | null;
+    /**
+     * Sets the model URL and loads the new model
+     * @param modelUrl The URL or AssetPath to the GLTF model
+     */
+    setModelUrl(modelUrl: string): Promise<void>;
+    /**
+     * Checks if the model is currently loading
+     * @returns True if the model is loading, false otherwise
+     */
+    isLoading(): boolean;
+    /**
+     * Waits for the current model loading to complete
+     * @returns Promise that resolves when loading is complete
+     */
+    waitForLoad(): Promise<void>;
+    /**
+     * Loads the GLTF model and creates instanced meshes for each child mesh
+     */
+    private loadModel;
+    /**
+     * Performs the actual model loading and mesh creation
+     */
+    private _internalPerformModelLoad;
+    onEditorPropertyChanged(path: string, value: any, result: EditorPropertyChangedResult): void;
+    getEditorClassIcon(): string | null;
+}