# TransformImage

TransformImage 通过使用由 CalibratePoints 函数产生的 Calib 数据结构，生成 Image 数据结构，以对畸变进行说明。

注意:此函数仅输出灰度图像。

## TransformImage 概述

TransformImage 使用被 ExtractCalibrationPoints 引用为参数的 CalibratePoints Calib 数据结构和 Image 数据结构生成图像 Image 结构，对线性、非线性和镜头畸变进行说明，以返回图像的“未畸变”版本。这个新的输出图像具有内部 2D 转换，并且基于实际坐标。

注意:将函数添加到电子表格、更改指定区域或加载具有该函数的作业时所产生的 TransformImage 训练期间在具有 640 x 480 分辨率的 In-Sight 视觉系统上可能需要长达 3 秒，在具有 1600 x 1200 分辨率的视觉系统上长达 30 秒。

2D 工具的尺寸为 640x480。但对于 3D - A1000，尺寸变成了 1430x1006，对于 3D - L4000 ，尺寸变成了 2880x8000。这样，A1000 系列视觉系统当前采集的最大行数为 1430，L4000 系列视觉系统采集的最大行数为 2880。对于 A1000 In-Sight 设备而言最大宽度为 1006，对于 L4000 In-Sight 设备而言最大宽度为 8000。

## TransformImage 输入

参数 | 说明
图像 | 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 坐标变换函数.
校准 | 此参数必须引用包含由 Calibrate 函数创建的有效 Calib 数据结构的电子表格单元格。
区域 | 也称为关注区域 (ROI)，指定要进行分析的图像区域。双击区域参数以创建可以变换和旋转的交互图形模式。选择此参数并按属性表的作业编辑工具栏上的最大化区域按钮，自动拉伸区域以覆盖整个图像。
X | 在固定坐标中，偏移原点的 x 值。.
Y | 在固定坐标中，偏移原点的 y 值。
宽度 | 沿区域 y 轴的尺寸。
高度 | 沿区域 x 轴的尺寸。
图像比例 | 指定显示变换图像的比例。最小设置为 0.01，最大值为 10.00，默认设置为 1.000。
参考点 | 指定变化的原点参考点。
0 = 图像中心（默认） | 参考点将是图像的中心。
1 = 区域中心 | 参考点将是 ROI 的中心。
显示 | 指定图像上 TransformImage 图形的显示模式。
0 = 全部隐藏 | 所有图形都将隐藏，除非包含 TransformImage 函数的单元格在电子表格中突出显示。
1 = 仅结果图形 | 畸变图像将始终显示。
2 = 输入和结果图形 | 输入图像区域和畸变图像将始终显示。

## TransformImage 输出

返回 | 包含已处理图像的 Image 数据结构，如果任何输入参数无效，则为 #ERR。 新的输出图像基于实际坐标；参考此图像的 In-Sight 视觉工具将报告实际坐标值中的结果。 注意:Image 数据结构中已处理的图像区域的内容不与作业一起保存。