# ApplyAcquisitionSettings

通过从 AcquireImage 属性表中选择参数并将该参数拖到电子表格中可以添加 ApplyAcquisitionSettings 函数。ApplyAcquisitionSettings 函数用作 AcquireImage 函数中显示的采集参数的 setter。当要在运行时快速轻松地修改电子表格的采集设置，或者当要根据外部通信 (FFP) 或视觉工具的输出更新设置而不打开 AcquireImage 属性表时，此功能非常有用。

ApplyAcquisitionSettings 函数支持下列参数：

- 触发器类型、防抖 (ms)、延迟 (ms)、曝光 (ms)、偏移、增益、方向、起始行、行数
- 照明：模式、强度、已启用组、始终开启
- 高动态范围：HDR 模式、HDR+ 内核大小

注意:

- 您不能将其他参数（例如触发器模式）从 AcquireImage 属性表拖放到电子表格中。

- 连接设备不支持的参数显示为灰色，无法拖放。
- 由于 函数不包含任何参数，因此在将单元格导出为单元格模板时不会保留所配置的采集设置。要导出采集设置，请将 ApplyAcquisitionSettings 添加到电子表格，启用您希望保留的参数，将设置设置为所需的值，然后将 ApplyAcquisitionSettings 导出为单元格模板。导入包含 ApplyAcquisitionSettings 的单元格模板时，一旦执行 ApplyAcquisitionSettings 单元格，采集设置将应用于 函数。有关电子表格单元格模板的详细信息，请参阅从模板导出单元格或将单元格导入模板。

## 如何使用 ApplyAcquisitionSettings

1. 打开单元格 A0 中的 AcquireImage 属性表。
2. 将参数从 AcquireImage 属性表拖到电子表格中。

3. ApplyAcquisitionSettings 函数被添加到电子表格，并返回 AcquisitionSettings 数据结构、参数的标签和编辑控件。例如，如果您将 Debounce (ms) 参数拖放到电子表格中，AcquisitionSettings 数据结构、“防抖 (ms)”标签和编辑控件将填充到电子表格中。

4. 单击确定关闭 AcquireImage 属性表。

5. 如果要将另一个采集参数添加到电子表格，请打开 ApplyAcquisitionSettings 属性表。

   注意:强烈建议在创建第一个 ApplyAcquisitionSettings 函数后从 ApplyAcquisitionSettings 属性表中拖放参数。如果您从 AcquireImage 中拖动多个参数，则您正在创建多个 ApplyAcquisitionSettings 函数，而且为每个函数设置了哪些参数并不明显。

6. 选中所需参数的复选框。例如，如果要将“延迟 (ms)”参数添加到电子表格，请选中“延迟 (ms)”参数复选框。

7. 将参数拖放到电子表格中。

8. 参数的标签和编辑控件填充在电子表格中。例如，如果您将“延迟 (ms)”参数拖放到电子表格中，则电子表格中会填充“延迟 (ms)”标签和编辑控件。

9. 重复步骤 5 到 8，直到添加了所有需要的参数。
10. 根据需要修改编辑控件中的值。

11. 新值将在下一次图像采集时应用。

    注意:如果您使用相机触发模式，新值将在下一次设备触发后应用。

注意:

- 如果在电子表格中有多个 ApplyAcquisitionSettings 函数，只有最后更新的值将用于图像采集。
- 仅当将参数从 AcquireImage 或 ApplyAcquisitionSettings 属性表中拖放到电子表格中，才能填充参数的标签和编辑控件。如果使用其他方法（例如在单元格中键入 ApplyAcquisitionSettings）插入 ApplyAcquisitionSettings 函数，仅填充 AcquisitionSettings 数据结构。
- 如果取消选中 ApplyAcquisitionSettings 属性表，电子表格上的关联编辑控件不再覆盖 AcquireImage 函数中的值。

## ApplyAcquisitionSettings 输出

当将支持的参数从 AcquireImage 属性表拖放到电子表格时，将返回以下内容。

返回 | AcquisitionSettings 数据结构 参数标签 参数的编辑控件