单轮数据采集：软触发 + 编码器

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

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

采集数据

该例程使用软触发 + 编码器的方式触发数据采集。

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

在HALCON中打开例程：运行HALCON，将例程拖拽至HALCON的程序窗口中。
调节编码器相关的参数：根据实际情况，参考调节参数部分的内容，调节以下编码器相关的参数：
- EncoderDivider
- EncoderOutputMode
- EncoderTriggerSignalCountingMode
  
  可参考GenICam客户端中可用的轮廓测量仪参数查看Mech-Eye Viewer参数参考指南中对参数的描述等信息。
单步运行程序（重复单击工具栏中的按钮），直至弹出变量监视：MechEyeProfilerInfos窗口。
该窗口中显示所有可连接的轮廓测量仪。选中需连接的轮廓测量仪并双击，复制unique_name:或user_name:后的名称。

user_name为自定义的轮廓测量仪备注。可在Mech-Eye Viewer中设置。
定位至以下命令行，将LNX替换为复制的unique_name或user_name。
```
DeviceInfo := 'LNX'
```
单击工具栏中的按钮或单击键盘上的F5，运行例程。
在以下变量中查看获取的强度图和深度图数据：
- 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软件后，再重新连接。