连接相机、调节参数、采集图像

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

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

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

本章介绍如何在Windows系统下通过connect_to_camera_and_capture_images例程连接Mech-Eye工业级3D相机、调节参数并采集图像。

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

运行例程

请执行以下步骤运行例程：

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

user_name为自定义的相机备注。可在Mech-Eye Viewer中设置。
定位至以下命令行，将MechEye替换为复制的unique_name或user_name。
```
DeviceInfo := 'MechEye'
```
单击工具栏中的按钮或单击键盘上的F5，运行例程。
图形窗口中将显示获取的点云。单击该窗口中的Continue继续执行程序。
运行结束后，单击工具栏中的重置程序执行。

如在HALCON中不重置程序执行，Mech-Eye Viewer将无法连接相机。
在例程文件夹内查看本次运行获取的2D图和点云文件。默认文件名为image2d.bmp和PointCloud.ply。

如相机采集数据的时间较长，可调大相机的MTU值，并开启电脑上的巨型帧功能。
网络较差导致数据丢失时，可以使用以下指令增大最大允许丢失包数。将ParameterValues替换为新的最大允许丢失包数。
```
set_framegrabber_param (AcqHandle, '[Stream]GevStreamMaxPacketGaps', ParameterValues)
```

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

执行以下步骤调节参数：

使用以下算子获取相机的参数组列表。

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软件后，再重新连接。