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