# ExtractCalibrationPoints

ExtractCalibrationPoints 函数从棋盘格校准网格图案的图像中提取校准点。校准点可以被其他校准工具使用。

## ExtractCalibrationPoints 概述

校准图像，即具有基准和已知比例的棋盘格网格，用于训练 ExtractCalibrationPoints 函数。在分析过程中，它找到网格单元交叉点的像素位置，然后将它们映射回网格图案模型。该函数返回 CalibPoints 数据结构以及在网格中找到的点数。这组校准点以后可以被其他校准工具使用（如 CalibratePoints）来校正畸变，将图像坐标映射到实际坐标，反之亦然。

注意:使用带有基准标记的棋盘格校准网格。目前不支持使用点网格或没有基准的网格进行校准。

## ExtractCalibrationPoints 输入

参数 | 说明
--- | ---
图像 | 此参数必须引用包含有效 图像 数据结构的电子表格单元格。默认情况下，引用的单元格是 $A$0，其中包含由 返回的 Image 图像数据结构。
固定 | 定义相对于固定输入或视觉工具函数的图像坐标系输出的关注区域 (ROI)。根据“固定坐标”来设置的 ROI 可以确保如果“固定坐标” 被旋转或转换，相应的 ROI 也会根据“固定坐标”而旋转或转换。
X | 图像坐标中的 X 偏移。
Y | 图像坐标中的 Y 偏移。
区域 | 也称为关注区域 (ROI)，指定要进行分析的图像区域。双击区域参数以创建可以变换和旋转的交互图形模式。选择此参数并按属性表的作业编辑工具栏上的最大化区域按钮，自动拉伸区域以覆盖整个图像。
X | 在固定坐标中，偏移原点的 x 值。
Y | 在固定坐标中，偏移原点的 y 值。
宽度 | 沿区域 x 轴的尺寸。
高度 | 沿区域 y 轴的尺寸。
提取事件 | 按下课从图像中提取校准点。
网格间距单位 | 指定用于校准网格图案间距的测量单位。
微米 = 0 | “微米”
毫米 = 1 （默认值） | “毫米”
厘米 = 2 | “厘米”
英寸 = 3 | “英寸”
X 网格间距 | 沿 x 轴的校准网格图案间距的实际测量值。
Y 网格间距 | 沿 x 轴的校准网格图案间距的实际测量值。
角度范围 | 选择启用查找公差参数并限制用于搜索网格的角度范围。（默认值 = 0，未选中） 提示: 当网格和相机之间的相对方向众所周知时，限制角度范围可以加快点提取。
查找公差 | 用于搜索网格的开始和结束角度范围。
角度开始 | 网格水平轴和相机水平轴之间的最小可能角度。 （最小值 = -180，最大值 = 180，默认值 = -180）
角度结束 | 网格水平轴和相机水平轴之间的最大可能角度。 （最小值 = -180，最大值 = 180，默认值 = +180）
注意:默认情况下，角度范围不受限制。必须选中角度范围复选框才能限制在“查找公差”参数中设置的角度开始和结束范围。
超时 | 指定允许 ExtractCalibrationPoints 函数运行的时间长度（毫秒）。超过超时后，函数执行将停止。 （最小值 = 0，最大值 = 9999999，默认值 = 120000） 注意: 超时用作故障保护，一旦超过超时，就会导致可能运行很长时间的进程终止。超时并不准确，因为执行可能会在指定时间内运行几秒钟。
显示 | 指定 ExtractCalibrationPoints 在图像上的图形叠加显示模式。
0 = 隐藏所有（默认值） | 所有图形都将隐藏，除非包含 ExtractCalibrationPoints 函数的单元格在电子表格中突出显示。
1 = 仅结果图形 | 显示叠加在输入图像上的提取点位置
2 = 输入和结果图形 | 显示提取的点位置和搜索区域。

## ExtractCalibrationPoints 输出

返回 | CalibPoints 数据结构，如果任何输入参数无效，则为 #ERR。 下列 校准Vision Data Access functions 自动插入到电子表格中以创建结果表：
标签 | 函数 | 说明
点 | GetNFound() | 返回在校准网格图像中找到的点数。