# AcquireImage

AcquireImage 函数指定用于采集数字图像并将其传输到In-Sight 视觉系统的处理器的处理内存的参数。

In-Sight 视觉系统使用异步重置和逐行扫描捕获采集所有图像。灰度 视觉系统 会生成 8 位图像，而颜色 视觉系统 （用 C 后缀表示）生成 24 位图像。对 视觉系统 而言，图像采集过程在大约 250 µs 内开始，并进行如下操作：

- 图像传感器在曝光参数指定的时间内集成光照。
- 图像传感器中累积的图像被逐行传输到串行移位寄存器中。

- 对于每次行传输，传感器通过以下路径从图像传感器逐个像素地为移位寄存器计时：

  视频放大器 -> 增益和偏移 ->模数转换器 ->视觉处理器内存

包含采集图像的内存缓冲区在电子表格中表示为 Image 数据结构。AcquireImage 返回的 Image 数据结构转而又被处理图像区域的其他 In-Sight 电子表格函数引用。当采集新图像时，任何直接或间接依赖于采集图像数据的函数都将被强制更新。输入图像与电子表格中其他函数之间的这种关系是驱动在 In-Sight 视觉系统 上执行视觉任务的因素。有关依赖项和单元格执行顺序的更多信息，请参阅电子表格单元格执行。

最初创建电子表格时，AcquireImage 函数将自动添加并位于单元格中 A0 中。大多数视觉工具函数以及许多其他函数都通过将对单元格 A0 的绝对引用指定为其默认图像源来利用这一点。有关详细信息，请参阅单元格引用。

小心: 您可以从电子表格中删除 AcquireImage 函数，但不应该这样做，因为这会导致无法采集图像。如果您意外删除了单元格 A0 中的 AcquireImage 函数，通过编辑 > 撤消菜单或按 Ctrl+Z 撤销移除，或通过输入 AcquireImage() 单元格表达式来重新添加函数。

如果要更改 AcquireImage 的参数，请单击电子表格旁边的“采集”面板。有关详细信息，请参阅采集面板。

注意:

- 由于 函数不包含任何参数，因此在将单元格导出为单元格模板时不会保留所配置的采集设置。要导出采集设置，请将 ApplyAcquisitionSettings 添加到电子表格，启用您希望保留的参数，将设置设置为所需的值，然后将 ApplyAcquisitionSettings 导出为单元格模板。导入包含 ApplyAcquisitionSettings 的单元格模板时，一旦执行 ApplyAcquisitionSettings 单元格，采集设置将应用于 函数。
- 需要图像参数的函数必须引用包含有效 Image 数据结构的电子表格单元格。所有属性表中的默认图像参数引用是单元格 A0，其中包含由 AcquireImage 函数返回的 Image 数据结构。然而，图像 函数返回的 Image 数据结构也是对属性表中图像参数值的有效引用。

## ApplyAcquisitionSettings

在将参数从 采集面板拖放到电子表格时，ApplyAcquisitionSettings 函数被添加到电子表格，它允许在运行时编辑采集参数值，而无需打开采集面板。在采集面板上，拖放的参数显示蓝色的感叹号图标。此图标表示 ApplyAcquisitionSettings 函数正在覆盖参数，在将鼠标悬停在该图标上时，ApplyAcquisitionSettings 函数的单元格位置将显示为提示。

注意:

- 当从 ApplyAcquisitionSettings 属性表中拖放关联参数时，AcquireImage 属性表还会显示蓝色感叹号图标。有关详细信息，请参阅 ApplyAcquisitionSettings。
- 如果参数被多个 ApplyAcquisitionSettings 函数引用，则该图标指示 ApplyAcquisitionSettings 函数的单元格位置（最多五个位置）。

- 如果取消选中 ApplyAcquisitionSettings 属性表上的参数，关联参数的蓝色感叹号图标将不再在AcquireImage属性表中显示。