剖面数据变换 · TrimresultTS
对 LK 系统的结构化剖面数据（TrimResults）应用空间变换
📖 功能概述
剖面数据变换 对 TrimResults 复合数据结构整体应用一个 Transform（4×4 变换矩阵），将剖面数据的所有几何元素同时变换到一个新的位置/朝向。这是 LK 型材剖面处理流水线中的关键变换节点。
- 输入原始 TrimResults 和 Transform 变换矩阵
- 使用
TrimResultsTransformer.Transform()工具类对内部所有几何体统一变换 - 输出变换后的 TrimResults，结构与输入完全一致，仅空间位置不同
- 输出仍为
TrimResults类型，可直接连接至 TrimresultCom 进一步分解
BrepSection / IncutterSection
→
TrimresultTS
→
TrimresultCom
→
出图 / 标注
📥 输入参数
| 名称 | 类型 | 必填 | 说明 |
|---|---|---|---|
| 剖面数据 (T) | Generic | 必需 | LK 系统生成的原始剖面数据（TrimResults 结构） |
| 变换 (X) | Transform | 必需 | 4×4 空间变换矩阵。通常来自 PlaneToPlane 变换、Rotation 或 Translation |
📤 输出参数
| 名称 | 类型 | 说明 |
|---|---|---|
| 变换后的剖面数据 (T) | Generic | 所有几何元素经过变换后的 TrimResults 结构。结构不变，空间位置改变 |
🧠 工作流程
1
接收 TrimResults + Transform
→
2
TrimResults
Transformer
.Transform()
Transformer
.Transform()
→
3
输出变换后 TrimResults
组件内部逻辑：从端口接收原始 TrimResults 和 Transform 矩阵，调用工具类统一变换其中的所有几何元素，输出变换后的新数据结构。
🔄 变换范围：
TrimResultsTransformer.Transform() 会对 TrimResults 内部的所有几何元素统一应用变换，包括：
- ✅ 剖面平面（Pln）— 平面位置和法向量
- ✅ 截面形状（Shap）— 截面轮廓 Brep 的所有顶点和面
- ✅ 内部铣切（Incuts）— 每个切割体投影区域
- ✅ 各类孔（Hocuts / Ctcuts / Jscuts）— 所有孔位几何
🧪 典型使用场景
- 剖面排版 — 将生成的多个剖面平移到图纸布局的指定位置
- 坐标对齐 — 将剖面从世界坐标变换到局部工件坐标，方便标注
- 镜像转换 — 对称型材只需生成一侧剖面，通过 Transform 镜像得到另一侧
- 旋转标注 — 对剖面旋转到合适方向后，再分解和标注
- 配合 IncutterSection — 将内部切割位置生成的多个剖面同时变换到图纸坐标系
⚠️ 注意事项
- 输入 Transform 必须为有效的变换矩阵——如果矩阵不可逆或无效，
TrimResultsTransformer.Transform()可能会抛出异常 - 该组件不修改原始数据——返回的是变换后的新 TrimResults 副本
- 变换后的剖面数据仍为 TrimResults 类型，可继续连接 TrimresultCom 进行分解，或组合成列表用于其他处理
- Exposure 为 tertiary，与 TrimresultCom 同级
- 注意区分 Transform（变换矩阵）和 Plane（平面）——如果要平移到另一平面的同一位置，需要用
Transform.PlaneToPlane()创建变换
📋 组件信息
| 名称 | 剖面数据变换 |
| 英文名 | TrimresultTS (DTS) |
| 分类 | LK → Brep |
| Exposure | tertiary |
| 基类 | GH_Component |
| GUID | F8D078FF-0AFB-404E-9226-742D6666FBE0 |