gltf-parser-plugin 1.1.0 → 1.1.2

package/build/index.d.ts

@@ -1,9 +1,11 @@
+import { Box3 } from 'three';
 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 { Vector2 } from 'three';
 import { WebGLRenderer } from 'three';
 
 /**
@@ -27,6 +29,13 @@ export declare class GLTFParserPlugin implements MeshHelperHost {
     private _structureData;
     private _oidNodeMap;
     private _structurePromise;
+    private _modelInfo;
+    private _modelInfoPromise;
+    private _frozenOids;
+    private _isolatedOids;
+    private _trackedMeshes;
+    private _meshListeners;
+    private _isPluginRemoving;
     oids: number[];
     private renderer;
     private splitMeshCache;
@@ -71,6 +80,34 @@ export declare class GLTFParserPlugin implements MeshHelperHost {
      * 首次调用时会自动请求
      */
     getStructureData(): Promise<StructureData | null>;
+    private _pointInPolygon;
+    private _segmentsIntersect;
+    private _polygonIntersectsRect;
+    /**
+     * 选择包围盒范围内的构件（包含相交和包含两种情况）
+     * @param box 查询用的 Box3 范围，坐标系与 structure.json 中 bbox 一致
+     * @returns 范围内所有构件的 oid 数组
+     */
+    selectByBox(box: Box3): Promise<number[]>;
+    /**
+     * 选择多边形（平面投影）范围内的构件（包含相交和包含两种情况）
+     * @param polygon 多边形顶点数组（Vector2），按顺序连接构成闭合多边形
+     * @param axis 投影平面，决定使用 bbox 的哪两个轴做 2D 判定
+     *   - 'xz'（默认）：俯视图，取 bbox 的 x/z 坐标
+     *   - 'xy'：正视图，取 bbox 的 x/y 坐标
+     *   - 'yz'：侧视图，取 bbox 的 y/z 坐标
+     * @returns 范围内所有构件的 oid 数组
+     */
+    selectByPolygon(polygon: Vector2[], axis?: "xy" | "xz" | "yz"): Promise<number[]>;
+    private _getModelInfoUrl;
+    private _fetchModelInfo;
+    private _ensureModelInfoLoaded;
+    /**
+     * 获取 modelInfo.json 数据
+     * 包含模型的基本信息：动画支持、材质数量、顶点数、三角形数等
+     * 首次调用时会自动从 tileset URL 推导并请求 modelInfo.json
+     */
+    getModelInfo(): Promise<ModelInfo | null>;
     /**
      * Load model callback
      */
@@ -94,8 +131,62 @@ export declare class GLTFParserPlugin implements MeshHelperHost {
     private _setupMaterial;
     /**
      * Query feature information from intersection
+     * Respects freeze and isolate filters
      */
     queryFeatureFromIntersection(hit: Intersection): FeatureInfo;
+    private _isOidBlocked;
+    private _trackMesh;
+    private _untrackMesh;
+    private _onCollectorMeshChange;
+    private _syncCollectorMeshes;
+    /**
+     * 冻结指定构件，被冻结的构件不再响应任何交互和事件
+     */
+    freezeByOids(oids: number[]): void;
+    /**
+     * 冻结单个构件
+     */
+    freezeByOid(oid: number): void;
+    /**
+     * 解冻指定构件
+     */
+    unfreezeByOids(oids: number[]): void;
+    /**
+     * 解冻单个构件
+     */
+    unfreezeByOid(oid: number): void;
+    /**
+     * 解冻全部构件
+     */
+    unfreeze(): void;
+    /**
+     * 获取当前被冻结的 OID 数组
+     */
+    getFrozenOids(): number[];
+    /**
+     * 隔离指定构件，隔离模式下只有被隔离的构件才能响应交互和事件
+     */
+    isolateByOids(oids: number[]): void;
+    /**
+     * 往隔离集合中添加单个构件
+     */
+    isolateByOid(oid: number): void;
+    /**
+     * 取消隔离指定构件
+     */
+    unisolateByOids(oids: number[]): void;
+    /**
+     * 从隔离集合中移除单个构件
+     */
+    unisolateByOid(oid: number): void;
+    /**
+     * 取消全部隔离，恢复所有构件的交互能力
+     */
+    unisolate(): void;
+    /**
+     * 获取当前被隔离的 OID 数组
+     */
+    getIsolatedOids(): number[];
     /**
      * 内部方法：根据 oid 获取 mesh 数组
      */
@@ -198,6 +289,19 @@ declare interface MeshHelperHost {
     _getMeshesByOidInternal(oid: number): Mesh[];
 }
 
+/**
+ * modelInfo.json 的数据结构
+ */
+export declare interface ModelInfo {
+    animatable: boolean;
+    images: number;
+    materials: number;
+    pbr: boolean;
+    textures: number;
+    triangles: number;
+    vertices: number;
+}
+
 /**
  * structure.json 的完整数据结构
  */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "gltf-parser-plugin",
-  "version": "1.1.0",
+  "version": "1.1.2",
   "description": "A plugin for parsing GLTF files",
   "type": "module",
   "main": "./build/gltf-parser-plugin.module.js",
@@ -28,20 +28,20 @@
   "author": "maptalks",
   "license": "MIT",
   "devDependencies": {
-    "@types/node": "^25.3.3",
+    "@types/node": "^25.4.0",
     "@types/three": "^0.183.1",
-    "@typescript-eslint/eslint-plugin": "^8.56.1",
-    "@typescript-eslint/parser": "^8.56.1",
-    "eslint": "^10.0.2",
+    "@typescript-eslint/eslint-plugin": "^8.57.0",
+    "@typescript-eslint/parser": "^8.57.0",
+    "eslint": "^10.0.3",
     "typescript": "^5.9.3",
     "vite": "^7.3.1",
     "vite-plugin-dts": "^4.5.4",
     "vitest": "^4.0.18"
   },
   "dependencies": {
-    "3d-tiles-renderer": "^0.4.21",
-    "@maptalks/gltf-loader": "^0.124.3",
-    "@maptalks/transcoders.draco": "^0.124.3",
+    "3d-tiles-renderer": "^0.4.22",
+    "@maptalks/gltf-loader": "^0.124.4",
+    "@maptalks/transcoders.draco": "^0.124.4",
     "three": "^0.183.2"
   }
 }