测量平行边

使用此工具测量平行边，例如，测量一个对象的宽度。

本工具可使用 easyTouch 和 easyTouch+。这意味着您可以在图像中以交互的方式选择要测量的边缘，而相应的参数会自动调整。该工具将根据给定的参数和图像中的边缘（无论是否平行）插入平行边缘。将鼠标指针移至其中一条要测量的平行边上方。MERLIC 将显示感兴趣区域 (ROI) 及其所含建议边缘对的预览。鼠标指针的位置影响相应平行边缘的搜索，即，平行边缘取决于鼠标指针停放的边缘在哪一侧。MERLIC 在鼠标指针停放的一侧搜索平行边缘。因此，如果您将鼠标从边缘的一侧移动到另一侧，所建议的边缘预览也会发生改变。如果要测量 easyTouch 预览的边缘，单击边缘对以确认选择。参数会自动调整以拟合选定的边缘。但是，您仍然可以在在相应的连接器中手动调整它们。

要将更多平等边缘添加到测量中，可以使用 easyTouch+，即通过按 Ctrl 键并选择其他边缘对。MERLIC 将自动检查所选边缘对是否符合上一选择的当前参数设置。如果不符合，例如，因为鼠标悬停在具有相反边缘过渡的边缘对上，MERLIC 将立即给出相应边缘将被 easyTouch+ 忽略的反馈。

或者您可以使用感兴趣区域 (ROI) 进行测量。如果 ROI 包含适合当前参数设置的可能的边缘对，则会自动确定和测量它们。ROI 也可确定起点和终点，以及边缘的长度。使用较小的 ROI 来检测曲线的边缘。

请注意 ROI 和边缘对的不同颜色。ROI 颜色在红色和绿色间切换。这表示 ROI 范围内的边缘是否清晰，如下表所示。

示例	描述
	绿色高亮显示的 ROI 表示清晰边缘对。
	红色高亮显示的 ROI 表示 ROI 内存在多个平行边缘导致的不清晰边缘对。

建议的平行边缘的颜色在蓝色和红色间切换，如下所示。这表示建议边缘对的边缘过渡。

示例	描述
	如果之前未训练边缘对或者之前训练的边缘对的边缘过渡匹配当前训练的边缘对的边缘过渡，则预览的建议边缘将采用蓝色高亮显示。
	在使用 easyTouch+ 时，红色边缘色表示与之前训练的边缘对相反的边缘过渡。

参数

基本参数

图像：

此参数表示测量平行边的输入图像。

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

边缘对比度：

此参数定义了平行边相对于背景的对比度。该参数定义为灰度值，并默认设为 10。一旦选定某个要测量的平行边缘对，该边缘对的“边缘对比度”也就随即确定并被采用。如要使用 easyTouch+ 添加更多平行边缘对，则在将每个边缘对添加到选择中时，“边缘对比度”的值会自动调整。不过，您也可以在相应的连接器中手动更改该值。

边缘宽度：

此参数定义了边缘的宽度。它以像素为单位并默认设为 2 像素。一旦选定某个要测量的边缘对，其边缘的“边缘宽度”也就随即确定并被采用。如要使用 easyTouch+ 添加更多平行边，则在将每个边缘对添加到选中对象中时，“边缘宽度”的值会自动调整。不过，您也可以在相应的连接器中手动更改该值。

边缘变换：

该参数定义了边缘对的转变属性。转变的确定顺序为由内到外。默认情况下，此参数设置为 “任意”。一旦选定某个要测量的边缘对，该边缘对的“边缘变换”值也就随即确定。该值会针对添加的每一个边缘对进行自动调整。

“边缘变换”取决于鼠标指针停放在边缘段在哪一侧，即搜索的是平行边缘的哪一侧。如果鼠标停放的一侧的灰度值较高，“边缘变换”将确定为“暗到亮”，因为确定的转变方向为由外到内。因此，鼠标指针的位置也影响 easyTouch 如何确定值。

值	描述
亮到暗	边缘对的边缘由亮变暗，即，边缘的灰度值由大变小。 如果设置为该值，则测量对象仅限于具有这种转变属性的边缘。其他边缘对将被排除在测量范围之外。
暗到亮	边缘对的边缘由暗变亮，即，边缘的灰度值由小变大。 如果设置为该值，则测量对象仅限于具有这种转变属性的边缘。其他边缘对将被排除在测量范围之外。
任意	边缘对的边缘可以朝着任意方向转变，即，边缘的灰度值既可以由大变小，也可以由小变大。 如果设置为该值，则测量对象包括所有边缘对。

其他参数

ROI：

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

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

对齐数据:

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

标定数据:

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

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

测量失败：

此参数定义了无法进行测量时结果“对象宽度”返回的值。默认情况下，此参数设置为 “忽略”。 您可以在相应连接器中将参数设置为下列值。

值	描述
忽略	如果无法进行测量，将不返回任何值。
-1	如果无法进行测量，将返回 -1。 您可以直接在连接器的输入字段中输入任何想要返回的数字或字符串来代替它。
*	如果无法进行测量，将返回 *。您可以直接在连接器的输入字段中输入任何想要返回的数字或字符串来代替它。

结果

基本结果

平行边：

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

对象宽度：

此结果为已测量的平行边之间的距离。返回的结果为实数，单位为像素。如果使用了“标定数据”，距离会以现实坐标返回。如果测量对象不止一个平行边缘对，则将以元组形式返回相应的宽度。

工具状态：

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

其他结果

处理时间:

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

应用程序示例

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

• measure_distance_to_center_led.mvapp