实体切割曲面 · TrimSolid
用多个实体切割曲面，被切割部分将被去除，多线程异步运算
📖 功能概述
实体切割曲面：用一组实体（Solid Brep）去切割一个目标曲面（Brep），被实体相交区域的曲面部分将被去除，同时输出剩余部分和被切掉的部分。
- 单对多 — 一个目标曲面，多个切割实体
- 底层使用
BooleanTrimCalculator执行布尔剪裁计算 - 基于 GH_TaskCapableComponent 实现异步多线程运算，不阻塞 Grasshopper 界面
- 自动验证切割体是否为实体（非实体报错）
- 两个输出端口分别输出剩余和被切除的部分
曲面
被切割
✂️
实体
切割工具
→
剩余
保留
切除
去除
📥 输入参数
| 名称 | 类型 | 必填 | 说明 |
|---|---|---|---|
| 曲面 (S) | Brep | 必需 | 需要被切割的目标曲面（单个） |
| 实体 (T) | Brep | 必需 | 用来切割的多个实体列表。每个必须为 IsSolid == true |
⚠️ 切割体验证：组件会在运算前检查每个输入的 Brep 是否为实体（
IsSolid）。如果存在非实体，会立即报错 "切割体必须为实体"，不会继续计算。
📤 输出参数
| 名称 | 类型 | 说明 |
|---|---|---|
| 切割后剩余部分 (R) | Brep | 曲面被实体切割后剩余的部分（列表）。即原曲面减去实体占据的区域 |
| 被切割掉的部分 (I) | Brep | 曲面上被实体切除的部分（列表）。即原曲面与实体相交的区域 |
⚡ 异步执行流程
组件继承自 GH_TaskCapableComponent<SolutionResult>，分两阶段执行：
InPreSolve
准备数据校验实体
📦
后台 Task
Task.Run 异步计算
不阻塞 UI
不阻塞 UI
✅
GetSolveResults
取回结果
输出到端口
输出到端口
📋 两阶段详解
阶段 1：InPreSolve
- 获取输入的曲面和切割实体列表
- 验证每个切割体是否为实体（IsSolid）
- 获取文档容差（DocumentTolerance()）
- 创建 Task 启动后台计算
- 将 Task 加入 TaskList
- return，等待下一阶段
阶段 2：SolveInstance
- 调用 GetSolveResults 获取计算结果
- 如果计算未完成（null），输出 Warning
- 如果结果中有错误消息，输出 Error
- 否则将剩余部分和切除部分分别输出
⏱️ 性能优势：因为布尔切割运算可能很耗时（特别是当切割实体数量多或拓扑复杂时），GH_TaskCapableComponent 确保运算在后台线程执行，Grasshopper 界面不会卡住，用户体验流畅。
🧪 典型使用场景
- 曲面开孔 — 用多个实体（柱体、方体）在曲面上开孔，分别输出开孔后的面板和挖下的碎片
- 实体布尔减 — 用实体切割器从曲面模型中减去材料
- 批量切除 — 在建筑表皮上用多个体块同时切割，得到开窗或开口的面板
- 逆向提取切口区 — 提取被切割部分的面片，用于冲裁或铣切路径生成
⚠️ 注意事项
- 切割体必须为实体（封闭的 Brep），否则组件会报错并停止执行
- 组件使用文档容差（
DocumentTolerance()）进行布尔运算，如需调整精度可先修改 Rhino 文档的绝对容差 - 异步任务通过
CancelToken支持取消——当 Grasshopper 的 Solution 被终止时（如关闭组件或修改输入），后台计算会被安全取消 - 大量的切割实体可能导致 Task 执行时间较长，但 UI 不会卡顿
SolutionResult是组件内部的数据容器，输出前先检查是否存在ErrorMessage
📋 组件信息
| 名称 | 实体切割曲面 |
| 英文名 | TrimSolid (TS) |
| 分类 | LK → Brep |
| Exposure | secondary（二级标签页可见） |
| 基类 | GH_TaskCapableComponent<SolutionResult> |
| GUID | 98628146-DEBD-4776-8BDC-D4C8C5B9A16B |