使用 Qt 实现基于海康相机的图像采集和显示系统（不使用外部视觉库，如Halcon\OpenCv）[工程源码联系博主索要]

本文将梳理一个不借助外部视觉库（如 OpenCV/Halcon）的海康相机图像采集和显示 Demo。该程序直接使用 Qt GUI 来显示图像。通过海康 MVS SDK 实现相机的连接、参数设置、图像采集和异常处理等功能，并通过 Qt 界面展示操作结果。

在这里插入图片描述

1. 功能概述

该程序通过 Qt 的 GUI 作为界面，通过海康 MVS SDK 控制相机并显示实时图像。主要功能包括：

相机连接和设置
参数调整（如曝光时间和触发模式）
图像采集与显示
异常处理（如设备断开）

2. 初始化与 GUI 设置

在 MainWindow 的构造函数中进行界面初始化，包括设置按钮的可见性、启用状态等。 initStyle() 函数用于加载并应用界面的样式表。

MainWindow::MainWindow(QWidget *parent): QMainWindow(parent), ui(new Ui::MainWindow) {ui->setupUi(this);initStyle();// 设置初始 UI 状态ui->btn_Start->setEnabled(false);ui->btn_Stop->setEnabled(false);ui->btn_close->setEnabled(false);ui->btn_Grab->setVisible(false);ui->groupBox->setEnabled(false);
}

3. 相机连接与操作

3.1 枚举和连接相机

通过点击“搜索相机”按钮，程序调用 MV_CC_EnumDevices 枚举连接的相机设备，将可用的相机序列号显示在列表中供用户选择。

void MainWindow::on_btnSeachCamera_clicked() {ui->listWidget->clear();int nRet = MV_OK;bool isGige = ui->radioGIGE->isChecked();// 枚举连接的相机if (isGige) {nRet = MV_CC_EnumDevices(MV_GIGE_DEVICE, &cameraList);} else {nRet = MV_CC_EnumDevices(MV_USB_DEVICE, &cameraList);}if (nRet != MV_OK || cameraList.nDeviceNum == 0) {setLastErrorMsg(tc("未找到任何可用相机, 错误码: %1").arg(nRet));return;}// 添加相机序列号到列表中for (int i = 0; i < cameraList.nDeviceNum; i++) {const char *serial = isGige? reinterpret_cast<char *>(cameraList.pDeviceInfo[i]->SpecialInfo.stGigEInfo.chSerialNumber): reinterpret_cast<char *>(cameraList.pDeviceInfo[i]->SpecialInfo.stUsb3VInfo.chSerialNumber);ui->listWidget->addItem(serial);}
}

3.2 相机连接及初始化

点击“连接相机”按钮后，程序通过创建相机句柄并打开设备。设置默认曝光时间和注册图像采集、异常处理回调函数。

void MainWindow::on_btnconnect_clicked() {MV_CC_DEVICE_INFO cameraInfo;int nRet = MV_OK;// 创建句柄并打开相机memcpy(&cameraInfo, cameraList.pDeviceInfo[0], sizeof(MV_CC_DEVICE_INFO));if ((nRet = MV_CC_CreateHandle(&m_handle, &cameraInfo)) != MV_OK) {setLastErrorMsg(tc("相机初始化失败, 错误码: %1").arg(nRet));return;}if ((nRet = MV_CC_OpenDevice(m_handle, MV_ACCESS_Exclusive)) != MV_OK) {setLastErrorMsg(tc("相机打开失败, 错误码: %1").arg(nRet));return;}// 设置曝光时间并注册回调函数MV_CC_SetExposureTime(m_handle, ui->spinBox->value());MV_CC_RegisterImageCallBackEx(m_handle, ImageCallBack, this);MV_CC_RegisterExceptionCallBack(m_handle, ExceptionCallBack, this);// 更新 UI 状态ui->btn_Start->setEnabled(true);ui->btn_Stop->setEnabled(true);ui->btn_close->setEnabled(true);ui->btnconnect->setEnabled(false);ui->groupBox->setEnabled(true);
}

