测量对边
本工具用于测量对边对。
此工具还可以测量不平行的边对，因此可以用于各种测量，例如线的长度或不规则形状的厚度。
本工具可使用 easyTouch 和 easyTouch+。这意味着，您可以在图像中以交互的方式选择要测量的边对，而相应的参数会自动调整。将鼠标移至其中一条要测量的边上方。MERLIC 将显示所建议的边缘对的预览。鼠标指针的位置影响相应对边的搜索，即，对边取决于鼠标指针放在哪一侧。MERLIC 在鼠标指针停放的一侧搜索对边。因此，如果您将鼠标从边缘的一侧切换到另一侧，所建议的边对预览也会发生改变。如果预览适用，单击边来确认选择。参数会自动调整以拟合所选边。但是，您仍然可以在在相应的连接器中手动调整它们。
或者您可以使用感兴趣区域 (ROI) 进行测量。绘制 ROI 到图像。如果 ROI 包含适合当前参数设置的边对，则会自动确定和测量它。ROI 也可确定起点和终点，以及边缘的长度。使用较小的 ROI 来检测曲线的边缘。
参数
基本参数
图像：
此参数表示测量边对的输入图像。
如果在此工具中将彩色图像用作输入图像，仅第一个通道（即红色通道）将用于处理。
边缘对比度：
此参数定义了边缘相对于背景的对比度。该参数定义为灰度值，并默认设为 10。一旦选定某个要测量的边对，其边的“边缘对比度”也就随即确定并被采用。如要使用 easyTouch+ 添加更多边对，则在将每个边对添加到所选内容中时，“边缘对比度”的值会自动调整。不过，您也可以在相应的连接器中手动更改该值。
边缘宽度：
此参数定义了边缘的宽度。它以像素为单位并默认设为 2 像素。一旦选定要测量的某个边对，其边的“边缘宽度”也就随即确定并被采用。如要使用 easyTouch+ 添加更多边对，则在将每个边对添加到所选内容中时，“边缘宽度”的值会自动调整。不过，您也可以在相应的连接器中手动更改该值。
边缘变换：
此参数定义了棱边的转变属性。转变的确定顺序为由外到内。默认情况下，此参数设置为 “亮到暗”。
一旦使用 easyTouch 选中要测量的某个边对，该边对的参数值也就随即确定。该值会针对添加的每一个边对进行自动调整。如果选定边缘之间的区域灰度值低于边缘外侧的灰度值，则“边缘变换”被确定为“亮到暗”。相反，如果边缘之间的灰度值更高，则“边缘变换”被确定为“暗到亮”。
如果您正在使用 ROI 进行测量，在 ROI 中搜索对边对并根据“边缘变换”的指定值选择边。沿着两种方向在 ROI 中搜索边：沿着 ROI 的方向与相反方向。
|
值 |
描述 |
示例图像 |
|---|---|---|
|
暗到亮 |
分隔暗部与亮部的第一组边缘（从较低到较高灰度值）将用作边缘对。 右侧图像显示参数设为“暗到亮”时在 ROI 中找到的边缘对。由于 ROI 的方向是从上向下，将在 ROI 中从上向下搜索图像寻找边缘。 从上面开始的第一条边缘符合从暗到亮的转变标准，因此，将用于边缘对。将从下往上搜索对边。在搜索方向中，第一条边也供边对使用。两条边之间的所有边将忽略。 |
|
|
亮到暗 |
分隔亮部与暗部的第一组边缘（从较高至较低灰度值）将用作边缘对。 右侧图像显示参数设为“亮到暗”时在 ROI 中找到的边缘对。由于 ROI 的方向是从上向下，将在 ROI 中从上向下搜索图像寻找边缘。 第二条边已经响应从亮到暗的转变，因此，将供边对使用。将从下往上搜索对边。在搜索方向中，第二条边也供边对使用，因为它是从亮从暗的第一条边。 |
|
|
任意 |
各边均可朝着任意方向转变，即从暗到亮或从亮到暗。找到的第一组边供对边对使用，无论它们采用哪种“边缘变换”。 右侧图像显示参数设为“任意”时在 ROI 中找到的边缘对。由于 ROI 的方向是从上向下，因此将在图像 ROI 中从上向下搜索一条边缘，然后从下向上寻找另一条边缘。 在本例中，发现的其搜索为从上到下的第一条边缘具有“暗到亮”转变，而发现的其方向为从下往上的对边则具有“亮到暗”转变。 |
|
其他参数
ROI：
此参数定义需要处理的感兴趣区域 (ROI)。在默认情况下，“ROI” 定义为空。如果想要使用 ROI 进行处理，您必须将参数连接至前一工具的适当 ROI 结果，或者必须使用可用的 ROI 按钮在图像中绘制新的 ROI。
工具会检查ROI是否包含符合当前参数设置的对边，例如，如果“边缘变换”设置为“暗到亮”，工具会沿 ROI 方向搜索是否有第一条边缘从暗变亮的边缘对。如果找到合适的边缘对，它们会用于测量。
对齐数据:
此参数表示用于对齐 ROI 的对齐数据。默认情况下不会连接对齐数据，因此不显示任何效果。如果想要使用特定对齐数据，您必须将参数连接至前一工具的适当结果，例如通过匹配确定对齐、确定与直线边缘对齐、对齐图像或旋转图像。
标定数据:
此参数定义校正可能的镜头失真和相对于图像平面的相机位置所需的标定数据。默认情况下，不定义任何标定数据。如果想要使用标定数据，您必须将参数连接至前一工具的适当结果（例如，标定相机），以确保标定数据会传输到此工具。它会立即应用到图像。
如果此工具使用了“标定数据”，则表示像素值的所有结果都将自动转换为对应的现实坐标。
最小边缘完整性：
|
显示 |
描述 |
|---|---|
|
|
此参数定义了必须由 ROI (3) 内检测的轮廓 (2) 支持的边缘 (1) 的最小分数。如果检测的轮廓占边缘不到 “最小边缘完整性”，MERLIC 将不会创建它们。在这种情况下，轮廓和边缘都不会显示。用于确定“最小边缘完整性”的轮廓可在 ROI 内的任何位置检测到。 “最小边缘完整性”被定义为介于 0 和 1 之间的值，并可以被解读为一个介于0至100%的百分比值。默认情况下设置为 0.4。但是，如果选择边缘，此值将由 easyTouch 自动确定。但是，您也可以手动调整参数值。 |
测量失败：
此参数定义了无法进行测量时结果“最小距离”、“最大距离”、“平均距离”、“边缘完整性”和“角度”返回的值。默认情况下，此参数设置为 “忽略”。 您可以在相应连接器中将参数设置为下列值。
|
值 |
描述 |
|---|---|
|
忽略 |
如果无法进行测量，将不返回任何值。 |
|
-1 |
如果无法进行测量，将返回 -1。 您可以直接在连接器的输入字段中输入任何想要返回的数字或字符串来代替它。 |
|
* |
如果无法进行测量，将返回 *。您可以直接在连接器的输入字段中输入任何想要返回的数字或字符串来代替它。 |
结果
基本结果
段：
此结果返回已测量边对的图形表示。返回结果为段 ROI。如果测量对象不止一条边对，则“段”包含所有边对的 ROI。
平均距离：
此结果返回边对之间的平均距离。测量垂直于边缘段的距离，此距离被定义为“最小距离”和“最大距离”的平均距离。返回的结果为实数，单位为像素。如果使用了“标定数据”，距离会以现实坐标返回。如果测量对象不止一个边对，则将以元组形式返回相应的平均距离。
角度：
此结果返回已测量边对之间的角度。将返回以度为单位的实数值，取值范围为 0° 到 180°。如果测量对象不止一个边对，则将以元组形式返回相应的角度。
工具状态：
“工具状态”返回有关工具状态的信息，因此可用于处理错误。请参阅主题工具状态结果，了解关于不同工具状态结果的更多信息。
其他结果
最小距离：
此结果返回边对之间的最短距离。返回的结果为实数，单位为像素。如果使用了“标定数据”，距离会以现实坐标返回。它被定义为垂直于边缘段的最小距离。如果测量对象不止一个边对，则将以元组形式返回相应的最短距离。
最大距离：
此结果返回边对之间的最长距离。返回的结果为实数，单位为像素。如果使用了“标定数据”，距离会以现实坐标返回。它被定义为垂直于边缘段的最大距离。如果测量对象不止一个边对，则将以元组形式返回相应的最长距离。
边缘完整性：
此结果返回已测量边对的实际“边缘完整性”。以介于 0 和 1 之间的实数返回百分比值。它用于指示边缘中有多少轮廓点可用于测量。如果测量对象不止一个边对，则将以元组形式返回相应的“边缘完整性”值。
已使用边缘：
此结果返回测量过程所使用的边对轮廓。“已使用边缘”中返回的轮廓可能根据图像的实际边缘有所不同，尤其是在 ROI 极小时。
处理时间:
此结果返回最近一次执行工具的持续时间（以毫秒为单位）。该结果作为附加结果提供。因此，默认情况下它是隐藏的，但是可以通过工具结果旁边的 
按钮显示。有关更多信息，处理时间请参工具参考中所阅部分。
应用程序示例
此工具用于以下 MERLIC Vision App 示例：
- measure_distance_to_center_led.mvapp
