使用HALCON助手控制相机

您正在查看旧版本的文档。点击页面右上角可切换到最新版本的文档。

使用HALCON中的图像采集助手可快速连接相机、采集图像和调节参数。

在电脑上运行HALCON软件，选择助手 打开新的 Image Acquisition，即可打开图像采集助手。

连接相机

在Image Acquisition窗口的资源选项卡中，选择图像获取接口，并从下拉菜单中选择GigEVision2。

如下拉菜单中无GigEVision2选项，表明GigEVision2图像获取接口未安装。请参考HALCON的安装指南，通过MVTec软件管理器（SOM）安装接口。
在连接选项卡中，选择设备，单击连接可连接相机。

相机连接成功，连接按钮变为断开；如无变化，则为连接失败。如需断开与相机的连接，单击断开。
如相机已被其他客户端连接，则连接一定不成功。请先在其他客户端中断开连接，再使用HALCON连接。
设备中的相机名称可通过Mech-Eye Viewer自定义，便于查找需要连接的相机。在Mech-Eye Viewer中连接相机后，自定义相机备注即可。推荐设置为英语名称。

采集图像

相机连接后，在连接选项卡中单击采集即可进行单次图像采集。

如相机采图时间较长，可调大相机的MTU值，并开启电脑上的巨型帧功能。

你也可以进行多次或连续图像采集，为此需先调节AcquisitionMode参数的值。

进行多次图像采集：
- 切换至参数选项卡，将AcquisitionMode参数设置为MultiFrame。
- 单击右上角的刷新后，在AcquisitionFrameCount中设置需进行的图像采集次数。
- 切换至连接选项卡，单击实时进行图像采集。
- 设定次数的图像采集完成后，实时按钮变为停止。单击停止停止图像采集。
进行连续图像采集：
- 切换至参数选项卡，将AcquisitionMode参数设置为Continuous。
- 切换至连接选项卡，单击实时进行图像采集。
- 实时按钮变为停止。单击停止停止图像采集。

AcquisitionMode参数设置为MultiFrame或Continuous时，仍可单击采集进行单次图像采集。
AcquisitionMode参数设置为SingleFrame时，只可进行单次图像采集。

选择数据类型

相机连接后，默认采集的数据类型是2D图。你可通过调节DeviceScanType参数选择要获取的数据类型（2D图或深度图）。

单击参数选项卡，将DeviceScanType参数设置为需要的数据类型。数据类型说明如下：

值数据类型

Areascan

2D图

Areascan3D

深度图（包含深度信息的2D图）
进行图像采集，获取所选的数据类型。

勾选参数选项卡右上角的更新图像，调节参数后图形窗口中的图像将自动更新。

值	数据类型
Areascan	2D图
Areascan3D	深度图（包含深度信息的2D图）

设置采集区域

相机连接后，如需对获取的图像进行裁剪，可通过调节Height、Width、OffsetX和OffsetY四个参数设置采集区域。

请按照以下步骤设置采集区域：

选择需要设置采集区域的数据类型。
单击采集进行单次图像采集，确认当前图像。

切换至参数选项卡，调节Height、Width、OffsetX和OffsetY参数。下图展示这四个参数及其所定义的采集区域（橙色方框）与原始图像的关系。

Width：采集区域宽度
Height：采集区域高度
OffsetX：采集区域左上角的x坐标（原始图像左上角坐标为 (0, 0) ）

OffsetY：采集区域左上角的y坐标

以上四个参数的设置需满足以下要求：

（Width + OffsetX）不超过原始图像的宽度
（Height + OffsetY）不超过原始图像的高度

原始图像的宽度和高度可在只读参数的WidthMax和HeightMax中查看（需将可视度设为专家或以上）。

再次进行图像采集，确认裁剪结果。

勾选参数选项卡右上角的更新图像，调节参数后图形窗口中的图像将自动更新。

切换至代码生成选项卡，单击插入代码生成相应的代码。
如需为另一数据类型设置采集区域：
1. 在当前助手窗口中断开相机连接。
2. 打开一个新的助手窗口并连接相机。
3. 选择另一数据类型并重复上述步骤。

上述四个采集区域参数不会被保存至参数组中。如相机断电，其参数值将被重置。如需记录其参数值，请生成并保存代码。
更改DeviceScanType和Scan3DBinningEnable参数也将重置上述采集区域参数的值。

采集区域与Scan3DROI的区别

Mech-Eye工业级3D相机还提供了另外一组用于设置感兴趣区域的参数：Scan3DROILeft、Scan3DROITop、Scan3DROIHeight和Scan3DROIWidth（统称为“Scan3DROI”）。

采集区域参数和Scan3DROI的区别如下表。请根据需求选择要使用的参数。

采集区域	Scan3DROI
不可保存至参数组，相机断电将重置参数值	可保存至参数组
2D图和深度图均可设置	2D图不可设置
对图像进行裁剪	不对图像进行裁剪
只可在HALCON中设置	可用Mech-Eye Viewer中的可视化工具设置

采集区域

Scan3DROI

不可保存至参数组，相机断电将重置参数值

可保存至参数组

2D图和深度图均可设置

2D图不可设置

对图像进行裁剪

不对图像进行裁剪

只可在HALCON中设置

可用Mech-Eye Viewer中的可视化工具设置

调节参数

如获取的数据不满足需求，可在参数选项卡下调节相机参数。

相机支持参数组功能，通过切换参数组可以快速切换相机的参数配置。需先选择用于保存参数值的参数组，再调节参数。
如果需要增加或删除参数组，请通过Mech-Eye Viewer配置。使用Mech-Eye Viewer配置完参数组后，在HALCON助手的参数选项卡下，单击右上角的刷新按钮读取相机最新配置。

执行以下步骤调节参数：

相机连接后，单击参数选项卡，将UserSetSelector参数设置为要修改的参数组。

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

找到UserSetLoad参数，单击右侧的应用读取配置。

如单击应用后，各参数的值未更新，请再次单击。
找到需要修改的参数，并修改参数值。
找到UserSetSave参数，单击右侧的应用保存配置。
切换至代码生成选项卡，单击插入代码生成相应的代码。

参考信息

GenICam客户端中可用的相机参数与Mech-Eye Viewer中可见的参数基本上一一对应。详细的对应关系请参考GenICam客户端中可用的相机参数。
调节自动曝光感兴趣区域、深度范围及感兴趣区域等相机参数时，通常需要借助可视化工具不断调节从而获取理想的值。由于GenICam客户端并未提供辅助参数设置的可视化工具，你可以借助Mech-Eye Viewer的可视化设置工具调节这些参数。详细信息请查看使用Mech-Eye Viewer调节相机参数。

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