测量行间距

使用此工具测量行间对象距离和间隔,即平行边缘对的距离。

本工具可使用 easyTouch。这意味着您可以在图像中以交互的方式选择要测量的行间边缘,而相应的参数会自动调整。将鼠标移至要测量的行间边缘上方。MERLIC 将显示所建议的行间平行边的预览。鼠标指针的位置影响相应边缘对的搜索,即,相应边缘取决于鼠标指针停放在哪一侧。MERLIC 将鼠标停放的一侧解释为要测量的对象一部分,而另一侧解释为间隔的一部分。因此,如果您将鼠标从边缘的一侧移动到另一侧,所建议的边缘预览也会发生改变。如果您要测量预览的行间距,单击该边缘以确认选择。边缘以边缘对的形式处理。参数会自动调整以拟合选定的边缘。但是,您仍然可以在在相应的连接器中手动调整它们。

或者,您也可以使用感兴趣区域 (ROI) 进行测量。绘制 ROI 到图像。如果 ROI 包含适合当前参数设置的行间边缘,则会自动确定和测量它们。此工具仅支持使用一个 ROI。如果有多个 ROI 可用,无论是来自与前一工具建立的连接,还是通过使用 ROI 按钮绘制出的多个 ROI,仅最后创建的 ROI 将用于处理。

参数

基本参数

图像

此参数表示测量行间距对象和间隔的输入图像。

如果在此工具中将彩色图像用作输入图像,仅第一个通道(即红色通道)将用于处理。

边缘对比度

此参数定义了边缘相对于背景的对比度。该参数定义为灰度值,并默认设为 10。一旦选中某个要测量的行间参考对象,相应边缘的“边缘对比度”值也就随即确定并采用。不过,您也可以在相应的连接器中手动更改该值。

边缘变换

该参数定义了选定对象对应的边缘对的转变属性。转变的确定顺序为由外到内。默认情况下,此参数设置为 任意。一旦选定某个要测量的行间参考对象边缘对,“边缘变换”相应的值也就随即确定。

边缘变换”取决于鼠标指针停放的边缘段在哪一侧以及由此选择哪一侧作为要测量的对象之一。如果鼠标停放的一侧的灰度值较高,“边缘变换”将确定为“暗到亮”,因为确定的转变方向为由外到内。因此,鼠标指针的位置也影响 easyTouch 如何确定值。

描述

亮到暗

边缘对的边缘由亮变暗,即,边缘的灰度值由大变小。

如果设置为该值,则测量对象仅限于具有这种转变属性的边缘。其他边缘对将被排除在测量范围之外。

暗到亮

边缘对的边缘由暗变亮,即,边缘的灰度值由小变大。

如果设置为该值,则测量对象仅限于具有这种转变属性的边缘。其他边缘对将被排除在测量范围之外。

任意

边缘对的边缘可以朝着任意方向转变,即,边缘的灰度值既可以由大变小,也可以由小变大。

如果设置为该值,则测量对象包括所有边缘对。

边缘宽度

该参数定义了行间边缘的“边缘宽度”。它以像素为单位并默认设为 2 像素。一旦选定某个要测量的行间参考对象边缘,相应边缘的“边缘宽度”值也就随即确定并采用。不过,您也可以在相应的连接器中手动更改该值。

其他参数

ROI

此参数定义需要处理的感兴趣区域 (ROI)。默认情况下,ROI 定义为空。如果想要使用 ROI 进行处理,您必须将参数连接至前一工具的适当 ROI 结果,或者必须使用可用的 ROI 按钮在图像中绘制新的 ROI。

工具会检查 ROI 是否包含符合当前参数设置的行间距边缘,例如,如果“边缘变换”设置为“暗到亮”,工具会沿 ROI 方向搜索是否有从暗变亮的行间距边缘。如果找到合适的边缘,它们会用于测量。

此工具仅支持使用一个矩形 ROI。如果参数包含多个 ROI,仅最后创建的 ROI 将用于处理。

对齐数据:

此参数表示用于对齐 ROI 的对齐数据。默认情况下不会连接对齐数据,因此不显示任何效果。如果想要使用特定对齐数据,您必须将参数连接至前一工具的适当结果,例如通过匹配确定对齐确定与直线边缘对齐对齐图像旋转图像

标定数据:

此参数定义校正可能的镜头失真和相对于图像平面的相机位置所需的标定数据。默认情况下,不定义任何标定数据。如果想要使用标定数据,您必须将参数连接至前一工具的适当结果(例如,标定相机),以确保标定数据会传输到此工具。它会立即应用到图像。

如果此工具使用了“标定数据”,则表示像素值的所有结果都将自动转换为对应的现实坐标。

参考对象宽度

该参数定义了所选参考对象的近似宽度,即通过鼠标使用 easyTouch 选定的边缘对之间的距离。因此“参考对象宽度”定义了在行间搜索其他边缘对时的预期宽度。它以像素为单位并默认设为 2 像素。一旦选定某个要测量的行间参考对象边缘对,“参考对象宽度”相应的值也就随即确定并采用。必要时,您可以在相应的连接器中更改“参考对象宽度”值。

参考对象容差

此参数定义行间允许对象宽度的容差值比值。如果使用 easyTouch 选择边缘对为参考对象,则可搜索可能属于一个行间的更多边缘对。“参考对象容差”定义了行间对象的实际宽度与定义所选参考对象宽度的“参考对象宽度”的差异程度。

默认情况下“参考对象容差”设置为 0.9。这表示,对象宽度与参考对象宽度最高差异 90%。所有宽度在定义的容差范围内的对象的平行边缘对包含在测量范围内。当使用 easyTouch 选择行间边缘对时,不调整此参数值。必要时,您可以在相应的连接器中更改“参考对象容差”值。

结果

基本结果

平行边

此结果返回已测量行间平行边的图形表示。返回结果为矩形 ROI,其中,垂直于 ROI 方向箭头的 ROI 边缘为两条平行边。

对象宽度

此结果为所测量行间中的对象的宽度。它们由平行边之间的距离定义,平行边的每个边缘临近相同对象。宽度以 tuple 形式返回,并指定为实数,单位为像素。如果使用了“标定数据”,距离会以现实坐标返回。

间隔宽度

此结果返回所测量行间中的对象之间的间距宽度。它们由平行边之间的距离定义,平行边的每个边缘临近不同对象。宽度以 tuple 形式返回,并指定为实数,单位为像素。如果使用了“标定数据”,距离会以现实坐标返回。

中心距离

此结果返回已测量对象中心点之间的距离。它们以 tuple 形式返回,并指定为实数,单位为像素。如果使用了“标定数据”,距离会以现实坐标返回。如果仅找到并测量一个对象,将返回空值 tuple。

工具状态

工具状态”返回有关工具状态的信息,因此可用于处理错误。请参阅主题工具状态结果,了解关于不同工具状态结果的更多信息。

其他结果

处理时间:

此结果返回最近一次执行工具的持续时间(以毫秒为单位)。该结果作为附加结果提供。因此,默认情况下它是隐藏的,但是可以通过工具结果旁边的 按钮显示。有关更多信息,处理时间请参工具参考中所阅部分。

应用程序示例

此工具用于以下 MERLIC Vision App 示例:

  • calibrate_for_ruler_changed_distance.mvapp
  • calibrate_for_ruler_distorted.mvapp
  • calibrate_for_ruler_simple.mvapp