ScaleImage

ScaleImage 对输入图像或感兴趣区域 (ROI) 中的像素进行重新采样，以生成图像的缩小、放大、未旋转或未弯曲版本。该函数在 In-Sight 电子表格的左上角显示重新采样的图像。

ScaleImage 输入

参数	说明
图像	此参数必须在包含图像数据结构的电子表格单元格中使用单元格引用；默认情况下，此参数引用 A0，即包含由 函数返回的图像数据结构的单元格。此参数还可以引用其他图像数据结构，例如视觉工具图像函数返回的那些数据结构。
固定	定义相对于固定输入或视觉工具函数的图像坐标系输出的感兴趣区域 (ROI)。根据“固定坐标”来设置的 ROI 可以确保如果“固定坐标” 被旋转或转换，相应的 ROI 也会根据“固定坐标”而旋转或转换。 默认设置为(0,0,0)，图像的最左上方。 X 图像坐标中的 X 偏移。 Y 图像坐标中的 Y 偏移。 Theta 图像坐标系中图像 X 轴的旋转。（顺时针 +/-360 度）
区域	也称为感兴趣区域 (ROI)，指定要进行分析的图像区域。双击区域参数以创建可以变换和旋转的交互图形模式。选择此参数并按属性表的作业编辑工具栏上的最大化区域按钮，自动拉伸区域以覆盖整个图像。 X 在固定坐标中，偏移原点的 x 值。 Y 在固定坐标中，偏移原点的 y 值。 宽度 沿着区域的 x 轴的维度。 高度 沿着区域的 y 轴的维度。 角度 在固定坐标上的方向。 曲线 在区域 x 轴和相对的边界线之间的角度偏差。
X 缩放	指定区域 X 方向的百分比（10–1000；默认值 = 50。 ） 注意： 100 到 1000 之间的值指定上采样。例如，如果两个比率都指定为 200，则重新采样的图像将是指定区域的两倍。
Y 缩放	指定区域 Y 方向的百分比（10–1000；默认值 = 50。） 注意： 100 到 1000 之间的值指定上采样。例如，如果两个比率都指定为 200，则重新采样的图像将是指定区域的两倍。
显示 X	指定将显示重新缩放的图像的 x 坐标（默认值 = 0），此坐标相对于左上角。 注意： 指定值 -1 将确保该函数将缩放图像放置在与输入图像相同的 x 坐标处： 对于采集图像，将使用函数中指定的起始 x 坐标。因此，如果 ScaleImage 函数配置了显示 X 和显示 Y 参数设置为 0,0，并且图像是部分采集的，则 ScaleImage 函数将在采集的图像上方显示其输出。 对于其他视觉工具输出的图像，例如像筛选函数这样的图像工具，将使用定义输入图像的 x 坐标。例如，如果 PointFilter 函数在 X/Y 坐标 100100 处定义，则带有 -1 参数设置的引用 ScaleImage 函数将在 x 坐标 100 处显示。
显示 Y	指定将显示重新缩放的图像的 y 坐标（默认值 = 0），此坐标相对于左上角。
显示	指定哪些图形叠加显示在图像上面。 0 = 隐藏所有（默认） 输入区域边界和重新采样图像将被隐藏，除非电子表格中突出显示包含 ScaleImage 函数的单元格。 1 = 仅结果图形 重新采样的图像将始终显示。 2 = 仅输入图形 输入区域边界将始终显示。

ScaleImage 输出

返回	包含已处理图像的图像数据结构，如果任何输入参数无效，则为#ERR。

ScaleImage 示例

在本例中，输入图像中的对象是瓶子。本例的目的是将瓶子的大小缩放为 50%。

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

在 X 缩放和 Y 缩放字段中键入“50”，接受其他参数的默认设置并单击属性表中的确定完成此示例的配置并将函数应用于输入图像。

下面是瓶子的 50% 缩放图像。

用户还可以使用 ScaleImage 来“弯曲”或“旋转”对象，这样可以更轻松地将其他工具引用到处理后的输出图像。在此示例中，对象是一个略微弯曲的段，显示时移除了叠加（通过单击视图菜单上的叠加来实现）。该段也将缩放到 50% 的大小，以便输入图像和输出图像都可以轻松地放入同一视图中。

在插入函数、定义 ROI 并在属性表中的 X 缩放和 Y 缩放字段中指定“50”（前面在瓶子示例中描述）后，用户以增量方式更改“区域”参数下“角度”和“曲线”字段中的值，直到对象变直为止。接受其他参数的默认设置并单击属性表中的确定，即可完成此示例的配置并将该函数应用于输入图像。下图是中间弯曲的对象和左上角较小且“未弯曲”的对象的图像。

在此示例中，需要 17.390 的角度和 -36.389 的曲线来拉直曲线段。