# 参数调试文档
---
## 一、基本说明
- **版本号**：`v1.0.9`
- **用途**：用于测试视觉算法运行参数，包括分辨率、帧率、缩放比例、颜色空间采样及检测框显示等。
- **适用算法**：OCR、色块、AprilTag、line
---
## 二、菜单项配置说明
### 设置分辨率
支持以下预设分辨率选项：
```
(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尺寸`。
色块的面积、宽度分别不低于面积阈值、最小X尺寸，否则不返回。 |
| 设置检测框最小Y比例 | 默认值为0%。用于设置`面积阈值=最小X尺寸 * 最小Y尺寸`。
色块的面积、高度分别不低于面积阈值、最小Y尺寸，否则不返回。 |
| 设置合并 | 默认为关，设置合并距离为0时自动关闭，设置合并距离大于0时自动开启。开启状态下，小于合并距离的色块会被合并。 |
---
### 设置直线算法配置
测试中...
---
### 算法列表
当前支持算法列表
| 算法名称 | 说明 |
| ------------ | ---------------------------- |
| **OCR** | 光学字符识别，提取图像中的文字内容 |
| **色块** | 基于颜色（如LAB阈值）检测连通区域，输出色块位置与属性 |
| **AprilTag** | 检测AprilTag二维码，输出ID、位置、姿态等信息 |
| **line** | 测试中... |
---