# TrainPatMaxRedLine

从图像中提取和训练图案以用于 FindPatMaxRedLine 函数。

注意: 使用默认图案区域 (320 x 440) 时，训练图案消耗大约 1MB，但图案大小因训练图案的大小而异。

## TrainPatMaxRedLine 输入

参数 | 说明
图像 | This parameter must reference a spreadsheet cell that contains an 图像 data structure; by default, this parameter references A0, the cell containing the data structure. This parameter can also reference other Image data structures, such as those returned by the 图像 Vision Data Access functions or 坐标变换函数.
固定 | 定义相对于固定输入或视觉工具函数的图像坐标系输出的关注区域 (ROI)。根据“固定坐标”来设置的 ROI 可以确保如果“固定坐标” 被旋转或转换，相应的 ROI 也会根据“固定坐标”而旋转或转换。 默认设置为(0,0,0)，图像的最左上方。
X (默认值= 0) | 图像坐标中的 X 偏移。
Y (默认值 = 0) | 图像坐标中的 Y 偏移。
Theta (默认值 = 0) | 图像坐标系中图像 X 轴的旋转。（顺时针 +/-360 度）
图案区域 | 也称为关注区域 (ROI)，指定要进行分析的图像区域。双击区域参数以创建可以变换和旋转的交互图形模式。选择此参数并按属性表的作业编辑工具栏上的最大化区域按钮，自动拉伸区域以覆盖整个图像。
X | 在固定坐标中，偏移原点的 x 值。
Y | 在固定坐标中，偏移原点的 y 值。
宽度（默认值 = 440） | 沿区域 x 轴的尺寸。
高度（默认值 = 320） | 沿区域 y 轴的尺寸。
角度（默认值 = 0） | 在固定坐标上的方向。
曲线（默认值 = 0） | 在区域 x 轴和相对的边界线之间的角度偏差。
注意:固定和区域参数必须在图像的范围内定义；否则，该函数将返回 #ERR。
外部区域 | 该参数使用对于电子表格单元格的单元格引用，其中包含 Annulus、Circle、区域、EditAnnulus、EditCircle、EditCompositeRegion、EditPolygon、 或 EditRegion。使用此参数时，该函数将忽略区域和固定设置并检查引用区域指定的图像区域。如果引用了编辑复合区域控件，则检查区域可以是多种形状的混合。在混合区域中的任何一个形状可以被指定从（遮蔽）检查区域中添加或删除。 注意:如果此参数已设置为对外部区域的引用，要使用函数的内部区域，必须通过输入值 0 代替单元格引用手动将此参数设置为零。否则，该函数将继续引用外部区域。
图案原点 | 指定训练图案原点的 X 和 Y，作为距训练区域中心的偏移量。
偏移量 X (默认值 = 0) | 指定距训练图案中心的 x 偏移量。
偏移量 Y (默认值 = 0) | 指定距训练图案中心的 y 偏移量。
自动选择粗糙度 | 启用后，自动选择要在粗糙搜索阶段期间使用的图案粒度大小。粗粒度用于查找大特征以在运行时图像中快速找到近似图案匹配。
0 = OFF | 将使用粗糙粒度
1 = ON （默认值） | 图案粒度大小是自动选择的。
自动选择精细 | 启用后，自动选择要在精细搜索阶段使用的图案粒度。 细粒度用于查找小特征以精确确定图案位置。
0 = OFF | 将使用细粒度。
1 = ON （默认值） | 图案粒度大小是自动选择的。
粗粒度 | 指定粗粒度作为像素值。粗粒度用于查找大特征以在运行时图像中快速找到近似图案匹配（1 到 30；4 = 默认值）。 注意:自动选择粗糙参数默认启用；禁用它以启用此参数。
细粒度 | 指定细粒度作为像素值。细粒度用于查找小特征以精确确定图案位置（1 到 10；1 = 默认值）。 注意: 自动选择精细参数默认启用；禁用它以启用此参数。 细粒度的值不能大于值粗粒度的值。
特征阈值 | 指定训练特征的最小对比度；降低该值以训练额外的低对比度特征，或增加该值以将其忽略（1 到 100；20 = 默认值）。
训练事件 | 指定对包含模型训练事件触发器的单元格的单元格引用。 注意:当属性表打开或事件触发器（例如按钮或其他有条件启用的单元格）非零时，就会进行训练。
重用训练图像 | 指定在修改图案设置参数（图案原点、自动选择粗糙、自动选择精细、粗粒度、细粒度或噪声阈值）时是否保存和使用用于训练图案的图像。
0 = OFF（默认值） | 当前图像（即图像参数中指定的图像）将用于训练/重新训练图案。
1 = ON | 如果图案原点、自动选择粗略、自动选择精细、粗粒度、细粒度和/或噪声阈值参数被修改，最初用于训练图案的图像将用于重新训练图案。首次启用时，图像参数标识的图像将用于训练图案，图像的副本将保存在作业中。对图案原点、自动选择粗略、自动选择精细、粗粒度、细粒度或噪声阈值参数所做的任何后续更改都将使用存储的图像进行。 注意: 启用此参数后，如果固定输入被修改，图案区域（或外部区域）被移动或修改，该函数将调整输入图像中的训练区域，保存新图像并重新训练图案。 如果重用训练图像参数为 ON（启用），但尚未训练图案，则该函数将返回 #ERR，直到参数为 OFF（禁用）并训练新图案。
超时 | 指定时间量，以毫秒为单位（0 到 30000； 0 = 默认值），该函数将在暂停执行并返回 #ERR 之前搜索有效图案。当设置为 0 时，该设置被禁用并且不应用超时。
显示 | 指定图像上 TrainPatMaxRedLine 图形的显示模式。
0 = 隐藏所有（默认值） | 所有图形都将隐藏，除非包含 TrainPatMaxRedLine 函数的单元格在电子表格中突出显示。
1 = 仅结果图形 | 图案的训练特征将始终显示。
2 = 输入和结果图形 | 输入图像区域、图案原点和训练的特征将始终显示。
3 = 显示全部：输入、结果和训练图像 | 输入图像区域、图案原点、训练特征和训练图像将始终显示。

## TrainPatMaxRedLine 输出

返回 | 包含训练图案的 Patterns 数据结构，如果任何输入参数无效，则为 #ERR。
结果 | 在 TrainPatMaxRedLine 最初插入单元格时，训练状态将自动出现在右侧相邻的单元格中。如果无法训练图案，则会插入#ERR。 一个图案Vision Data Access functions自动插入到电子表格中：
标签 | 函数 | 说明
--- | --- | ---
已训练 | GetTrained(图案) | 如果图案已成功训练，则返回 1，如果无法训练图案，则返回 0。