3. 图像采集与接口：相机接口（GigE、USB3、CameraLink）、图像采集助手、实时图像获取与保存

在Halcon视觉检测框架中，图像采集是数据流的起点，其稳定性与效率直接决定后续图像处理算法的上限。本章聚焦于三种主流相机接口的选型逻辑、Halcon图像采集助手的标准配置流程，以及实时图像获取与保存的工程化实现方法。理解接口的底层传输机制，比单纯记忆API调用更为重要——它决定了带宽计算、丢包排查和帧率优化的方向。

3.1 核心原理：三种接口的传输机制与适用边界

相机接口的本质是解决“图像数据从传感器到主机内存”的搬运问题。不同接口在带宽、延迟、线缆长度、CPU占用率及生态支持上存在显著差异，需根据检测节拍与场景约束进行选择。

GigE Vision 基于UDP/IP协议，采用GVCP（GigE Vision Control Protocol）进行相机控制，GVSP（GigE Vision Streaming Protocol）进行图像数据传输。其最大优势在于标准以太网基础设施的复用，支持多相机通过交换机汇聚，且线缆成本低廉。但UDP的不可靠性要求应用层实现丢包重传机制，Halcon通过设置网卡巨型帧（Jumbo Frame）和接收缓冲区大小来降低丢包概率。

USB3 Vision 采用USB3.0总线，使用UVC（USB Video Class）或厂商自定义协议。其优势在于即插即用、无需独立供电（相机可通过USB口取电），且CPU占用率较低。但线缆长度受限（无源线缆建议不超过3米），且多相机同步需要额外硬件触发或精确时间同步协议。

Camera Link 是一种并行差分信号接口，通过专用采集卡（Frame Grabber）将数据直接写入主机内存（DMA模式），延迟极低且传输确定性高。但需要额外购买采集卡，且线缆粗重、成本高。在Halcon中，Camera Link通常通过采集卡的SDK（如Matrox、Euresys）以插件形式接入。

3.2 方法流程：图像采集助手的标准配置路径

Halcon提供Image Acquisition Assistant（图像采集助手）作为可视化配置工具，其核心价值在于自动生成可复用的HDevelop代码，并验证相机参数与采集性能。标准流程分为四个阶段：

1. 接口选择与相机枚举：在助手界面选择对应接口（如GigE Vision），点击“连接”后自动枚举所有在线设备。若相机未识别，需检查IP地址（GigE需设置相机与主机在同一网段）、驱动安装（USB3需安装厂商驱动）或采集卡固件。
2. 参数配置与实时预览：设置曝光时间、增益、白平衡、触发模式（内触发/外触发）、像素格式（如Mono8、BayerRG8）。助手提供滑动条实时调节，并显示帧率与带宽占用。关键参数包括：AcquisitionMode（单帧/连续）、TriggerSource（软件/硬件Line0）、GevSCPSPacketSize（GigE包大小，通常设为1500或9000）。
3. 代码生成：点击“代码生成”按钮，助手自动输出完整的HDevelop代码，包含open_framegrabber、grab_image_start、grab_image_async等核心调用。此代码可直接复制到Halcon程序或导出为C#/C++工程。
4. 性能验证：在助手底部查看实际采集帧率与CPU占用率。若帧率低于预期，需检查是否启用了带宽限制（GigE的BandwidthLimit参数）、是否开启了多线程采集（grab_image_async的MaxDelay参数）。

以下为助手生成的典型GigE相机采集代码（HDevelop语法）：

// 打开GigE相机，使用默认参数
open_framegrabber ('GigEVision2', 0, 0, 0, 0, 0, 0, 'default', -1, 
                   'default', -1, 'false', 'Camera_1', 'default', -1, -1, AcqHandle)
// 设置采集参数
set_framegrabber_param (AcqHandle, 'ExposureTime', 2000.0)  // 曝光时间（微秒）
set_framegrabber_param (AcqHandle, 'Gain', 1.5)              // 增益（dB）
set_framegrabber_param (AcqHandle, 'TriggerMode', 'On')      // 启用触发
set_framegrabber_param (AcqHandle, 'TriggerSource', 'Line0') // 硬件触发源
// 开始连续采集
grab_image_start (AcqHandle, -1)
// 循环抓取图像
for i := 1 to 100 by 1
    grab_image_async (Image, AcqHandle, -1)
    // 此处可插入图像处理算法
