# FindCircleDefects

FindCircleDefects 根据用户设置的阈值将输入图像中圆环（环状）区域内的每个像素转换为黑色或白色，白色表示非圆形或非径向特征。用户在图像上定义和定位圆环，并选择该函数是计算圆形还是径向方向的像素梯度。等于或超过阈值水平的值在黑白输出图像中显示为白色像素。

## FindCircleDefects 输入

参数 | 说明
图像 | 此参数必须引用包含图像数据结构的电子表格单元格；默认情况下，此参数引用 A0，即包含数据结构的单元格。该参数还可以引用其他图像数据结构，例如由图像 视觉数据访问函数或坐标变换函数返回的数据结构
固定 | 定义相对于固定输入或视觉工具函数的图像坐标系输出的感兴趣区域 (ROI)。根据“固定坐标”来设置的 ROI 可以确保如果“固定坐标” 被旋转或转换，相应的 ROI 也会根据“固定坐标”而旋转或转换。 默认设置为(0,0,0)，图像的最左上方。
X | 图像坐标中的 X 偏移。
Y | 图像坐标中的 Y 偏移。
Theta | 图像坐标系中图像 X 轴的旋转。（顺时针 +/-360 度）
环形 | 也称为感兴趣区域 (ROI)，指定要进行分析的图像区域；创建可以平移和旋转的环形图像区域。如果选择了该参数，在属性表的工具栏中按“最大化区域”按钮时，区域会被自动拉伸并覆盖整个图像。
X | 在固定坐标中，偏移原点的 x 值。
Y | 在固定坐标中，偏移原点的 y 值。
内半径 | 内半径的大小。
外半径 | 外半径的大小。
注意： 固定和环形参数必须在图像范围内定义；否则，该函数将返回 #ERR。
缺陷类型 | 指定函数对其敏感的缺陷类型：圆形或径向。与周围像素灰度值不同的像素表示可能存在缺陷。
0 = 非圆形特征（默认） | 指定在圆形方向上计算像素梯度以检测与圆的偏差。
1 = 非径向特征 | 指定在径向计算环中的像素梯度，以检测与径向特征的偏差。
偏差 | 指定缺陷检测的容差程度。
0 = OFF（默认） | 指定对象是圆形的并且在环形空间中居中；容差设置较低。
1 = ON | 指定对象可以是椭圆形或偏离环形中心；容差设置较高。
合格阈值 | 以灰度值指定缺陷阈值。（0–255；默认 = 30）
显示 | 指定哪些图形叠加显示在图像上面。
0 = 隐藏所有（默认） | 可用的图形项将被隐藏，除非在电子表格中突出显示包含 FindCircleDefects 函数的单元格。
1 = 仅结果图形 | 处理后的图像将始终显示。
2 = 仅输入图形 | 与输入图像区域关联的图形项目将始终显示。

## FindCircleDefects 输出

返回 | 存储黑白（“二进制”）图像的图像数据结构，如果任何输入参数无效，则为 #ERR。
结果 | 最初将 FindCircleDefects 插入单元格时，会使用以下图像 视觉数据访问函数
标签 | 函数 | 说明
DarkCount | GetDarkPixelCount(图像) | 返回低于缺陷阈值的像素数；像素显示为黑色。
BrightCount | GetBrightPixelCount(图像) | 返回等于或高于缺陷阈值的像素数；像素显示为白色。
可以使用以下图像 视觉数据访问函数访问其他数据元素：
面积 | GetArea(图像) | 返回区域的面积。

## FindCircleDefects 示例

在此示例中，下面显示的合成圆形（左）和径向（右）对象用于演示 FindCircleDefect 的功能。这两个对象都是中灰色的，特征具有厚而深的内部和外部边界。

将该函数插入 In-Sight 电子表格后，用户通过双击属性表中的“环形”一词来定义环形，该词消失以显示叠加在图像上的红色环形。用户使用光标移动或调整环的大小，然后单击作业编辑工具栏上的确定 按钮以确认选择并返回到属性表。（也可以通过按 Enter 键或在环形内双击来确认选择。）下面是带有环形的对象的图像。

选择缺陷类型（非圆形或非径向），为偏差容差选择“开”或“关”，接受其他参数的默认设置并单击属性表中的确定完成此示例的配置并应用输入图像的函数。

下面是圆形对象的黑白输出图像，函数设置为检测非圆形缺陷，接受阈值参数默认值为 30，偏差容限为“Off”（左）和“On” （右）。请注意“Off”设置（左）有多严格，将圆形对象外边缘的像素标记为可能的缺陷，即使它们看起来是平滑圆形曲线的一部分。

下面是同一个圆形对象的黑白输出图像，现在该函数设置为检测非径向缺陷。该函数将外边界的内边缘和外边缘标记为可能的径向缺陷。

下面是径向对象的黑白输出图像，函数设置为检测非径向缺陷，接受阈值参数为 70，偏差容限为“Off”（左）和“On”（右）。同样，请注意“Off”设置（左）将径向特征的外边缘标记为可能缺陷的严格程度。

下面是同一径向对象的黑白输出图像，该工具现在设置为检测非圆形缺陷。该函数将环形内的所有径向特征标记为可能的圆形缺陷。

在实际应用中，用户接下来会将另一个工具引用到输出图像，以便可以就结果做出决定。