测量最长边缘段

本工具用于测量最长边缘段。

返回结果为段 ROI，可以在工具测量圆到段、测量段到点和测量段到段中使用。该工具还返回与虚拟水平线相关的“段长度”和“段方向”。即使图像未包含完整或平滑的边缘，该工具也可以返回段 ROI。

本工具可使用 easyTouch 和 easyTouch+。这意味着，您可以选择要在图像中以交互方式测量的最长的边段。将鼠标移至要测量最长段的边缘。MERLIC 将显示所建议的最长边缘段的预览。如果您要测量预览的段，单击该边缘以确认选择。参数会自动调整以拟合选定的段。但是，您仍然可以在在相应的连接器中手动调整它们。

或者您可以使用感兴趣区域 (ROI) 进行测量。绘制 ROI 到图像。如果 ROI 包含适合当前参数设置的边缘段，则会自动确定和测量它们。如果没有 ROI，该工具将在连接图像后立即寻找整个图像中最长的边缘段。ROI 也可确定起点和终点，以及边缘的长度。使用较小的 ROI 来检测曲线的边缘。

参数

基本参数

图像：

此参数表示测量最长边缘段的输入图像。如果前面一个工具的结果可提供图像，则会自动与其进行连接并将其用作输入图像。

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

边缘对比度：

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

边缘宽度：

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

其他参数

ROI：

此参数定义需要处理的感兴趣区域 (ROI)。ROI 和“处理区域”并集之外的图像部分将不进行处理。此外，如果其中一个为空，将处理两者交集的图像部分。如果两者均为空，将处理整个图像。 但是，如果使用 easyTouch 确定参数，将仅使用“处理区域”进行测量。

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

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

标定数据:

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

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

对齐数据:

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

测量失败：

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

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

处理区域：

此参数定义需要处理的区域。ROI 和“处理区域”并集之外的图像部分将不进行处理。此外，如果其中一个为空，将处理两者交集的图像部分。如果两者均为空，将处理整个图像。

默认情况下，“处理区域” 定义为空区域。要指定 “处理区域”，您需要将该参数连接至前一工具的适当区域结果，以确保某个区域会传输到此工具。

如果使用 easyTouch 确定参数，将仅使用“处理区域”进行测量。如果“处理区域”未定义，将使用整个图像进行测量。

结果

基本结果

段：

此结果返回已测量最长边缘段的图形表示。返回的结果为段 ROI。如果测量对象不止一条边缘段，则“段”包含所有最长边缘段的 ROI。

段长度：

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

段方向：

此结果返回已测量的最长边缘段与通过段中心点的虚拟水平线之间的角度。返回结果为实数，单位为度。其中，段中心点是旋转中心。若边缘段的端点在水平轴以上，则角度值（正值）为水平线沿逆时针方向旋转到最长边缘段的角度。若端点在水平轴以下，则方向值（负值）为水平线沿顺时针方向旋转到最长边缘段的角度。

工具状态：

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

其他结果

边缘轮廓：

此结果返回测量过程所使用的边缘段轮廓。

处理时间:

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

应用程序示例

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

• measure_distance_segment_circle_calibrated.mvapp