247 lines
7.3 KiB
Markdown
247 lines
7.3 KiB
Markdown
# 2.1.2 通道选择功能设计说明
|
||
|
||
## 2.1.2.1. 模块描述
|
||
|
||
通道选择模块是物流路径规划系统的核心功能模块，负责支持用户通过选择树或三维视图点选的方式选择通道模型，并将其指定为通道类型。该模块是后续自动路径规划的基础，为A*算法提供可通行的通道区域数据。
|
||
|
||
通道选择模块与CategoryAttributeManager紧密集成，将选中的模型元素标记为物流属性中的"通道"类型，并设置相应的通行属性。
|
||
|
||
## 2.1.2.2. 功能
|
||
|
||
### 核心功能
|
||
1. **选择树选择**：通过Navisworks选择树面板选择模型元素
|
||
2. **三维点选**：在三维视图中直接点击选择模型元素
|
||
3. **通道类型指定**：将选中的模型指定为通道类型
|
||
4. **批量选择**：支持框选和批量选择多个元素
|
||
|
||
### 子功能
|
||
| 功能编号 | 功能名称 | 功能描述 |
|
||
|---------|---------|---------|
|
||
| 2.1.2.F1 | 选择树集成 | 与Navisworks选择树面板集成，支持树形结构选择 |
|
||
| 2.1.2.F2 | 三维点选 | 支持在三维视图中点击选择模型 |
|
||
| 2.1.2.F3 | 框选支持 | 支持矩形框选多个模型元素 |
|
||
| 2.1.2.F4 | 类型指定 | 将选中的模型指定为通道类型 |
|
||
| 2.1.2.F5 | 选择预览 | 高亮显示当前选中的模型元素 |
|
||
| 2.1.2.F6 | 选择确认 | 确认选择并应用通道属性 |
|
||
|
||
## 2.1.2.3. 性能
|
||
|
||
### 性能指标
|
||
| 指标名称 | 目标值 | 说明 |
|
||
|---------|-------|------|
|
||
| 点选响应时间 | < 100ms | 三维视图中点击选择的响应时间 |
|
||
| 批量选择支持 | > 1000个 | 单次批量选择的最大元素数量 |
|
||
| 属性应用时间 | < 500ms | 通道属性应用到选中元素的时间 |
|
||
| 内存占用 | < 100MB | 选择过程中的额外内存占用 |
|
||
|
||
### 性能优化策略
|
||
1. 使用空间索引加速三维点选
|
||
2. 批量属性设置，减少COM API调用次数
|
||
3. 选择结果缓存，避免重复查询
|
||
|
||
## 2.1.2.4. 输入输出项
|
||
|
||
### 1. 字段输入输出
|
||
|
||
#### 输入字段
|
||
| 字段名 | 类型 | 必填 | 说明 |
|
||
|-------|------|-----|------|
|
||
| SelectedItems | ModelItemCollection | 是 | 选中的模型元素集合 |
|
||
| ChannelType | LogisticsElementType | 否 | 通道类型，默认Channel |
|
||
| Priority | int | 否 | 优先级，默认5 |
|
||
| IsTraversable | bool | 否 | 是否可通行，默认true |
|
||
|
||
#### 输出字段
|
||
| 字段名 | 类型 | 说明 |
|
||
|-------|------|------|
|
||
| AppliedCount | int | 成功应用属性的元素数量 |
|
||
| FailedItems | List<ModelItem> | 应用失败的元素列表 |
|
||
| ChannelItems | List<ModelItem> | 当前所有通道元素列表 |
|
||
|
||
### 2. 界面交互输入输出
|
||
|
||
#### 界面输入
|
||
- 鼠标点击/框选操作
|
||
- 选择树节点勾选
|
||
- 通道属性参数设置
|
||
|
||
#### 界面输出
|
||
- 选中元素高亮显示
|
||
- 选择数量统计
|
||
- 通道类型应用结果提示
|
||
|
||
## 2.1.2.5. 算法
|
||
|
||
### 三维点选算法
|
||
```
|
||
算法：基于射线检测的三维点选
|
||
输入：鼠标屏幕坐标，相机参数
|
||
输出：选中的模型元素
|
||
|
||
1. 将屏幕坐标转换为射线（Ray）
|
||
2. 遍历所有可见模型元素：
|
||
3. 计算射线与元素包围盒的交点
|
||
4. 如果有交点，计算精确交点距离
|
||
5. 返回距离最近的元素
|
||
```
|
||
|
||
### 通道属性应用算法
|
||
```
|
||
算法：批量应用通道属性
|
||
输入：选中的模型元素集合
|
||
输出：应用结果
|
||
|
||
1. 初始化COM API
|
||
2. 对于每个选中的元素：
|
||
3. 检查元素是否已有物流属性
|
||
4. 如果存在且冲突，记录冲突
|
||
5. 应用通道类型属性
|
||
6. 应用优先级、可通行性等属性
|
||
7. 批量提交属性更改
|
||
8. 返回应用统计
|
||
```
|
||
|
||
## 2.1.2.6. 流程逻辑
|
||
|
||
```
|
||
开始
|
||
│
|
||
▼
|
||
┌─────────────────┐
|
||
│ 进入选择模式 │
|
||
└────────┬────────┘
|
||
│
|
||
┌────┴────┐
|
||
▼ ▼
|
||
┌────────┐ ┌────────┐
|
||
│选择树 │ │三维点选│
|
||
└───┬────┘ └───┬────┘
|
||
│ │
|
||
└─────┬─────┘
|
||
│
|
||
▼
|
||
┌─────────────────┐
|
||
│ 显示选中预览 │
|
||
└────────┬────────┘
|
||
│
|
||
▼
|
||
┌─────────────────┐
|
||
│ 确认通道类型 │
|
||
└────────┬────────┘
|
||
│
|
||
▼
|
||
┌─────────────────┐
|
||
│ 应用通道属性 │
|
||
└────────┬────────┘
|
||
│
|
||
▼
|
||
┌─────────────────┐
|
||
│ 显示应用结果 │
|
||
└────────┬────────┘
|
||
│
|
||
▼
|
||
结束
|
||
```
|
||
|
||
## 2.1.2.7. 接口
|
||
|
||
### 公共接口
|
||
```csharp
|
||
/// <summary>
|
||
/// 通道选择管理器
|
||
/// </summary>
|
||
public class ChannelSelectionManager
|
||
{
|
||
/// <summary>
|
||
/// 设置选中元素为通道
|
||
/// </summary>
|
||
/// <param name="items">选中的模型元素</param>
|
||
/// <returns>应用结果</returns>
|
||
public ChannelSelectionResult SetAsChannel(ModelItemCollection items);
|
||
|
||
/// <summary>
|
||
/// 获取所有通道元素
|
||
/// </summary>
|
||
/// <returns>通道元素列表</returns>
|
||
public List<ModelItem> GetAllChannels();
|
||
|
||
/// <summary>
|
||
/// 清除元素的通道属性
|
||
/// </summary>
|
||
/// <param name="items">要清除的元素</param>
|
||
/// <returns>清除的元素数量</returns>
|
||
public int ClearChannelAttribute(ModelItemCollection items);
|
||
}
|
||
```
|
||
|
||
### 事件接口
|
||
```csharp
|
||
/// <summary>
|
||
/// 选择变更事件
|
||
/// </summary>
|
||
public event EventHandler<SelectionChangedEventArgs> SelectionChanged;
|
||
|
||
/// <summary>
|
||
/// 通道属性应用完成事件
|
||
/// </summary>
|
||
public event EventHandler<ChannelAppliedEventArgs> ChannelApplied;
|
||
```
|
||
|
||
## 2.1.2.8. 注释设计
|
||
|
||
### 代码注释规范
|
||
```csharp
|
||
/// <summary>
|
||
/// 通道选择结果
|
||
/// </summary>
|
||
public class ChannelSelectionResult
|
||
{
|
||
/// <summary>
|
||
/// 成功应用的元素数量
|
||
/// </summary>
|
||
public int AppliedCount { get; set; }
|
||
|
||
/// <summary>
|
||
/// 应用失败的元素列表
|
||
/// 失败原因可能是元素已被锁定或API调用失败
|
||
/// </summary>
|
||
public List<ModelItem> FailedItems { get; set; }
|
||
}
|
||
```
|
||
|
||
### 配置文件注释
|
||
```toml
|
||
# 通道选择配置
|
||
[channel_selection]
|
||
# 默认通道类型
|
||
default_channel_type = "通道"
|
||
# 默认优先级（1-10）
|
||
default_priority = 5
|
||
# 点选容差（像素）
|
||
click_tolerance_pixels = 5
|
||
```
|
||
|
||
## 2.1.2.9. 数据结构
|
||
|
||
### ChannelSelectionResult 结构
|
||
| 字段名 | 类型 | 说明 |
|
||
|-------|------|------|
|
||
| AppliedCount | int | 成功应用的元素数量 |
|
||
| FailedCount | int | 失败的元素数量 |
|
||
| FailedItems | List<ModelItem> | 失败的元素列表 |
|
||
| ConflictCount | int | 冲突的元素数量 |
|
||
|
||
### SelectionChangedEventArgs 结构
|
||
| 字段名 | 类型 | 说明 |
|
||
|-------|------|------|
|
||
| SelectedItems | ModelItemCollection | 当前选中的元素 |
|
||
| SelectionCount | int | 选中元素数量 |
|
||
| SelectionBounds | BoundingBox3D | 选中元素的包围盒 |
|
||
|
||
### ChannelAppliedEventArgs 结构
|
||
| 字段名 | 类型 | 说明 |
|
||
|-------|------|------|
|
||
| AppliedCount | int | 成功应用的元素数量 |
|
||
| ChannelType | LogisticsElementType | 应用的通道类型 |
|
||
| ApplyTime | DateTime | 应用时间 |
|