gltf-parser-plugin 1.1.6 → 1.1.7

package/build/gltf-parser-plugin.module.js

@@ -1512,7 +1512,7 @@ var GLTFWorkerLoader = class extends Loader {
 };
 //#endregion
 //#region src/plugin/PartColorHelper.ts
-function ensureColor$1(color) {
+function ensureColor$2(color) {
 	if (color instanceof Color) return color;
 	return new Color(color);
 }
@@ -1533,7 +1533,7 @@ function getMaterialForColor(color) {
 }
 var materialCache = /* @__PURE__ */ new Map();
 /**
-* 构件着色/透明度辅助器，参考 example 逻辑：hideByOids -> 修改材质 -> scene.add -> mesh-change 监听
+* 构件着色/透明度辅助器，参考 example 逻辑：hidePartsByOids -> 修改材质 -> scene.add -> mesh-change 监听
 * 由 GLTFParserPlugin 内部使用，scene 通过 tiles.group 获取
 */
 var PartColorHelper = class {
@@ -1573,7 +1573,7 @@ var PartColorHelper = class {
 	setPartColorByOids(oids, color) {
 		const scene = this.context.getScene();
 		if (!scene) return;
-		const material = getMaterialForColor(ensureColor$1(color));
+		const material = getMaterialForColor(ensureColor$2(color));
 		for (const oid of oids) {
 			this.coloredOids.add(oid);
 			this.materialByOid.set(oid, material);
@@ -1589,7 +1589,7 @@ var PartColorHelper = class {
 				collector.addEventListener("mesh-change", handler);
 			}
 		}
-		this.context.hideByOids(this.getAllModifiedOids());
+		this.context.hidePartsByOids(this.getAllModifiedOids());
 	}
 	/**
 	* 恢复指定构件的颜色
@@ -1624,7 +1624,7 @@ var PartColorHelper = class {
 				}
 			}
 		}
-		this.context.unhideByOids(oids);
+		this.context.showPartsByOids(oids);
 	}
 	/**
 	* 根据 oid 数组设置构件透明度
@@ -1662,7 +1662,7 @@ var PartColorHelper = class {
 				collector.addEventListener("mesh-change", handler);
 			}
 		}
-		this.context.hideByOids(this.getAllModifiedOids());
+		this.context.hidePartsByOids(this.getAllModifiedOids());
 	}
 	/**
 	* 恢复指定构件的透明度
@@ -1694,18 +1694,18 @@ var PartColorHelper = class {
 				}
 			}
 		}
-		this.context.unhideByOids(oids);
+		this.context.showPartsByOids(oids);
 	}
 };
 //#endregion
 //#region src/plugin/PartBlinkHelper.ts
-function ensureColor(color) {
+function ensureColor$1(color) {
 	if (color instanceof Color) return color;
 	return new Color(color);
 }
 /**
 * 构件闪烁强调辅助器
-* 通过 hideByOids + split mesh + emissive 动画实现闪烁效果
+* 通过 hidePartsByOids + split mesh + emissive 动画实现闪烁效果
 */
 var PartBlinkHelper = class {
 	blinkOids = /* @__PURE__ */ new Set();
@@ -1778,7 +1778,7 @@ var PartBlinkHelper = class {
 			this.meshChangeHandlers.set(oid, handler);
 			collector.addEventListener("mesh-change", handler);
 		}
-		this.context.hideByOids(Array.from(this.blinkOids));
+		this.context.hidePartsByOids(Array.from(this.blinkOids));
 		if (this.blinkOids.size > 0) this.startAnimation();
 	}
 	/**
@@ -1786,7 +1786,7 @@ var PartBlinkHelper = class {
 	* @param color 颜色值，支持 hex 数字、颜色字符串（如 "#ff0000"）、THREE.Color 对象
 	*/
 	setBlinkColor(color) {
-		const c = ensureColor(color);
+		const c = ensureColor$1(color);
 		this.blinkColor.copy(c);
 		this.blinkMaterial.color.copy(c);
 		this.blinkMaterial.emissive.copy(c);
@@ -1823,7 +1823,7 @@ var PartBlinkHelper = class {
 			}
 		}
 		this.blinkOids.clear();
-		this.context.unhideByOids(oidsToUnhide);
+		this.context.showPartsByOids(oidsToUnhide);
 	}
 	dispose() {
 		this.clearAllBlinkParts();
@@ -1831,43 +1831,60 @@ var PartBlinkHelper = class {
 };
 //#endregion
 //#region src/plugin/PartFrameHelper.ts
+function ensureColor(color) {
+	if (color instanceof Color) return color;
+	return new Color(color);
+}
 /**
 * 构件线框显示辅助器
-* 通过 hideByOids + split mesh + 填充材质 + EdgesGeometry 实现线框效果
+* 通过 hidePartsByOids + split mesh + 填充材质 + EdgesGeometry 实现线框效果
 */
+var DEFAULT_FRAME_COLOR = 54442;
 var PartFrameHelper = class {
 	frameOids = /* @__PURE__ */ new Set();
 	originalMaterialByMesh = /* @__PURE__ */ new Map();
 	frameDataByOid = /* @__PURE__ */ new Map();
 	meshChangeHandlers = /* @__PURE__ */ new Map();
-	fillMaterial;
-	edgeMaterial;
+	fillColorByOid = /* @__PURE__ */ new Map();
+	edgeColorByOid = /* @__PURE__ */ new Map();
+	fillMaterialCache = /* @__PURE__ */ new Map();
+	edgeMaterialCache = /* @__PURE__ */ new Map();
 	edgeThreshold;
 	constructor(context) {
 		this.context = context;
-		this.fillMaterial = new MeshBasicMaterial({
-			color: 54442,
+		this.edgeThreshold = 15;
+	}
+	getFillMaterial(hex) {
+		if (!this.fillMaterialCache.has(hex)) this.fillMaterialCache.set(hex, new MeshBasicMaterial({
+			color: hex,
 			transparent: true,
 			opacity: .3,
 			side: DoubleSide,
 			depthWrite: false
-		});
-		this.edgeMaterial = new MeshBasicMaterial({
-			color: 54442,
+		}));
+		return this.fillMaterialCache.get(hex);
+	}
+	getEdgeMaterial(hex) {
+		if (!this.edgeMaterialCache.has(hex)) this.edgeMaterialCache.set(hex, new MeshBasicMaterial({
+			color: hex,
 			transparent: true,
 			opacity: .8
-		});
-		this.edgeThreshold = 15;
+		}));
+		return this.edgeMaterialCache.get(hex);
 	}
-	createWireframeForMeshes(meshes, scene) {
+	createWireframeForMeshes(meshes, scene, oid) {
+		const fillHex = this.fillColorByOid.get(oid) ?? DEFAULT_FRAME_COLOR;
+		const edgeHex = this.edgeColorByOid.get(oid) ?? DEFAULT_FRAME_COLOR;
+		const fillMaterial = this.getFillMaterial(fillHex);
+		const edgeMaterial = this.getEdgeMaterial(edgeHex);
 		const frameMeshes = [];
 		const lines = [];
 		for (const mesh of meshes) {
 			if (!this.originalMaterialByMesh.has(mesh.uuid)) this.originalMaterialByMesh.set(mesh.uuid, mesh.material);
-			mesh.material = this.fillMaterial;
+			mesh.material = fillMaterial;
 			scene.add(mesh);
 			frameMeshes.push(mesh);
-			const line = new LineSegments(new EdgesGeometry(mesh.geometry, this.edgeThreshold), this.edgeMaterial);
+			const line = new LineSegments(new EdgesGeometry(mesh.geometry, this.edgeThreshold), edgeMaterial);
 			line.matrix.copy(mesh.matrixWorld);
 			line.matrixAutoUpdate = false;
 			scene.add(line);
@@ -1898,7 +1915,7 @@ var PartFrameHelper = class {
 		const collector = this.context.getMeshCollectorByOid(oid);
 		const oldData = this.frameDataByOid.get(oid);
 		if (oldData) this.removeFrameData(oldData, scene);
-		const newData = this.createWireframeForMeshes(collector.meshes, scene);
+		const newData = this.createWireframeForMeshes(collector.meshes, scene, oid);
 		this.frameDataByOid.set(oid, newData);
 	}
 	/**
@@ -1912,13 +1929,13 @@ var PartFrameHelper = class {
 		for (const oid of oids) {
 			this.frameOids.add(oid);
 			const collector = this.context.getMeshCollectorByOid(oid);
-			const data = this.createWireframeForMeshes(collector.meshes, scene);
+			const data = this.createWireframeForMeshes(collector.meshes, scene, oid);
 			this.frameDataByOid.set(oid, data);
 			const handler = () => this.applyFrameToOid(oid);
 			this.meshChangeHandlers.set(oid, handler);
 			collector.addEventListener("mesh-change", handler);
 		}
-		this.context.hideByOids(Array.from(this.frameOids));
+		this.context.hidePartsByOids(Array.from(this.frameOids));
 	}
 	/**
 	* 清除所有线框显示构件
@@ -1940,10 +1957,42 @@ var PartFrameHelper = class {
 			}
 		}
 		this.frameOids.clear();
-		this.context.unhideByOids(oidsToUnhide);
+		this.fillColorByOid.clear();
+		this.edgeColorByOid.clear();
+		this.context.showPartsByOids(oidsToUnhide);
+	}
+	/**
+	* 设置指定构件的线框填充颜色
+	* @param oids 构件 OID 数组
+	* @param color 颜色值，支持 hex 数字、颜色字符串（如 "#ff0000"）、THREE.Color 对象
+	*/
+	setFrameFillColor(oids, color) {
+		const hex = ensureColor(color).getHex();
+		for (const oid of oids) {
+			if (!this.frameOids.has(oid)) continue;
+			this.fillColorByOid.set(oid, hex);
+			this.applyFrameToOid(oid);
+		}
+	}
+	/**
+	* 设置指定构件的线框边框颜色
+	* @param oids 构件 OID 数组
+	* @param color 颜色值，支持 hex 数字、颜色字符串（如 "#ff0000"）、THREE.Color 对象
+	*/
+	setFrameEdgeColor(oids, color) {
+		const hex = ensureColor(color).getHex();
+		for (const oid of oids) {
+			if (!this.frameOids.has(oid)) continue;
+			this.edgeColorByOid.set(oid, hex);
+			this.applyFrameToOid(oid);
+		}
 	}
 	dispose() {
 		this.clearAllFrameParts();
+		this.fillMaterialCache.forEach((m) => m.dispose());
+		this.fillMaterialCache.clear();
+		this.edgeMaterialCache.forEach((m) => m.dispose());
+		this.edgeMaterialCache.clear();
 	}
 };
 //#endregion
@@ -2228,20 +2277,20 @@ var GLTFParserPlugin = class {
 	init(tiles) {
 		this.tiles = tiles;
 		this._partColorHelper = new PartColorHelper({
-			hideByOids: (oids) => this.hideByOids(oids),
-			unhideByOids: (oids) => this.unhideByOids(oids),
+			hidePartsByOids: (oids) => this.hidePartsByOids(oids),
+			showPartsByOids: (oids) => this.showPartsByOids(oids),
 			getMeshCollectorByOid: (oid) => this.getMeshCollectorByOid(oid),
 			getScene: () => this.tiles?.group ?? null
 		});
 		this._partBlinkHelper = new PartBlinkHelper({
-			hideByOids: (oids) => this.hideByOids(oids),
-			unhideByOids: (oids) => this.unhideByOids(oids),
+			hidePartsByOids: (oids) => this.hidePartsByOids(oids),
+			showPartsByOids: (oids) => this.showPartsByOids(oids),
 			getMeshCollectorByOid: (oid) => this.getMeshCollectorByOid(oid),
 			getScene: () => this.tiles?.group ?? null
 		});
 		this._partFrameHelper = new PartFrameHelper({
-			hideByOids: (oids) => this.hideByOids(oids),
-			unhideByOids: (oids) => this.unhideByOids(oids),
+			hidePartsByOids: (oids) => this.hidePartsByOids(oids),
+			showPartsByOids: (oids) => this.showPartsByOids(oids),
 			getMeshCollectorByOid: (oid) => this.getMeshCollectorByOid(oid),
 			getScene: () => this.tiles?.group ?? null
 		});
@@ -2596,14 +2645,14 @@ var GLTFParserPlugin = class {
 	/**
 	* Hide the corresponding part of the original mesh according to the OID array
 	*/
-	hideByOids(oids) {
+	hidePartsByOids(oids) {
 		this.oids = oids;
 		this.featureIdCount = this._calculateFeatureIdCount();
 	}
 	/**
 	* Restore the display of the corresponding mesh according to the OID array
 	*/
-	unhideByOids(oids) {
+	showPartsByOids(oids) {
 		const oidSet = new Set(oids);
 		this.oids = this.oids.filter((existingOid) => !oidSet.has(existingOid));
 		this.featureIdCount = this._calculateFeatureIdCount();
@@ -2619,7 +2668,7 @@ var GLTFParserPlugin = class {
 	}
 	/**
 	* 恢复指定构件的颜色
-	* 从场景移除 split mesh，unhide 原 mesh
+	* 从场景移除 split mesh，恢复原 mesh 显示
 	* @param oids 构件 OID 数组
 	*/
 	restorePartColorByOids(oids) {
@@ -2681,9 +2730,25 @@ var GLTFParserPlugin = class {
 		this._partFrameHelper?.clearAllFrameParts();
 	}
 	/**
+	* 设置指定构件的线框填充颜色
+	* @param oids 构件 OID 数组
+	* @param color 颜色值，支持 hex 数字、颜色字符串（如 "#ff0000"）、THREE.Color 对象
+	*/
+	setFrameFillColor(oids, color) {
+		this._partFrameHelper?.setFrameFillColor(oids, color);
+	}
+	/**
+	* 设置指定构件的线框边框颜色
+	* @param oids 构件 OID 数组
+	* @param color 颜色值，支持 hex 数字、颜色字符串（如 "#ff0000"）、THREE.Color 对象
+	*/
+	setFrameEdgeColor(oids, color) {
+		this._partFrameHelper?.setFrameEdgeColor(oids, color);
+	}
+	/**
 	* Restore the original materials of the mesh
 	*/
-	unhide() {
+	showAllParts() {
 		this.oids = [];
 		this.featureIdCount = this._calculateFeatureIdCount();
 	}