gltf-parser-plugin 1.0.7 → 1.0.9

package/build/index.d.ts

@@ -1,12 +1,36 @@
+import { EventDispatcher } from 'three';
+import { Intersection } from 'three';
 import { Material } from 'three';
+import { Mesh } from 'three';
 import { Texture } from 'three';
+import { TilesRenderer } from '3d-tiles-renderer';
+import { WebGLRenderer } from 'three';
 
-export declare class GLTFParserPlugin {
+/**
+ * Hit object feature information interface
+ */
+export declare interface FeatureInfo {
+    oid?: number;
+    featureId?: number;
+    features?: number[];
+    propertyData?: object;
+    isValid: boolean;
+    error?: string;
+}
+
+export declare class GLTFParserPlugin implements MeshHelperHost {
     name: string;
     private tiles;
     private _loader;
     private readonly _gltfRegex;
     private readonly _options;
+    oids: number[];
+    private renderer;
+    private splitMeshCache;
+    private maxUniformVectors;
+    private featureIdCount;
+    private collectors;
+    private collectorCache;
     /**
      * Create a GLTFParserPlugin instance
      * @param options configuration options
@@ -15,14 +39,9 @@ export declare class GLTFParserPlugin {
     /**
      * Plugin initialization, called by TilesRenderer
      */
-    init(tiles: any): void;
+    init(tiles: TilesRenderer): void;
     /**
      * Fetch tile data with IndexedDB caching support
-     * If data exists in IndexedDB, return cached data without network request
-     * If not cached, fetch from network and store in IndexedDB
-     * @param url The processed URL (used as cache key)
-     * @param options Fetch options
-     * @returns Cached data (ArrayBuffer for binary, parsed JSON for .json) or Response on error
      */
     fetchData(url: string, options?: RequestInit): Promise<Response | ArrayBuffer | object>;
     /**
@@ -30,6 +49,57 @@ export declare class GLTFParserPlugin {
      */
     clearCache(): Promise<void>;
     parseTile(buffer: ArrayBuffer, tile: any, extension: any, uri: string, abortSignal: AbortSignal): Promise<any>;
+    /**
+     * Load model callback
+     */
+    private _onLoadModelCB;
+    /**
+     * Tiles load end callback
+     */
+    private _onTilesLoadEndCB;
+    private _onLoadModel;
+    private _notifyCollectors;
+    _registerCollector(collector: MeshCollector): void;
+    _unregisterCollector(collector: MeshCollector): void;
+    private _updateWebGLLimits;
+    /**
+     * Dynamically calculate FEATURE_ID_COUNT based on WebGL limits and current oid count
+     */
+    private _calculateFeatureIdCount;
+    /**
+     * Set up shader modification for hiding specific features
+     */
+    private _setupMaterial;
+    /**
+     * Query feature information from intersection
+     */
+    queryFeatureFromIntersection(hit: Intersection): FeatureInfo;
+    /**
+     * 内部方法：根据 oid 获取 mesh 数组
+     */
+    _getMeshesByOidInternal(oid: number): Mesh[];
+    /**
+     * 根据 oid 获取 MeshCollector
+     * MeshCollector 会监听瓦片变化，自动更新 meshes 并触发 mesh-change 事件
+     * 内部缓存：相同 oid 多次调用会返回同一个 collector 实例
+     */
+    getMeshCollectorByOid(oid: number): MeshCollector;
+    /**
+     * Hide the corresponding part of the original mesh according to the OID array
+     */
+    hideByOids(oids: number[]): void;
+    /**
+     * Restore the display of the corresponding mesh according to the OID array
+     */
+    unhideByOids(oids: number[]): void;
+    /**
+     * Restore the original materials of the mesh
+     */
+    unhide(): void;
+    /**
+     * Get the current feature ID count
+     */
+    getFeatureIdCount(): number;
     /**
      * Plugin disposal
      */
@@ -39,7 +109,11 @@ export declare class GLTFParserPlugin {
 /**
  * GLTFParserPlugin configuration options
  */
-declare interface GLTFParserPluginOptions {
+export declare interface GLTFParserPluginOptions {
+    /**
+     * WebGLRenderer instance, required for mesh helper features (hideByOids, etc.)
+     */
+    renderer?: WebGLRenderer;
     /**
      * Whether to enable metadata support
      * Includes EXT_mesh_features and EXT_structural_metadata extensions
@@ -71,4 +145,35 @@ declare interface GLTFParserPluginOptions {
 
 declare type MaterialBuilder = (matData: unknown, textureMap: Map<number, Texture>) => Material;
 
+export declare interface MeshChangeEvent {
+    type: "mesh-change";
+    meshes: Mesh[];
+}
+
+/**
+ * MeshCollector - 用于监听和收集特定 oid 对应的 mesh
+ * 随着瓦片变化，会自动更新 meshes 并触发 mesh-change 事件
+ */
+export declare class MeshCollector extends EventDispatcher<MeshCollectorEventMap> {
+    private oid;
+    private plugin;
+    private _meshes;
+    private _disposed;
+    constructor(oid: number, plugin: MeshHelperHost);
+    get meshes(): Mesh[];
+    _updateMeshes(): void;
+    getOid(): number;
+    dispose(): void;
+}
+
+export declare type MeshCollectorEventMap = {
+    "mesh-change": MeshChangeEvent;
+};
+
+declare interface MeshHelperHost {
+    _registerCollector(collector: MeshCollector): void;
+    _unregisterCollector(collector: MeshCollector): void;
+    _getMeshesByOidInternal(oid: number): Mesh[];
+}
+
 export { }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "gltf-parser-plugin",
-  "version": "1.0.7",
+  "version": "1.0.9",
   "description": "A plugin for parsing GLTF files",
   "type": "module",
   "main": "./build/gltf-parser-plugin.module.js",
@@ -28,7 +28,7 @@
   "author": "maptalks",
   "license": "MIT",
   "devDependencies": {
-    "@types/node": "^25.3.0",
+    "@types/node": "^25.3.3",
     "@types/three": "^0.183.1",
     "@typescript-eslint/eslint-plugin": "^8.56.1",
     "@typescript-eslint/parser": "^8.56.1",
@@ -42,6 +42,6 @@
     "3d-tiles-renderer": "^0.4.21",
     "@maptalks/gltf-loader": "^0.124.3",
     "@maptalks/transcoders.draco": "^0.124.3",
-    "three": "^0.183.1"
+    "three": "^0.183.2"
   }
 }