标定板设计：Halcon支持的标定板类型、规格参数与描述文件

说到相机标定，很多人第一反应就是「找个棋盘格拍几张照片」。嗯，这话没错，但实际操作中，标定板选不对、参数设错了，后面标定结果能让你怀疑人生。我刚开始做视觉项目时，就吃过这个亏——随便打印了一张棋盘格，结果标定出来的内参偏差大得离谱，折腾了两天才发现是标定板规格没写对。

这一章，咱们就把标定板这件事彻底讲透。你想想看，标定板是标定的「基准尺」，它不准，后面所有测量都是空中楼阁。

2.1 Halcon支持的标定板类型

Halcon 官方支持三种标定板，我按使用频率排个序：

类型	描述	适用场景	我的推荐
棋盘格标定板	黑白交替的矩形网格，角点检测稳定	通用场景，单目/双目标定	新手首选，容错率高
圆点阵列标定板	规则排列的圆形标记点	高精度测量、远心镜头	精度要求高时用
环形编码标定板	带编码信息的圆环，可自动识别ID	多相机、大视野拼接	复杂系统才需要

2.2 标定板规格参数详解

选好类型后，接下来就是参数设置。这里我踩过不少坑，一个一个说。

2.2.1 棋盘格的关键参数

• 方格数量：例如 7×7、8×6（内角点数量）。注意，Halcon 里用的是内角点数量，不是格子数量。我见过有人把 8×8 格子写成 8×8 内角点，结果标定直接报错。
• 方格尺寸：单位是米（m），例如 0.0125 表示 12.5mm。这个值必须精确到微米级，打印误差会影响标定精度。
• 标记点类型：棋盘格不需要额外标记，但圆点阵列需要指定「黑色圆点、白色背景」还是反过来。

2.2.2 圆点阵列的关键参数

• 行列数：例如 7×7 表示 7 行 7 列共 49 个圆点。
• 圆点直径：单位米，例如 0.01 表示 10mm。
• 圆心间距：相邻圆点的中心距离，必须大于直径，否则圆点会重叠。

参数	棋盘格	圆点阵列
检测特征	角点（亚像素）	圆心（亚像素）
精度上限	较高	更高（圆心定位更稳定）
对遮挡敏感度	低	高（部分遮挡可能丢失整行）
描述文件生成	简单	稍复杂

2.3 标定板描述文件的生成与使用

描述文件，说白了就是一张「参数说明书」，告诉 Halcon 你的标定板长什么样。Halcon 通过 gen_caltab 算子来生成这个文件。

2.3.1 生成棋盘格描述文件

我个人习惯用下面这段代码，参数写清楚，一次生成终身使用：

* 生成棋盘格标定板描述文件
* 参数说明：
*   XNum, YNum：内角点数量（列数，行数）
*   MarkDist：方格边长（单位：米）
*   DiameterRatio：标记点直径与边长的比值（棋盘格设为0即可）
*   CalTabDescrFile：输出描述文件路径
*   CalTabPSFile：输出PostScript文件（用于打印）

gen_caltab (
    XNum, YNum, MarkDist, DiameterRatio,
    CalTabDescrFile, CalTabPSFile
)

* 实际示例：生成 7x7 内角点、方格边长 12.5mm 的棋盘格
gen_caltab (7, 7, 0.0125, 0, 'caltab_7x7_12.5mm.descr', 'caltab_7x7_12.5mm.ps')

2.3.2 生成圆点阵列描述文件

圆点阵列的生成稍微复杂一点，需要指定圆点直径和间距：

* 生成圆点阵列标定板描述文件
* 参数说明：
*   XNum, YNum：圆点数量（列数，行数）
*   MarkDist：圆心间距（单位：米）
*   DiameterRatio：圆点直径与间距的比值（例如0.5表示直径=间距的一半）
*   CalTabDescrFile：输出描述文件路径
*   CalTabPSFile：输出PostScript文件

gen_caltab (
    XNum, YNum, MarkDist, DiameterRatio,
    CalTabDescrFile, CalTabPSFile
)

* 实际示例：生成 7x7 圆点、间距 10mm、直径 5mm 的标定板
gen_caltab (7, 7, 0.01, 0.5, 'caltab_dot_7x7_10mm.descr', 'caltab_dot_7x7_10mm.ps')

2.3.3 描述文件的结构

生成的 .descr 文件其实是个文本文件，你可以用记事本打开看看。里面包含了：

• 标定板类型标识
• 所有标记点的世界坐标（3D 坐标，Z=0）
• 标记点的拓扑关系

我建议你生成后打开看一眼，确认坐标数据是否正确。有一次我生成后发现坐标全是 0，排查了半天才发现是 MarkDist 写成了 0。

2.4 知识体系总览

下面这张图把标定板设计的核心脉络串起来了，你可以对照着梳理自己的知识结构：

2.5 实战建议与避坑指南