# FindMultiLine

在图像区域内定位多个直线边缘。FindMultiLine 通过对在相对于区域局部坐标系的正 y 方向扫描的径向线段上的像素值求和来形成图像区域的一维投影。从投影图像数据中提取边缘变换。

## FindMultiLine 输入

参数 | 说明
图像 | 此参数必须引用包含图像数据结构的电子表格单元格；默认情况下，此参数引用 A0，即包含数据结构的单元格。该参数还可以引用其他图像数据结构，例如由图像 视觉数据访问函数或坐标变换函数返回的数据结构
固定 | 定义相对于固定输入或视觉工具函数的图像坐标系输出的感兴趣区域 (ROI)。根据“固定坐标”来设置的 ROI 可以确保如果“固定坐标” 被旋转或转换，相应的 ROI 也会根据“固定坐标”而旋转或转换。 默认设置为(0,0,0)，图像的最左上方。
X | 图像坐标中的 X 偏移。
Y | 图像坐标中的 Y 偏移。
Theta | 图像坐标系中图像 X 轴的旋转。（顺时针 +/-360 度）
区域 | 也称为感兴趣区域 (ROI)，指定要进行分析的图像区域。双击区域参数以创建可以变换和旋转的交互图形模式。选择此参数并按属性表的作业编辑工具栏上的最大化区域按钮，自动拉伸区域以覆盖整个图像。
X | 在固定坐标中，偏移原点的 x 值。
Y | 在固定坐标中，偏移原点的 y 值。
宽度 | 沿着区域的 x 轴的维度。
高度 | 沿着区域的 y 轴的维度。
角度 | 在固定坐标上的方向。
曲线 | 在区域 x 轴和相对的边界线之间的角度偏差。
注意： 固定和区域参数必须在图像的范围内定义；否则，该函数将返回 #ERR。
要查找的数量 | 指定函数将返回的最大边缘数（1 到传感器的图像宽度，负 1；默认值 = 3） 。可以检测到的最大边缘数比捕获图像的特定 In-Sight 相机的图像宽度小一（即，ISC 8402 相机的最大值为 1599，或比视觉系统的 1600 x 1200 图像分辨率小一）。
阈值 B2W | 指定可接受的最小黑白边缘对比度分数（0 到 100；默认值 = 25） 。FindMultiLine 将拒绝对比度分数低于阈值 B2W 的任何黑白边缘。边缘对比度通过扫描区域的灰度直方图进行归一化。
阈值 W2B | 指定可接受的最小白到黑边缘对比度分数（0 到 100 默认 = 25） 。FindMultiLine 将拒绝对比度分数低于阈值 W2B 的任何白到黑边缘。边缘对比度通过扫描区域的灰度直方图进行归一化。
归一化分数 | 指定边缘分数是否将通过区域的灰度直方图进行归一化。启用归一化分数后，原始边缘分数通过使用以下公式在图像区域内找到的最大对比度进行归一化： 分数 =（原始边缘分数）x（100/最大对比度） 其中，原始边缘分数是边缘的灰度差，而最大对比度是图像区域内最大和最小灰度（0 到 255）之间的差。 当归一化分数被禁用时，低对比度边缘的得分将低于高对比度边缘。使用以下公式： 分数 =（原始边缘分数）x (100/255)
0 = OFF | 不要归一化分数。
1 = ON （默认） | 归一化分数。
注意： 提示：此参数对于在低对比度区域中查找边缘很有用。如果预计要检测的边缘只有高对比度，请禁用此参数。
查找依据 | 指定函数将用于在多个候选边缘中选择边缘的边缘选择技术。
0 = 最佳分数（默认值） | 指定得分最高的边缘会受到最优先考虑。
1 = 第一条边缘 | 指定检测到的第一个边缘受到最优先考虑。
2 = 最后一条边缘 | 指定检测到的最后一个边缘受到最优先考虑。
角度范围 | 指定函数对边缘旋转的容差（0 到 10；默认值 = 0） 。该函数仍然会查找超出指定范围的边缘，但准确度可能不会那么高。 注意： 将此参数设置为大于 0 的值将降低函数的速度。
边宽度 | 指定发生边缘过渡的像素距离（1 到 50；默认值 = 3） 。边缘宽度用于在提取边缘之前对图像进行筛选。
显示 | 指定图像顶部 FindMultiLine 图形叠加的显示模式。
0 = 隐藏所有（默认） | 所有图形都将被隐藏，除非包含 FindMultiLine 函数的单元格是电子表格中的活动单元格。
1 = 仅结果图形 | 始终显示找到的线边缘。
2 = 输入和结果图形 | 输入图像区域和找到的线边缘都将始终显示。
3 = 显示全部：输入、结果和图表 | 始终显示输入图像区域、找到的线边缘和边缘的响应图。 注意： 边缘响应图表是一个可停靠窗口。有关详细信息，请参阅电子表格编辑器 - 图表主题。

## FindMultiLine 输出

返回 | 包含多个直线边缘段的边缘数据结构，如果任何输入参数无效，则为 #ERR。
结果 | 当 FindMultiLine 最初插入单元格时，系统会在电子表格中创建一个结果表。 边缘 视觉数据访问函数自动插入到电子表格中以创建结果表：
标签 | 函数 | 说明
--- | --- | ---
NFound | GetNFound(边缘) | NFound 是找到的边缘数。
可以使用边缘 视觉数据访问函数访问其他数据元素。