# 参数调试文档

#复盘/0

---

#复盘/0 #临时/备忘 #状态/待处理

20260115-备忘-主题名-文件内容
## 一句话描述

[____待更新拍照算法、多色块算法____]

---



---

## 一、基本说明

- **版本号**：`v0.0.1`
- **用途**：超能小球视觉OCR辅助
- **适用算法**：OCR

---



### 缺陷
[____严重缺陷：不缺定字母无法通过正常流程，例如F被识别为 E和A____]


### 需求
[___第一阶段串口发送时长写入到配置文件中_____]


### 说明

串口格式采用 `#i0x0y0w0h0v[目标值]`

第一阶段目标值为：A-F（卡片值），默认值为A
第二阶段目标值为：1-10(点位)，默认值为0(无效点位)

## 二、菜单项配置说明

> 屏幕无操作十秒后，中心菜单项自动隐藏

### 分辨率

支持以下预设分辨率选项：

```
(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、位置、姿态等信息  |
| **交叉点**      | 测试中...                       |

---