juechafun/01-项目/2512-MaixCam竞赛版/模块-参数调试-文档说明.md

参数调试文档

---

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

20260115-备忘-主题名-文件内容

一句话描述

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

---

---

一、基本说明

• 版本号：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尺寸。 色块的面积、宽度分别不低于面积阈值、最小X尺寸，否则不返回。
检测框最小Y比例	默认值为0%。用于设置面积阈值=最小X尺寸 * 最小Y尺寸。 色块的面积、高度分别不低于面积阈值、最小Y尺寸，否则不返回。
合并开关	默认为关，设置合并距离为0时自动关闭，设置合并距离大于0时自动开启。开启状态下，小于合并距离的色块会被合并。

---

交叉点配置

交叉点检测本质上是线段检测算法的一种衍生形态，因此相关配置内容包含线段检测算法的参数。

字段	含义
合并距离	测试中...
合并角度	测试中...

---

算法列表

当前支持算法列表

算法名称	说明
OCR	光学字符识别，提取图像中的文字内容
色块	基于颜色（如LAB阈值）检测连通区域，输出色块位置与属性
AprilTag	检测AprilTag二维码，输出ID、位置、姿态等信息
交叉点	测试中...

---