132 lines
3.8 KiB
Markdown
132 lines
3.8 KiB
Markdown
# 参数调试文档
|
||
|
||
---
|
||
|
||
## 一、基本说明
|
||
|
||
- **版本号**：`v1.0.10`
|
||
- **用途**：用于测试视觉算法运行参数，包括分辨率、帧率、缩放比例、颜色空间采样及检测框显示等。
|
||
- **适用算法**：OCR、色块、AprilTag、交叉点
|
||
|
||
---
|
||
|
||
## 二、菜单项配置说明
|
||
|
||
> 屏幕无操作十秒后，中心菜单项自动隐藏
|
||
|
||
### 分辨率
|
||
|
||
支持以下预设分辨率选项：
|
||
|
||
```
|
||
(240, 240)
|
||
(320, 240)
|
||
(320, 320)
|
||
(416, 416)
|
||
(448, 448)
|
||
(552, 368)
|
||
(640, 480)
|
||
(640, 640)
|
||
|
||
(1024, 720)
|
||
(1104, 736)
|
||
(1280, 720)
|
||
|
||
(1656, 1096)
|
||
(1920, 1080)
|
||
(2560, 1440)
|
||
```
|
||
|
||
> 💡 高分辨率提升精度但会增加计算负载。
|
||
|
||
---
|
||
|
||
### FPS
|
||
|
||
提供以下帧率选项：
|
||
|
||
- `30 FPS` —— 平衡性能与流畅度
|
||
- `60 FPS` —— 高流畅度，适用于高速运动场景
|
||
|
||
---
|
||
|
||
### 缩放比例
|
||
|
||
支持从 **100% 到 195%**，以 **5% 为步长**递增：
|
||
|
||
```
|
||
100%, 105%, 110%, ..., 190%, 195%
|
||
```
|
||
|
||
---
|
||
|
||
### LAB
|
||
|
||
- 支持采集**三个点**的 LAB 颜色值。
|
||
- 程序自动根据采集点计算并显示 **LAB 范围**。
|
||
- 各通道含义：
|
||
- `L`：亮度（Lightness）
|
||
- `A`：红绿轴（负值偏绿，正值偏红）
|
||
- `B`：蓝黄轴（负值偏蓝，正值偏黄）
|
||
|
||
> 适用于“色块”等基于颜色阈值的检测算法，快速设定颜色过滤区间。
|
||
|
||
---
|
||
|
||
### 检测框
|
||
|
||
控制检测结果中各信息字段的显示开关：
|
||
|
||
| 字段 | 含义 |
|
||
| ---- | -------------------------- |
|
||
| `i` | 检测目标序号（ID） |
|
||
| `x` | 目标左上角 x 坐标 |
|
||
| `y` | 目标左上角 y 坐标 |
|
||
| `w` | 目标宽度 |
|
||
| `h` | 目标高度 |
|
||
| `v` | 检测值（如OCR识别内容、AprilTag码ID等） |
|
||
| `r` | 目标旋转角度（AprilTag码的旋转角度） |
|
||
| `cx` | 目标中心 x 坐标 |
|
||
| `cy` | 目标中心 y 坐标 |
|
||
|
||
> 适用于“色块”、“AprilTag”等输出矩形框和结构化数据的算法。可按需开启/关闭显示字段，便于调试与展示。
|
||
|
||
---
|
||
|
||
### 色块配置
|
||
|
||
控制色块合并参数：
|
||
|
||
| 字段 | 含义 |
|
||
| -------- | -------------------------------------------------------------------------- |
|
||
| 合并距离 | 默认值为 0。用于扩大/缩小外接矩形的尺寸。例如：合并距离设为 10 时，外接矩形间距为 10 像素的色块会被合并，即距离小于10像素的色块会被合并 |
|
||
| 检测框最小X比例 | 默认值为0%。用于设置`面积阈值=最小X尺寸 * 最小Y尺寸`。<br>色块的面积、宽度分别不低于面积阈值、最小X尺寸，否则不返回。 |
|
||
| 检测框最小Y比例 | 默认值为0%。用于设置`面积阈值=最小X尺寸 * 最小Y尺寸`。<br>色块的面积、高度分别不低于面积阈值、最小Y尺寸，否则不返回。 |
|
||
| 合并开关 | 默认为关，设置合并距离为0时自动关闭，设置合并距离大于0时自动开启。开启状态下，小于合并距离的色块会被合并。 |
|
||
|
||
---
|
||
|
||
### 交叉点配置
|
||
|
||
交叉点检测本质上是线段检测算法的一种衍生形态，因此相关配置内容包含线段检测算法的参数。
|
||
|
||
| 字段 | 含义 |
|
||
| ---- | ------ |
|
||
| 合并距离 | 测试中... |
|
||
| 合并角度 | 测试中... |
|
||
|
||
---
|
||
|
||
### 算法列表
|
||
|
||
当前支持算法列表
|
||
|
||
| 算法名称 | 说明 |
|
||
| ------------ | ---------------------------- |
|
||
| **OCR** | 光学字符识别，提取图像中的文字内容 |
|
||
| **色块** | 基于颜色（如LAB阈值）检测连通区域，输出色块位置与属性 |
|
||
| **AprilTag** | 检测AprilTag二维码，输出ID、位置、姿态等信息 |
|
||
| **交叉点** | 测试中... |
|
||
|
||
---
|