endfor
close_framegrabber (AcqHandle)

3.3 案例/场景：多相机同步采集与实时保存

以一条典型的PCB板外观检测线为例，部署4台GigE相机（2台俯视、2台侧视），要求节拍为每秒检测5片板，每片板需采集4幅图像并保存至本地磁盘用于追溯。

硬件拓扑： 4台相机通过千兆交换机连接至主机（双网卡绑定，使用独立网卡隔离图像数据与控制系统通信）。相机均设置为硬件触发模式，由PLC输出触发信号至相机Line0接口，确保4台相机同时曝光。

Halcon实现要点：

• 使用open_framegrabber分别打开4个采集句柄，每个句柄对应一台相机。
• 采用多线程架构：主线程负责图像处理，4个采集线程分别执行grab_image_async，通过par_start并行执行。
• 图像保存采用write_image，格式选择TIFF（无损）或JPEG（有损，质量设为95）。为避免磁盘I/O阻塞采集线程，使用独立保存线程并配合队列缓冲。

以下为多相机并行采集的简化代码框架：

// 打开4台相机
open_framegrabber ('GigEVision2', ..., 'Camera_1', ..., AcqHandle1)
open_framegrabber ('GigEVision2', ..., 'Camera_2', ..., AcqHandle2)
open_framegrabber ('GigEVision2', ..., 'Camera_3', ..., AcqHandle3)
open_framegrabber ('GigEVision2', ..., 'Camera_4', ..., AcqHandle4)

// 并行采集线程
par_start (Thread1, '采集线程1')
par_start (Thread2, '采集线程2')
par_start (Thread3, '采集线程3')
par_start (Thread4, '采集线程4')

// 线程1内部逻辑（其余线程类似）
grab_image_start (AcqHandle1, -1)
while (true)
    grab_image_async (Image1, AcqHandle1, -1)
    // 将图像加入保存队列
    enqueue_image (Image1, 'Camera1_' + timestamp + '.tiff')
endwhile

实时保存策略： 使用write_image直接写入磁盘时，建议将图像数据先存入内存环形缓冲区（如gen_empty_obj配合concat_obj），由后台线程批量写入。实测表明，在NVMe固态硬盘上，TIFF格式的写入速度可达200 MB/s，而机械硬盘仅为80 MB/s，因此高速采集场景必须使用SSD。

3.4 误区/复盘：图像采集中的常见陷阱与排查路径

在实际项目交付中，图像采集环节的故障占整体调试时间的40%以上。以下为高频问题及根因分析：

误区3：Camera Link采集卡在Halcon中无法识别。
根因：未安装采集卡厂商的SDK或Halcon接口插件（如hAcqMatrox.dll）。
解决：在Halcon安装目录的bin\x64-win64下检查是否存在对应插件；通过info_framegrabber查询可用接口名称，确认是否为CameraLink或厂商自定义名称。

复盘清单（每次调试前必查）：

• 相机IP与主机IP是否在同一子网（GigE）？
• 是否关闭了网卡的节能模式（Green Ethernet）？
• 触发信号的电平与极性是否匹配（高电平触发/低电平触发）？
• 曝光时间是否超过帧周期的80%？若超过，需降低帧率或开启“重叠曝光”模式。
• 保存图像时是否使用了write_image的压缩参数？若需实时性，应使用write_image的原始格式（如TIFF LZW压缩）或直接保存为二进制流。

最后，建议在项目初期使用Halcon的grab_image_async配合get_framegrabber_param实时监控'grab_timeout'和'grab_status'参数，将采集异常（如超时、丢包）以日志形式记录，便于后期追溯。图像采集是视觉系统的“地基”，只有确保每一帧图像稳定、无损地进入内存，后续的算法精度与系统鲁棒性才有保障。