gen_caltab（算子）

gen_caltab - 为具有矩形排列标记的校准板生成校准板描述文件和相应的PostScript文件。

gen_caltab（:: XNum，YNum，MarkDist，DiameterRatio，CalPlateDescr，CalPlatePSFile ?

描述

gen_caltab生成带有矩形排列标记的标准HALCON校准板的描述。该校准板由白色平面上的XNum乘以YNum黑色圆形标记组成，其被黑色框架包围。标记排列成矩形网格，YNum和XNum等距行和列。这些行和列之间的距离以米为单位定义参数MarkDist。标记的直径可以通过参数DiameterRatio设置，并由公式Diameter = MarkDist * DiameterRatio定义。使用0.01m的标记与0.5的直径比之间的距离，暗周围框架的宽度变为8cm，并且标记的半径设定为2.5mm。校准板的坐标系位于所有标记的重心中，其z轴指向校准板，x轴指向右侧，y轴指向下方。

文件CalPlateDescr包含校准板描述，例如，校准板的行数和列数，周围框架的几何形状（参见find_caltab），三角形方向标记，坐标系到z的板表面的偏移量-direction，以及校准板坐标系中给出的所有校准板标记的x，y坐标和半径。由t和z表示的方向和偏移的定义是可选的，可以注释掉。校准板描述的默认HALCON文件扩展名为“descr”。 gen_caltab生成的文件如下所示（注释在行的开头用’＃'标记）：

＃Plate Description Version 2
#HALCON版本7.1 - 2005年6月24日星期五16:41:00
＃标准校准板说明
＃用于HALCON中的摄像机校准
＃（由gen_caltab生成）
＃
＃
＃7行x 7列
＃宽度，黑框高度[米]：0.1,0.1
＃标记中心之间的距离[米]：0.0125

#y维（行）中的标记数
7

#x维中的标记数（列）
c 7

#z维坐标系的偏移量[米]（可选）：
z 0

＃校准板的矩形边框（边框和黑框）
＃校准板的边缘（min x，max y，max x，min y）[米]：
o -0.05125 0.05125 0.05125 -0.05125
＃黑框的外边框（min x，max y，max x，min y）[米]：
i -0.05 0.05 0.05 -0.05
＃由两个角点（x，y，x，y）[米]给出的三角形角标记
＃ （可选的）：
t -0.05 -0.0375 -0.0375 -0.05

＃黑框宽度[米]：
w 0.003125

＃校准标记：x y radius [米]

＃校准标记在y = -0.0375 m处
-0.0375 -0.0375 0.003125
-0.025 -0.0375 0.003125
-0.0125 -0.0375 0.003125
-3.46945e-018 -0.0375 0.003125
0.0125 -0.0375 0.003125
0.025 -0.0375 0.003125
0.0375 -0.0375 0.003125

＃校准标记在y = -0.025 m处
-0.0375 -0.025 0.003125
-0.025 -0.025 0.003125
-0.0125 -0.025 0.003125
-3.46945e-018 -0.025 0.003125
0.0125 -0.025 0.003125
0.025 -0.025 0.003125
0.0375 -0.025 0.003125

＃校准标记在y = -0.0125 m处
-0.0375 -0.0125 0.003125
-0.025 -0.0125 0.003125
-0.0125 -0.0125 0.003125
-3.46945e-018 -0.0125 0.003125
0.0125 -0.0125 0.003125
0.025 -0.0125 0.003125
0.0375 -0.0125 0.003125

＃校准标记在y = -3.46945e-018 m处
-0.0375 -3.46945e-018 0.003125
-0.025 -3.46945e-018 0.003125
-0.0125 -3.46945e-018 0.003125
-3.46945e-018 -3.46945e-018 0.003125
0.0125 -3.46945e-018 0.003125
0.025 -3.46945e-018 0.003125
0.0375 -3.46945e-018 0.003125

＃校准标记在y = 0.0125 m处
-0.0375 0.0125 0.003125
-0.025 0.0125 0.003125
-0.0125 0.0125 0.003125
-3.46945e-018 0.0125 0.003125
0.0125 0.0125 0.003125
0.025 0.0125 0.003125
0.0375 0.0125 0.003125

＃校准标记在y = 0.025 m处
-0.0375 0.025 0.003125
-0.025 0.025 0.003125
-0.0125 0.025 0.003125
-3.46945e-018 0.025 0.003125
0.0125 0.025 0.003125
0.025 0.025 0.003125
0.0375 0.025 0.003125

＃校准标记在y = 0.0375 m处
-0.0375 0.0375 0.003125
-0.025 0.0375 0.003125
-0.0125 0.0375 0.003125
-3.46945e-018 0.0375 0.003125
0.0125 0.0375 0.003125
0.025 0.0375 0.003125
0.0375 0.0375 0.003125
文件CalPlatePSFile包含校准板的相应PostScript描述。
注意

根据所使用的输出设备（例如，激光打印机）的精度，打印的校准板可能与校准板描述文件CalPlateDescr中的值不完全匹配。因此，可能必须校正校准板描述文件中的校准标记的坐标！

参数

XNum（input_control）整数→（整数）
x方向上的标记数量。
默认值：7
建议值：5,7,9
建议增量：1
限制：XNum> 1
YNum（input_control）整数→（整数）
y方向上的标记数量。
默认值：7
建议值：5,7,9
建议增量：1
限制：YNum> 1
MarkDist（input_control）real→（真实）
以米为单位的标记距离。
默认值：0.0125
建议值：0.1,0.0125,0.00375,0.00125
限制：0.0 <MarkDist
DiameterRatio（input_control）real→（真实）
标记直径与标记距离的比率。
默认值：0.5
建议值：0.5,0.55,0.6,0.65
限制：（0.0 <DiameterRatio）<1.0
CalPlateDescr（input_control）filename.write→（string）
校准板描述的文件名。
默认值：‘caltab.descr’
值列表：‘caltab.descr’，‘caltab_100mm.descr’，‘caltab_10mm.descr’，‘caltab_200mm.descr’，‘caltab_30mm.descr’
文件扩展名：.descr
CalPlatePSFile（input_control）filename.write→（string）
PostScript文件的文件名。
默认值：‘caltab.ps’
文件扩展名：.ps