gltf-parser-plugin 1.1.3 → 1.1.5

package/build/index.d.ts

@@ -1,4 +1,5 @@
 import { Box3 } from 'three';
+import { Color } from 'three';
 import { EventDispatcher } from 'three';
 import { Intersection } from 'three';
 import { Material } from 'three';
@@ -8,6 +9,8 @@ import { TilesRenderer } from '3d-tiles-renderer';
 import { Vector3 } from 'three';
 import { WebGLRenderer } from 'three';
 
+export declare type ColorInput = number | string | Color;
+
 /**
  * Hit object feature information interface
  */
@@ -31,11 +34,8 @@ export declare class GLTFParserPlugin implements MeshHelperHost {
     private _structurePromise;
     private _modelInfo;
     private _modelInfoPromise;
-    private _frozenOids;
-    private _isolatedOids;
-    private _trackedMeshes;
-    private _meshListeners;
-    private _isPluginRemoving;
+    private _interactionFilter;
+    private _componentColorHelper;
     oids: number[];
     private renderer;
     private splitMeshCache;
@@ -80,9 +80,6 @@ export declare class GLTFParserPlugin implements MeshHelperHost {
      * 首次调用时会自动请求
      */
     getStructureData(): Promise<StructureData | null>;
-    private _pointInPolygon;
-    private _segmentsIntersect;
-    private _polygonIntersectsRect;
     /**
      * 选择包围盒范围内的构件（包含相交和包含两种情况）
      * @param box 查询用的 Box3 范围，坐标系与 structure.json 中 bbox 一致
@@ -134,58 +131,17 @@ export declare class GLTFParserPlugin implements MeshHelperHost {
      * 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 数组
@@ -205,6 +161,30 @@ export declare class GLTFParserPlugin implements MeshHelperHost {
      * Restore the display of the corresponding mesh according to the OID array
      */
     unhideByOids(oids: number[]): void;
+    /**
+     * 根据 oid 数组设置构件颜色
+     * 隐藏原 mesh，将 split mesh 替换材质后加入场景（使用 tiles.group）
+     * @param oids 构件 OID 数组
+     * @param color 颜色值，支持 hex 数字、颜色字符串（如 "#ff0000"）、THREE.Color 对象
+     */
+    setComponentColorByOids(oids: number[], color: ColorInput): void;
+    /**
+     * 恢复指定构件的颜色
+     * 从场景移除 split mesh，unhide 原 mesh
+     * @param oids 构件 OID 数组
+     */
+    restoreComponentColorByOids(oids: number[]): void;
+    /**
+     * 根据 oid 数组设置构件透明度
+     * @param oids 构件 OID 数组
+     * @param opacity 透明度，0-1，0 完全透明，1 完全不透明
+     */
+    setComponentOpacityByOids(oids: number[], opacity: number): void;
+    /**
+     * 恢复指定构件的透明度
+     * @param oids 构件 OID 数组
+     */
+    restoreComponentOpacityByOids(oids: number[]): void;
     /**
      * Restore the original materials of the mesh
      */

package/package.json

@@ -1,47 +1,47 @@
-{
-  "name": "gltf-parser-plugin",
-  "version": "1.1.3",
-  "description": "A plugin for parsing GLTF files",
-  "type": "module",
-  "main": "./build/gltf-parser-plugin.module.js",
-  "module": "./build/gltf-parser-plugin.module.js",
-  "types": "./build/index.d.ts",
-  "exports": {
-    ".": {
-      "import": "./build/gltf-parser-plugin.module.js",
-      "types": "./build/index.d.ts"
-    }
-  },
-  "files": [
-    "build"
-  ],
-  "scripts": {
-    "dev": "vite build --watch",
-    "serve": "vite",
-    "build": "tsc && vite build",
-    "test": "vitest",
-    "test:watch": "vitest --watch",
-    "type-check": "tsc --noEmit",
-    "lint": "eslint src --ext .ts,.tsx",
-    "prepublishOnly": "pnpm run build"
-  },
-  "author": "maptalks",
-  "license": "MIT",
-  "devDependencies": {
-    "@types/node": "^25.4.0",
-    "@types/three": "^0.183.1",
-    "@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.22",
-    "@maptalks/gltf-loader": "^0.124.4",
-    "@maptalks/transcoders.draco": "^0.124.4",
-    "three": "^0.183.2"
-  }
-}
+{
+  "name": "gltf-parser-plugin",
+  "version": "1.1.5",
+  "description": "A plugin for parsing GLTF files",
+  "type": "module",
+  "main": "./build/gltf-parser-plugin.module.js",
+  "module": "./build/gltf-parser-plugin.module.js",
+  "types": "./build/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./build/gltf-parser-plugin.module.js",
+      "types": "./build/index.d.ts"
+    }
+  },
+  "files": [
+    "build"
+  ],
+  "scripts": {
+    "dev": "vite build --watch",
+    "serve": "vite",
+    "build": "tsc && vite build",
+    "test": "vitest",
+    "test:watch": "vitest --watch",
+    "type-check": "tsc --noEmit",
+    "lint": "eslint src --ext .ts,.tsx",
+    "prepublishOnly": "pnpm run build"
+  },
+  "author": "maptalks",
+  "license": "MIT",
+  "devDependencies": {
+    "@types/node": "^25.4.0",
+    "@types/three": "^0.183.1",
+    "@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.22",
+    "@maptalks/gltf-loader": "^0.124.4",
+    "@maptalks/transcoders.draco": "^0.124.4",
+    "three": "^0.183.2"
+  }
+}