iflow-engine-base 3.4.12 → 3.4.13

package/dist/index.d.ts

@@ -509,10 +509,14 @@ declare class Clipping {
     sectionBox: any;
     sectionFace: any;
     clippingStencil: any;
+    clippingCSGSimple: ClippingCSGOptimizedSimple | null;
     currentClippingMode: string;
+    fillCutFace: boolean;
     constructor(engine: any);
     init(): void;
     scaleBox(): void;
+    setFillCutFace(b: boolean): void;
+    getFillCutFace(): boolean;
     clippingModel(models: any): void;
     updateClippingValue(value: any): void;
     active(type: string): void;
@@ -543,6 +547,137 @@ declare class Clipping {
     }): void;
 }
 
+/**
+ * ClippingCSGOptimizedSimple
+ *
+ * 作用：
+ * 1. 根据剖切平面，计算模型与“薄片平面体”的 CSG 相交结果。
+ * 2. 从相交结果中提取贴近平面的帽面三角形（cap）。
+ * 3. 合并 cap 几何并加入场景，作为剖切补面。
+ *
+ * 设计要点：
+ * - 先粗筛（octree box / mesh box），再做重计算（CSG），避免全量布尔运算。
+ * - 对补面做极小偏移，避免补面材质本身也挂 clippingPlanes 时被同平面裁掉。
+ * - 每次更新前先 clear，保证场景中只存在当前补面。
+ */
+declare class ClippingCSGOptimizedSimple {
+    /** 引擎实例（包含 scene / models / engineStatus / octreeBox 等） */
+    private engine;
+    /** three-bvh-csg 计算器，负责执行布尔操作 */
+    private readonly evaluator;
+    /** 场景中补面 Mesh 的统一名前缀 */
+    private readonly fillMeshName;
+    /**
+     * 当前生成的补面集合。
+     * key：平面唯一键（face 或 plane-i-name）
+     * value：对应补面 Mesh
+     */
+    private readonly fillMeshes;
+    /** 单次最多参与 CSG 的候选 Mesh 数量（保护性能） */
+    private readonly maxCandidates;
+    /** 单个 mesh 最大三角面阈值（过大直接跳过，保护实时交互） */
+    private readonly maxTriangleCountPerMesh;
+    /** 补面统一材质（由你在构造器中挂了 clippingPlanes） */
+    private fillMaterial;
+    constructor(engine: any);
+    /**
+     * 清理当前所有补面。
+     * - 从 scene 移除 mesh
+     * - 释放 geometry / material 资源
+     */
+    clear(): void;
+    /**
+     * 单平面补面入口（face/x/y/z 模式可用）。
+     * 每次调用先 clear，再构建当前平面的补面。
+     */
+    updataFace(plane: any): void;
+    /**
+     * 多平面补面入口（box 模式可用）。
+     * 约定：传入的每个合法平面都分别生成一份补面。
+     */
+    updataFaces(planes: any[]): void;
+    /**
+     * 构建某一个平面的补面。
+     *
+     * 主流程：
+     * 1) 拿场景包围盒，确定平面体尺寸。
+     * 2) 基于 octree 与 plane 相交，筛候选 mesh。
+     * 3) 再按 mesh world box 与复杂度做二次筛选。
+     * 4) 对每个候选 mesh 执行 CSG INTERSECTION。
+     * 5) 从交集几何中提取贴近平面的 cap 三角形。
+     * 6) 合并 cap，做轻微偏移，创建补面 mesh。
+     */
+    private buildSinglePlaneFill;
+    /**
+     * 获取补面偏移距离。
+     * - 可通过 engine.engineStatus.clippingFaceOffset 覆盖
+     * - 默认按模型尺度自适应并带最小值
+     */
+    private getFaceOffsetDistance;
+    /**
+     * 获取补面偏移方向。
+     * - 可通过 engine.engineStatus.clippingFaceOffsetSign 指定（1/-1）
+     * - 默认 -1，即沿 -normal 方向偏移
+     */
+    private getFaceOffsetSign;
+    /**
+     * 使用 octree + plane 相交快速收集候选 mesh。
+     *
+     * 过程：
+     * - 遍历 engineStatus.models -> lod.octreeBox
+     * - 只取与 plane 相交的 octree 节点元素 id
+     * - 跳过隐藏/半透明/实例化节点
+     * - 收集节点 infos 里的 mesh，并按 uuid 去重
+     */
+    private collectCandidateMeshesFromOctree;
+    /**
+     * 收集当前 model url 下需要忽略的元素 id（隐藏 + 半透明）。
+     */
+    private getIgnoredIds;
+    /**
+     * 深度遍历 octree，返回与 plane 相交节点中的 element id 集合。
+     */
+    private collectIntersectElementIds;
+    /**
+     * 将引擎 octree 节点坐标转换为 three.js 的 Box3（含单位/坐标系转换）。
+     */
+    private octreeNodeToBox3;
+    /**
+     * 候选 mesh 二次筛选：
+     * - 必须存在有效 position
+     * - 三角面数不能超过阈值
+     * - world bbox 必须与 plane 相交
+     */
+    private filterMeshesByBoxAndComplexity;
+    /**
+     * 构造“薄片平面体” Brush：
+     * - 几何为 BoxGeometry(size, size, thickness)
+     * - 旋转到 plane.normal
+     * - 平移到 plane 上
+     */
+    private createPlaneBrush;
+    /**
+     * 将场景 mesh 转为世界坐标 Brush。
+     */
+    private createWorldBrushFromMesh;
+    /**
+     * 统一 CSG 输入属性，避免属性不一致报错（例如 uv 缺失）。
+     * 目标属性固定为：position / normal / uv
+     */
+    private toCsgReadyGeometry;
+    /**
+     * 从 CSG 相交结果中提取补面三角形。
+     *
+     * 判定条件：
+     * - 三角形法线与 plane.normal 足够平行（|dot| >= 0.9）
+     * - 三角形顶点到平面的距离 spread 足够小
+     * - 三角形平均距离落在薄片附近，且位于有效侧
+     *
+     * 提取后将三角形顶点投影回 plane，保证补面共面。
+     */
+    private extractPlaneCapGeometry;
+}
+
 declare class ComposerModule {
     private engine;
     composer: any;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "iflow-engine-base",
-  "version": "3.4.12",
+  "version": "3.4.13",
   "description": "BIM Engine SDK for Vue2, Vue3, React and HTML",
   "main": "./dist/bim-engine-sdk.umd.js",
   "module": "./dist/bim-engine-sdk.es.js",