型材包围盒 · PB
基于型材截面外轮廓矩形框沿路径生成包围盒实体，支持端部切平/端部铣切两种模式
📖 功能概述
该组件根据LK系统型材的截面信息，沿截面外轮廓的包围矩形框生成纯净的包围盒实体（忽略内部一切开孔和切割特征）。
它的核心作用是从型材的异构截面中提取"最小外接矩形"，然后将这个矩形沿型材路径拉伸或扫掠，从而得到一个不含内部细节的纯净外轮廓实体。这在计算型材的净尺寸、包裹体积、加工余量等场景中非常有用。
该组件使用 ButtonComponent（双状态按钮），通过右键菜单可在两种端部处理模式间切换：
- 端部切平：用切割面与扫掠体相交产生的垂直平面对实体进行切割，端面平整。
- 端部铣切：直接使用起端切面和终端切面（Brep）进行布尔差运算，保留端部铣切造型。
📥 输入参数
| 名称 | 类型 | 必填 | 说明 |
|---|---|---|---|
| 型材 | Brep | 必填 | 需要生成包围盒的LK系统型材模型。必须包含标准UserDictionary属性：拉伸-路径、拉伸-截面、拉伸-截面pln、起端切面、终端切面。 |
📤 输出参数
| 名称 | 类型 | 说明 |
|---|---|---|
| 包围盒 | Brep | 根据截面外包围矩形框生成的型材包围盒实体。注意：输出为树形，因为弯曲型材可能产生多段结果。树形 |
🧠 核心算法详解
一、截面外矩形提取
1 从型材属性中读取
2 使用
→ 得到的是截面形状的最小外接矩形（没有内部孔洞的信息）
3 将外接矩形转为Nurbs曲线（
4 通过
→ 这是一个扁平的矩形面片，代表了型材的外轮廓边界
拉伸-截面（Brep）和 拉伸-截面pln（Plane）2 使用
BoundingBoxCalculator 以截面平面为参考坐标系，计算截面的包围矩形→ 得到的是截面形状的最小外接矩形（没有内部孔洞的信息）
3 将外接矩形转为Nurbs曲线（
ToNurbsCurve()）4 通过
Brep.CreatePlanarBreps() 将矩形曲线转为平面Brep→ 这是一个扁平的矩形面片，代表了型材的外轮廓边界
二、沿路径扫掠
1 从型材属性中读取
2 将矩形面片包装为
3 使用
→ 生成一个跟随路径的管状实体（SuperExtrude自动处理路径的弯曲变化）
4 得到的是纯净的"矩形截面沿路径扫掠"实体——没有任何开孔或内部切割
拉伸-路径（Curve）2 将矩形面片包装为
IGH_GeometricGoo3 使用
SuperExtrude 将矩形面片沿路径进行扫掠→ 生成一个跟随路径的管状实体（SuperExtrude自动处理路径的弯曲变化）
4 得到的是纯净的"矩形截面沿路径扫掠"实体——没有任何开孔或内部切割
三、端部处理（双模式）
这是组件的核心差异化功能，通过右键菜单按钮切换两种模式：
模式一：端部切平（btnState1 = true）
此模式追求端面与路径垂直的整齐切平效果：
1 读取起端切面和终端切面（Brep）
2 使用
• 计算扫掠体与切面的相交曲线
• 从相交曲线中提取角点并投影到路径上
• 在路径的起点投影点和终点投影点处创建垂直平面（PerpendicularFrame）
3 使用
4 结果是端面平整垂直于路径方向的包围盒实体
模式二：端部铣切（btnState1 = false）
此模式保留端部铣切造型：
1 读取起端切面和终端切面（Brep），直接使用这两个Brep作为切割工具
2 使用
3 结果是带有端部铣切原始造型的包围盒实体（端面形状与实际切割一致）
两种模式的选择依据：
• "端部切平"更适合需要规整外轮廓的场合（如计算包裹体积、模具设计）
• "端部铣切"更适合需要保留端部切割特征的场合（如验证铣切效果、CNC加工预览）
此模式追求端面与路径垂直的整齐切平效果：
1 读取起端切面和终端切面（Brep）
2 使用
BrepLength.BrepIntersectionAnalyzer（与BrepLength组件共享同一个内部类）分析扫掠体与两个切面的相交关系：• 计算扫掠体与切面的相交曲线
• 从相交曲线中提取角点并投影到路径上
• 在路径的起点投影点和终点投影点处创建垂直平面（PerpendicularFrame）
3 使用
ParallelBrepBooleanDifference 用两个垂直平面对扫掠体进行平面切割4 结果是端面平整垂直于路径方向的包围盒实体
模式二：端部铣切（btnState1 = false）
此模式保留端部铣切造型：
1 读取起端切面和终端切面（Brep），直接使用这两个Brep作为切割工具
2 使用
ParallelBrepBooleanDifference 用这两个切面Brep对扫掠体进行布尔差运算3 结果是带有端部铣切原始造型的包围盒实体（端面形状与实际切割一致）
两种模式的选择依据：
• "端部切平"更适合需要规整外轮廓的场合（如计算包裹体积、模具设计）
• "端部铣切"更适合需要保留端部切割特征的场合（如验证铣切效果、CNC加工预览）
⚙️ 完整执行流程
1. 获取输入：从DA读取型材Brep。如果为空则退出。
2. 属性提取：通过ReferenceID定位Rhino场景物件，读取四个关键属性：
• 拉伸-路径（Curve）
• 拉伸-截面（Brep）
• 拉伸-截面pln（Plane）
• 起端切面、终端切面（Brep）
3. 截面外矩形计算：BoundingBoxCalculator → ToBoundingRectangle → ToNurbsCurve → CreatePlanarBreps
4. SuperExtrude扫掠：矩形面沿路径扫掠生成实体
5. 端部处理（根据按钮状态）：
• btnState1 = true → 端部切平模式（BrepIntersectionAnalyzer → 垂直平面 → BooleanDifference）
• btnState1 = false → 端部铣切模式（直接起端/终端切面 → BooleanDifference）
6. 结果输出：切割后的包围盒Brep到输出参数。
2. 属性提取：通过ReferenceID定位Rhino场景物件，读取四个关键属性：
• 拉伸-路径（Curve）
• 拉伸-截面（Brep）
• 拉伸-截面pln（Plane）
• 起端切面、终端切面（Brep）
3. 截面外矩形计算：BoundingBoxCalculator → ToBoundingRectangle → ToNurbsCurve → CreatePlanarBreps
4. SuperExtrude扫掠：矩形面沿路径扫掠生成实体
5. 端部处理（根据按钮状态）：
• btnState1 = true → 端部切平模式（BrepIntersectionAnalyzer → 垂直平面 → BooleanDifference）
• btnState1 = false → 端部铣切模式（直接起端/终端切面 → BooleanDifference）
6. 结果输出：切割后的包围盒Brep到输出参数。
🧪 典型使用场景
| 场景 | 详细说明 |
|---|---|
| 型材净体积提取 | 从型材中去除所有开孔和内部切割特征，仅保留外轮廓包围盒，用于计算型材的最小包裹体积（如包装设计、运输体积估算）。 |
| 弯曲型材包裹 | 对于弧形型材，SuperExtrude自动沿弯曲路径扫掠，生成的包围盒准确跟随路径的弯曲变化。这是纯边界框计算（BoundingBox）无法做到的。 |
| 端部处理验证 | 切换右键菜单中的"端部切平"和"端部铣切"模式，对比两种端部处理方式的视觉效果，确认型材端部的切割方案。 |
| CNC加工参考 | 端部切平模式下生成的平整端面包围盒可作为CNC加工路径的参考边界，辅助计算加工余量和刀具路径。 |
⚠️ 注意事项
- 必须包含LK标准属性：拉伸-路径、拉伸-截面、拉伸-截面pln、起端切面、终端切面缺一不可。代码中没有属性校验步骤，缺少属性会直接崩溃。
- 按钮状态持久化：这是
ButtonComponent的两个状态按钮，右键菜单选择后状态会保存到.gh文件中。切换模式无需重新连接数据。 - 模态默认为"端部铣切"：
btnState1为false时是端部铣切模式。如果你的型材没有端部铣切特征，建议切换到"端部切平"模式获得更规整的结果。 - 输出为树形：因为弯曲型材可能产生多段结果（不同截面段对应不同的包围盒），输出采用树形结构。如果只有一个包围盒，路径为 {0;0}。
- 与BrepLength共享分析器：ProfileBox 的"端部切平"模式复用了 BrepLength 组件中定义的
BrepIntersectionAnalyzer内部类（通过using static引入），两者的切割面分析逻辑完全一致。 - 容差：CreatePlanarBreps 容差 0.1，ParallelBrepBooleanDifference 容差 0.001。
📋 组件信息
| 名称 | 型材包围盒 |
| 英文名 | PB |
| 分类 | LK → Util |
| Exposure | quinary（五级） |
| 按钮模式1 | 端部切平 |
| 按钮模式2 | 端部铣切 |
| 基类 | ButtonComponent（双状态按钮） |
| 文件 | ProfileBox.cs |
| GUID | {57877129-1C48-4CD6-BBD7-E6C821CF739A} |