包围盒 · BoundingBox
求取物体的最小外包围盒，支持单个或合并模式，兼容平面矩形和立体盒子
📖 功能概述
对输入的几何列表求取轴对齐包围盒或平面对齐包围盒，支持两种输出形式：
- 立体包围盒（Box） — 三维空间的立方体包围盒
- 平面矩形（Rectangle） — 沿指定平面的二维矩形包围盒（高度方向忽略）
配合右键菜单切换单一（逐物件计算）和合并（全局合并）两种模式，灵活应对不同场景。
📥 输入参数
| 名称 | 类型 | 必填 | 说明 |
|---|---|---|---|
| 几何体 (G) | Geometry | 必需 | 需要求取包围盒的几何体列表。支持曲线、曲面、实体、点等多种几何类型。 |
| 参考平面 (P) | Plane | 可选 | 包围盒的对齐参考平面。默认为 WorldXY。不连接时使用世界坐标轴。 |
📤 输出参数
| 名称 | 类型 | 说明 |
|---|---|---|
| 包围盒 (B) | Box / Rectangle3d | 输出的包围盒。具体类型取决于按钮状态和右键模式：在"单一"模式下输出列表，在"合并"模式下输出单个。 |
🎛️ 双重控制
🔘 按钮：切换输出形状
📦 立体盒子（Box）
按钮弹起状态。输出三维立体包围盒。适合碰撞检测、空间分析等需要完整三维范围的场景。
📐 平面矩形（Rectangle）
按钮按下状态。输出沿参考平面的二维矩形包围盒。适合布局规划、投影分析等场景。
🔀 右键：切换计算范围
🎯 单一模式
逐物件计算包围盒。每个输入几何体独立计算自己的最小包围盒，输出为列表。
适用于：需要单独操作每个物件包围盒的场景
🔗 合并模式
所有几何体计算全局最小包围盒。输出为单个结果，包含所有输入物件。
适用于：求取整体尺寸范围、确定整体边界
🧠 逻辑流程
1
输入
几何体列表
几何体列表
→
2
右键：
单一/合并？
单一/合并？
→
3
逐物计算
或合并计算
或合并计算
→
4
按钮：
Box / Rectangle？
Box / Rectangle？
→
5
输出结果
🔄 输出访问模式联动
右键切换模式时会自动调整输出参数的访问类型：
| 右键模式 | 输出访问类型 | 输出格式 |
|---|---|---|
| 单一 | List | 每个物件对应一个包围盒。有多少个输入物件就有多少个输出。 |
| 合并 | Item | 所有物件合并成一个全局包围盒。只有一个输出。 |
🧪 典型使用场景
| 场景 | 说明 |
|---|---|
| 确定模型范围 | 合并模式求出整个模型的全局包围盒，快速了解模型的整体尺寸和位置。 |
| 碰撞检测预处理 | 单一模式逐个计算包围盒，用包围盒快速过滤明显不相交的物体，减少精确碰撞检测的计算量。 |
| 布局排版 | 使用参考平面 + 平面矩形模式，将三维物件投影到指定平面上求取二维范围，用于排布分析。 |
| 制作切割模具 | 合并模式求得整体外框后，旋转平面输出矩形，用于生成切割路径或模具形状。 |
⚠️ 注意事项
- 输入列表为空或无效时会直接返回，不产生输出。
- 参考平面必须有效。如果输入的 Plane 无效（例如零平面），组件不会计算。
- 平面矩形模式（Rectangle）依赖
BoundingBoxCalculator辅助类完成平面投影计算。 - 按钮状态（Box/Rectangle）和右键状态（单一/合并）完全独立，可以四组合搭配使用。
📋 组件信息
| 名称 | 包围盒 |
| 英文名 | BoundingBox |
| 分类 | LK → Brep |
| 基类 | RightClickButtonComponent |
| GUID | 9F529BF8-8716-48D2-B11F-AC79BB439087 |