gltf-parser-plugin 1.1.1 → 1.1.3

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

@@ -1,4 +1,4 @@
-import { Mesh, Vector3, Triangle, BufferGeometry, EventDispatcher, DataTexture, RGBAFormat, UnsignedByteType, SRGBColorSpace, Texture, MeshStandardMaterial, DoubleSide, FrontSide, BufferAttribute, OrthographicCamera, Float32BufferAttribute, Vector2, WebGLRenderer, WebGLRenderTarget, ShaderMaterial, OneFactor, ZeroFactor, CustomBlending, Box2, Matrix4, Matrix3, Matrix2, Vector4, MeshBasicMaterial, Loader, Scene, Group, InstancedMesh, Quaternion } from "three";
+import { Mesh, Vector3, Triangle, BufferGeometry, EventDispatcher, DataTexture, RGBAFormat, UnsignedByteType, SRGBColorSpace, Texture, MeshStandardMaterial, DoubleSide, FrontSide, BufferAttribute, OrthographicCamera, Float32BufferAttribute, Vector2, WebGLRenderer, WebGLRenderTarget, ShaderMaterial, OneFactor, ZeroFactor, CustomBlending, Box2, Matrix4, Matrix3, Matrix2, Vector4, MeshBasicMaterial, Loader, Scene, Group, InstancedMesh, Quaternion, Box3 } from "three";
 class FeatureIdUniforms {
   mesh;
   plugin;
@@ -1871,13 +1871,17 @@ class GLTFParserPlugin {
   async _fetchStructureData() {
     const url = this._getStructureUrl();
     if (!url) {
-      console.warn("[GLTFParserPlugin] Cannot derive structure.json URL: tiles not initialized");
+      console.warn(
+        "[GLTFParserPlugin] Cannot derive structure.json URL: tiles not initialized"
+      );
       return null;
     }
     try {
       const response = await fetch(url);
       if (!response.ok) {
-        console.warn(`[GLTFParserPlugin] Failed to fetch structure.json: ${response.status}`);
+        console.warn(
+          `[GLTFParserPlugin] Failed to fetch structure.json: ${response.status}`
+        );
         return null;
       }
       const data = await response.json();
@@ -1932,6 +1936,142 @@ class GLTFParserPlugin {
     return this._ensureStructureLoaded();
   }
   // =============================================
+  // Spatial Query Methods
+  // =============================================
+  _pointInPolygon(px, py, polygon) {
+    let inside = false;
+    const n = polygon.length;
+    for (let i = 0, j = n - 1; i < n; j = i++) {
+      const xi = polygon[i].x, yi = polygon[i].y;
+      const xj = polygon[j].x, yj = polygon[j].y;
+      if (yi > py !== yj > py && px < (xj - xi) * (py - yi) / (yj - yi) + xi) {
+        inside = !inside;
+      }
+    }
+    return inside;
+  }
+  _segmentsIntersect(ax1, ay1, ax2, ay2, bx1, by1, bx2, by2) {
+    const cross = (ox, oy, ax, ay, bx, by) => (ax - ox) * (by - oy) - (ay - oy) * (bx - ox);
+    const d1 = cross(bx1, by1, bx2, by2, ax1, ay1);
+    const d2 = cross(bx1, by1, bx2, by2, ax2, ay2);
+    const d3 = cross(ax1, ay1, ax2, ay2, bx1, by1);
+    const d4 = cross(ax1, ay1, ax2, ay2, bx2, by2);
+    if ((d1 > 0 && d2 < 0 || d1 < 0 && d2 > 0) && (d3 > 0 && d4 < 0 || d3 < 0 && d4 > 0)) {
+      return true;
+    }
+    const onSeg = (px, py, qx, qy, rx, ry) => Math.min(px, qx) <= rx && rx <= Math.max(px, qx) && Math.min(py, qy) <= ry && ry <= Math.max(py, qy);
+    if (d1 === 0 && onSeg(bx1, by1, bx2, by2, ax1, ay1)) return true;
+    if (d2 === 0 && onSeg(bx1, by1, bx2, by2, ax2, ay2)) return true;
+    if (d3 === 0 && onSeg(ax1, ay1, ax2, ay2, bx1, by1)) return true;
+    if (d4 === 0 && onSeg(ax1, ay1, ax2, ay2, bx2, by2)) return true;
+    return false;
+  }
+  _polygonIntersectsRect(polygon, minX, minY, maxX, maxY) {
+    const n = polygon.length;
+    for (let i = 0; i < n; i++) {
+      const p = polygon[i];
+      if (p.x >= minX && p.x <= maxX && p.y >= minY && p.y <= maxY) {
+        return true;
+      }
+    }
+    if (this._pointInPolygon(minX, minY, polygon) || this._pointInPolygon(maxX, minY, polygon) || this._pointInPolygon(maxX, maxY, polygon) || this._pointInPolygon(minX, maxY, polygon)) {
+      return true;
+    }
+    const rx = [minX, maxX, maxX, minX];
+    const ry = [minY, minY, maxY, maxY];
+    for (let i = 0; i < n; i++) {
+      const a = polygon[i];
+      const b = polygon[(i + 1) % n];
+      for (let j = 0; j < 4; j++) {
+        const k = (j + 1) % 4;
+        if (this._segmentsIntersect(
+          a.x,
+          a.y,
+          b.x,
+          b.y,
+          rx[j],
+          ry[j],
+          rx[k],
+          ry[k]
+        )) {
+          return true;
+        }
+      }
+    }
+    return false;
+  }
+  /**
+   * 选择包围盒范围内的构件（包含相交和包含两种情况）
+   * @param box 查询用的 Box3 范围，坐标系与 structure.json 中 bbox 一致
+   * @returns 范围内所有构件的 oid 数组
+   */
+  async selectByBox(box) {
+    await this._ensureStructureLoaded();
+    const result = [];
+    const nodeBox = new Box3();
+    for (const [oid, node] of this._oidNodeMap) {
+      if (!node.bbox || node.bbox.length < 6) continue;
+      nodeBox.min.set(node.bbox[0], node.bbox[1], node.bbox[2]);
+      nodeBox.max.set(node.bbox[3], node.bbox[4], node.bbox[5]);
+      if (box.intersectsBox(nodeBox)) {
+        result.push(oid);
+      }
+    }
+    return result;
+  }
+  /**
+   * 选择多边形（平面投影）范围内的构件（包含相交和包含两种情况）
+   * @param polygon 多边形顶点数组（Vector3），按顺序连接构成闭合多边形
+   * @param axis 投影平面，决定使用 bbox 的哪两个轴做 2D 判定
+   *   - 'xz'（默认）：俯视图，取 bbox 的 x/z 坐标
+   *   - 'xy'：正视图，取 bbox 的 x/y 坐标
+   *   - 'yz'：侧视图，取 bbox 的 y/z 坐标
+   * @returns 范围内所有构件的 oid 数组
+   */
+  async selectByPolygon(polygon, axis = "xz") {
+    await this._ensureStructureLoaded();
+    const result = [];
+    const polygon2D = polygon.map((p) => {
+      switch (axis) {
+        case "xy":
+          return new Vector2(p.x, p.y);
+        case "yz":
+          return new Vector2(p.y, p.z);
+        case "xz":
+        default:
+          return new Vector2(p.x, p.z);
+      }
+    });
+    for (const [oid, node] of this._oidNodeMap) {
+      if (!node.bbox || node.bbox.length < 6) continue;
+      let minU, minV, maxU, maxV;
+      switch (axis) {
+        case "xy":
+          minU = node.bbox[0];
+          minV = node.bbox[1];
+          maxU = node.bbox[3];
+          maxV = node.bbox[4];
+          break;
+        case "xz":
+          minU = node.bbox[0];
+          minV = node.bbox[2];
+          maxU = node.bbox[3];
+          maxV = node.bbox[5];
+          break;
+        case "yz":
+          minU = node.bbox[1];
+          minV = node.bbox[2];
+          maxU = node.bbox[4];
+          maxV = node.bbox[5];
+          break;
+      }
+      if (this._polygonIntersectsRect(polygon2D, minU, minV, maxU, maxV)) {
+        result.push(oid);
+      }
+    }
+    return result;
+  }
+  // =============================================
   // Model Info Methods
   // =============================================
   _getModelInfoUrl() {
@@ -1942,13 +2082,17 @@ class GLTFParserPlugin {
   async _fetchModelInfo() {
     const url = this._getModelInfoUrl();
     if (!url) {
-      console.warn("[GLTFParserPlugin] Cannot derive modelInfo.json URL: tiles not initialized");
+      console.warn(
+        "[GLTFParserPlugin] Cannot derive modelInfo.json URL: tiles not initialized"
+      );
       return null;
     }
     try {
       const response = await fetch(url);
       if (!response.ok) {
-        console.warn(`[GLTFParserPlugin] Failed to fetch modelInfo.json: ${response.status}`);
+        console.warn(
+          `[GLTFParserPlugin] Failed to fetch modelInfo.json: ${response.status}`
+        );
         return null;
       }
       const data = await response.json();
@@ -2129,7 +2273,8 @@ class GLTFParserPlugin {
   // =============================================
   _isOidBlocked(oid) {
     if (this._frozenOids.has(oid)) return true;
-    if (this._isolatedOids.size > 0 && !this._isolatedOids.has(oid)) return true;
+    if (this._isolatedOids.size > 0 && !this._isolatedOids.has(oid))
+      return true;
     return false;
   }
   _trackMesh(mesh, oid) {
@@ -2214,6 +2359,13 @@ class GLTFParserPlugin {
     }
     this._syncCollectorMeshes();
   }
+  /**
+   * 冻结单个构件
+   */
+  freezeByOid(oid) {
+    this._frozenOids.add(oid);
+    this._syncCollectorMeshes();
+  }
   /**
    * 解冻指定构件
    */
@@ -2223,6 +2375,13 @@ class GLTFParserPlugin {
     }
     this._syncCollectorMeshes();
   }
+  /**
+   * 解冻单个构件
+   */
+  unfreezeByOid(oid) {
+    this._frozenOids.delete(oid);
+    this._syncCollectorMeshes();
+  }
   /**
    * 解冻全部构件
    */
@@ -2245,6 +2404,13 @@ class GLTFParserPlugin {
     }
     this._syncCollectorMeshes();
   }
+  /**
+   * 往隔离集合中添加单个构件
+   */
+  isolateByOid(oid) {
+    this._isolatedOids.add(oid);
+    this._syncCollectorMeshes();
+  }
   /**
    * 取消隔离指定构件
    */
@@ -2254,6 +2420,13 @@ class GLTFParserPlugin {
     }
     this._syncCollectorMeshes();
   }
+  /**
+   * 从隔离集合中移除单个构件
+   */
+  unisolateByOid(oid) {
+    this._isolatedOids.delete(oid);
+    this._syncCollectorMeshes();
+  }
   /**
    * 取消全部隔离，恢复所有构件的交互能力
    */