单轮数据采集：外部触发 + 固定频率

您正在查看V2.3.0版本的文档。如果您想查阅其他版本的文档，可以点击页面右上角“切换版本”按钮进行切换。

■ 如果您想使用最新版本，可以从梅卡曼德下载中心下载。

■ 如果您不确定当前使用的产品是哪个版本，请随时联系梅卡曼德技术支持。

本章介绍如何在Windows系统下通过perform_single_round_of_data_acquisition_externally_triggered例程触发一轮数据采集并获取轮廓线数据。

请参考HALCON例程使用指南获取例程并确认使用前提。

采集数据

该例程使用外部触发 + 固定频率的方式触发数据采集。

请执行以下步骤采集数据：

在HALCON中打开例程：运行HALCON，将例程拖拽至HALCON的程序窗口中。
单步运行程序（重复单击工具栏中的按钮），直至弹出变量监视：MechEyeProfilerInfos窗口。
该窗口中显示所有可连接的轮廓测量仪。选中需连接的轮廓测量仪并双击，复制unique_name:或user_name:后的名称。

user_name为自定义的轮廓测量仪备注。可在Mech-Eye Viewer中设置。
定位至以下命令行，将LNX替换为复制的unique_name或user_name。
```
DeviceInfo := 'LNX'
```
单击工具栏中的按钮或单击键盘上的F5，运行例程。
从外部设备输入触发信号：需保证触发信号在程序执行完grab_data()指令后输入至轮廓测量仪，且需在grab_timeout超时时间内输入至轮廓测量仪。
在以下变量中查看获取的深度图和强度图数据：
- reflectance：强度图
- depthInMM：深度图

如获取的数据不满足需求，可调节相应参数。

执行以下步骤调节参数：

使用以下算子获取轮廓测量仪的参数组列表。

get_framegrabber_param (AcqHandle, 'UserSetSelector_values', ParameterGroupNames)

使用以下算子选择要修改的参数组。UserSetSelector和UserSetLoad为轮廓测量仪参数，分别用于选择和加载参数组。将ParameterGroupName替换为实际参数组名称。

HALCON中显示的参数组名对应Mech-Eye Viewer中参数组的排列顺序。例如，HALCON中的UserSet0为Mech-Eye Viewer中的第一个参数组。详情请参考在HALCON中选择参数组。

set_framegrabber_param (AcqHandle, 'UserSetSelector','ParameterGroupName')
set_framegrabber_param (AcqHandle, 'UserSetLoad','ParameterGroupName')

使用以下算子获取指定参数的值。将ParameterName替换为实际轮廓测量仪参数名称。ParameterValues是保存获取参数值的变量，可以根据需要更改。注意变量不需要置于引号内。
```
get_framegrabber_param (AcqHandle, 'ParameterName', ParameterValues)
```
在控制变量区域的ParameterValues中，查看该参数的值。
使用以下算子修改参数设置。将ParameterName替换为实际轮廓测量仪参数名称，NewParameterValue替换为新的参数值。
```
set_framegrabber_param (AcqHandle, 'ParameterName', 'NewParameterValue')
```
使用以下算子将参数设置修改保存到参数组中。UserSetSave为轮廓测量仪参数，用于保存参数设置到参数组。将ParameterGroupName替换为实际参数组名称。
```
set_framegrabber_param (AcqHandle, 'UserSetSave', 'ParameterGroupName')
```

GenICam客户端中可用的轮廓测量仪参数与Mech-Eye Viewer中可见的参数基本上一一对应。详细的对应关系请参考GenICam客户端中可用的轮廓测量仪参数。
调节校正、掩膜等参数时，通常需要借助可视化工具不断调节从而获取理想的值。由于GenICam客户端并未提供辅助参数设置的可视化工具，你可以借助Mech-Eye Viewer的可视化设置工具调节这些参数。详细信息请查看使用Mech-Eye Viewer调节轮廓测量仪参数。

使用Mech-Eye Viewer连接轮廓测量仪前，需断开轮廓测量仪与HALCON的连接。如连接不成功，请关闭HALCON软件后，再重新连接。