4. 图像采集与显示

4.1 图像采集回调

通过注册图像回调函数 ImageCallBack，将采集到的图像数据转换为 QImage 格式，以便在 Qt 的 QLabel 中显示。

void ImageCallBack(unsigned char *pData, MV_FRAME_OUT_INFO_EX *pFrameInfo, void *pUser) {MainWindow *camera = static_cast<MainWindow *>(pUser);QImage img;switch (pFrameInfo->enPixelType) {case PixelType_Gvsp_Mono8:// 单通道灰度图像转换img = QImage(pData, pFrameInfo->nWidth, pFrameInfo->nHeight, pFrameInfo->nWidth, QImage::Format_Grayscale8);break;case PixelType_Gvsp_RGB8_Packed:// RGB8 数据转换img = QImage(pData, pFrameInfo->nWidth, pFrameInfo->nHeight, QImage::Format_RGB888);break;case PixelType_Gvsp_BayerRG8:case PixelType_Gvsp_BayerBG8:// Bayer 格式转换img = QImage(pFrameInfo->nWidth, pFrameInfo->nHeight, QImage::Format_RGB888);for (int y = 0; y < pFrameInfo->nHeight - 1; y++) {for (int x = 0; x < pFrameInfo->nWidth - 1; x++) {int index = y * pFrameInfo->nWidth + x;uchar r, g, b;if (pFrameInfo->enPixelType == PixelType_Gvsp_BayerRG8) {r = pData[index];g = (pData[index + 1] + pData[index + pFrameInfo->nWidth]) / 2;b = pData[index + pFrameInfo->nWidth + 1];} else {b = pData[index];g = (pData[index + 1] + pData[index + pFrameInfo->nWidth]) / 2;r = pData[index + pFrameInfo->nWidth + 1];}img.setPixel(x, y, qRgb(r, g, b));}}break;default:qWarning("Unsupported pixel type");return;}// 显示图像camera->detect(img);
}void MainWindow::detect(const QImage &image) {ui->lab_image->setPixmap(QPixmap::fromImage(image).scaled(ui->lab_image->size()));
}

4.2 触发模式和曝光时间调整

根据用户选择的触发模式和曝光时间设置相机参数。Qt 的信号和槽机制使得切换触发模式和调整曝光时间变得直观。

void MainWindow::on_comboBox_activated(int index) {int nRet = MV_OK;switch (index) {case OpenContinue:nRet = MV_CC_SetEnumValue(m_handle, "TriggerMode", 0);break;case OpenSoftWare:nRet = MV_CC_SetEnumValue(m_handle, "TriggerMode", 1);nRet = MV_CC_SetEnumValue(m_handle, "TriggerSource", 7);break;case OpenHardWare:nRet = MV_CC_SetEnumValue(m_handle, "TriggerMode", 1);nRet = MV_CC_SetEnumValue(m_handle, "TriggerSource", 0);break;}if (nRet != MV_OK) setLastErrorMsg(tc("设置触发模式失败, 错误码: %1").arg(nRet));
}

5. 异常处理与资源释放

5.1 异常处理

程序注册了异常回调函数 ExceptionCallBack，用于处理如设备断开连接等异常情况，并将错误信息显示在界面上。

void ExceptionCallBack(unsigned int nMsgType, void *pUser) {if (nMsgType == MV_EXCEPTION_DEV_DISCONNECT) {MainWindow *camera = static_cast<MainWindow *>(pUser);camera->setLastErrorMsg(tc("相机连接断开"));}
}

5.2 资源释放

程序退出时，调用相机停止、关闭函数，释放资源以避免内存泄漏。

void MainWindow::on_btn_close_clicked() {on_btn_Stop_clicked();int nRet = MV_CC_CloseDevice(m_handle);if (nRet != MV_OK) {setLastErrorMsg(tc("关闭相机失败, 错误码: %1").arg(nRet));}
}