使用HALCON助手控制相机

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

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

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

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

连接相机

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

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

    connect the camera
  • 相机连接成功,连接按钮变为断开;如无变化,则为连接失败。如需断开与相机的连接,单击断开

  • 如相机已被其他客户端连接,则连接一定不成功。请先在其他客户端中断开连接,再使用HALCON连接。

  • 设备中的相机名称可通过Mech-Eye Viewer自定义,便于查找需要连接的相机。在Mech-Eye Viewer中连接相机后,自定义相机备注即可。推荐设置为英语名称。

采集图像

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

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

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

  • 进行多次图像采集:

    • 切换至参数选项卡,将AcquisitionMode参数设置为MultiFrame

    • 单击右上角的刷新后,在AcquisitionFrameCount中设置需进行的图像采集次数。

    • 切换至连接选项卡,单击实时进行图像采集。

    • 设定次数的图像采集完成后,实时按钮变为停止。单击停止停止图像采集。

  • 进行连续图像采集:

    • 切换至参数选项卡,将AcquisitionMode参数设置为Continuous

    • 切换至连接选项卡,单击实时进行图像采集。

    • 实时按钮变为停止。单击停止停止图像采集。

  • AcquisitionMode参数设置为MultiFrameContinuous时,仍可单击采集进行单次图像采集。

  • AcquisitionMode参数设置为SingleFrame时,只可进行单次图像采集。

选择数据类型

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

  1. 单击参数选项卡,将DeviceScanType参数设置为需要的数据类型。数据类型说明如下:

    数据类型

    Areascan

    2D图

    Areascan3D

    深度图(包含深度信息的2D图)

  2. 进行图像采集,获取所选的数据类型。

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

设置采集区域

相机连接后,如需对获取的图像进行裁剪,可通过调节HeightWidthOffsetXOffsetY四个参数设置采集区域。

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

  1. 选择需要设置采集区域的数据类型。

  2. 单击采集进行单次图像采集,确认当前图像。

  3. 切换至参数选项卡,调节HeightWidthOffsetXOffsetY参数。下图展示这四个参数及其所定义的采集区域(橙色方框)与原始图像的关系。

    set capture region 1
    • Width:采集区域宽度

    • Height:采集区域高度

    • OffsetX:采集区域左上角的x坐标(原始图像左上角坐标为 (0, 0) )

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

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

      • Width + OffsetX)不超过原始图像的宽度

      • Height + OffsetY)不超过原始图像的高度

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

  4. 再次进行图像采集,确认裁剪结果。

勾选参数选项卡右上角的更新图像,调节参数后图形窗口中的图像将自动更新。
  1. 切换至代码生成选项卡,单击插入代码生成相应的代码。

  2. 如需为另一数据类型设置采集区域:

    1. 在当前助手窗口中断开相机连接。

    2. 打开一个新的助手窗口并连接相机。

    3. 选择另一数据类型并重复上述步骤。

  • 上述四个采集区域参数不会被保存至参数组中。如相机断电,其参数值将被重置。如需记录其参数值,请生成并保存代码。

  • 更改DeviceScanTypeScan3DBinningEnable参数也将重置上述采集区域参数的值。

采集区域与Scan3DROI的区别

Mech-Eye工业级3D相机还提供了另外一组用于设置感兴趣区域的参数:Scan3DROILeftScan3DROITopScan3DROIHeightScan3DROIWidth(统称为“Scan3DROI”)。

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

采集区域 Scan3DROI

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

可保存至参数组

2D图和深度图均可设置

2D图不可设置

对图像进行裁剪

不对图像进行裁剪

只可在HALCON中设置

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

调节参数

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

  • 相机支持参数组功能,通过切换参数组可以快速切换相机的参数配置。需先选择用于保存参数值的参数组,再调节参数。

  • 如果需要增加或删除参数组,请通过Mech-Eye Viewer配置。使用Mech-Eye Viewer配置完参数组后,在HALCON助手的参数选项卡下,单击右上角的刷新按钮读取相机最新配置。

执行以下步骤调节参数:

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

    HALCON中显示的参数组名对应Mech-Eye Viewer中参数组的排列顺序。例如,HALCON中的UserSet0为Mech-Eye Viewer中的第一个参数组。详情请参考在HALCON中选择参数组
  1. 找到UserSetLoad参数,单击右侧的应用读取配置。

    如单击应用后,各参数的值未更新,请再次单击。

  2. 找到需要修改的参数,并修改参数值。

  3. 找到UserSetSave参数,单击右侧的应用保存配置。

  4. 切换至代码生成选项卡,单击插入代码生成相应的代码。

参考信息

  • GenICam客户端中可用的相机参数与Mech-Eye Viewer中可见的参数基本上一一对应。详细的对应关系请参考GenICam客户端中可用的相机参数

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

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

我们重视您的隐私

我们使用 cookie 为您在我们的网站上提供最佳体验。继续使用该网站即表示您同意使用 cookie。如果您拒绝,将使用一个单独的 cookie 来确保您在访问本网站时不会被跟踪或记住。