工业相机帧率获取（C++版本），附海康basler堡盟工业相机代码

工业相机帧率获取C 版本附海康 / Basler / 堡盟三大品牌完整代码精准掌握实时 FPS“我的相机标称 120fps为什么程序里只跑出 40fps”“如何在 C 应用中实时显示当前帧率”“不同品牌 SDK 获取帧率的方式天差地别”在高性能工业视觉系统中帧率FPS是衡量系统吞吐能力的黄金指标。它直接决定了产线的检测节拍和效率。本文将深入 C 层面为你提供海康Hikvision、Basler、堡盟Baumer三大主流工业相机的实时帧率获取方案并附上可直接编译运行的代码。 一、帧率的两种类型C 视角类型说明获取方式理论帧率 (Max FPS)相机在当前配置下能达到的上限通过 SDK 查询AcquisitionFrameRate等参数实际帧率 (Real FPS)应用真正处理图像的速率需通过高精度计时 帧计数计算本文核心获取「实际帧率」因为它反映了你 C 程序的真实性能。⏱️ 二、通用帧率计算器C17我们首先实现一个跨平台、高精度的帧率计算器// FrameRateCounter.h#pragmaonce#includechrono#includeatomicclassFrameRateCounter{public:voidOnNewFrame(){frameCount_;}doubleGetFPS(){autonowstd::chrono::steady_clock::now();autoelapsedstd::chrono::duration_caststd::chrono::microseconds(now-lastTime_).count();if(elapsed1000000){// 1 secondfps_static_castdouble(frameCount_.exchange(0))*1000000.0/elapsed;lastTime_now;}returnfps_;}private:std::atomicuint64_tframeCount_{0};std::chrono::steady_clock::time_point lastTime_std::chrono::steady_clock::now();doublefps_0.0;}; 三、各品牌 SDK 实战代码C1. 海康HikvisionMVS C SDK// HikvisionFPS.cpp#includeMVCameraControl.h#includeFrameRateCounter.h#includeiostream#includethreadclassHikvisionCamera{public:boolOpenCamera(){MV_CC_DEVICE_INFO_LIST stDevList;MV_CC_EnumDevices(MV_GIGE_DEVICE,stDevList);if(stDevList.nDeviceNum0){MV_CC_CreateHandle(handle_,stDevList.pDeviceInfo[0]);returnMV_CC_OpenDevice(handle_)MV_OK;}returnfalse;}voidStartGrabbing(){MV_CC_SetEnumValue(handle_,TriggerMode,MV_TRIGGER_MODE_OFF);MV_CC_StartGrabbing(handle_);// 启动取图线程grabThread_std::thread([this](){MV_FRAME_OUT_INFO_EX stImageInfo{0};unsignedchar*pDatanewunsignedchar[1920*1200*3];while(running_){intnRetMV_CC_GetOneFrameTimeout(handle_,pData,1920*1200*3,stImageInfo,1000);if(nRetMV_OK){fpsCounter_.OnNewFrame();// 关键通知帧率计数器// 处理图像...}}delete[]pData;});}doubleGetFPS(){returnfpsCounter_.GetFPS();}~HikvisionCamera(){running_false;if(grabThread_.joinable())grabThread_.join();if(handle_){MV_CC_StopGrabbing(handle_);MV_CC_CloseDevice(handle_);MV_CC_DestroyHandle(handle_);}}private:void*handle_nullptr;std::thread grabThread_;std::atomicboolrunning_{true};FrameRateCounter fpsCounter_;};2. Basler pylon C SDK// BaslerFPS.cpp#includepylon/PylonIncludes.h#includeFrameRateCounter.hclassBaslerCamera{public:voidOpenAndStart(){camera_Pylon::CTlFactory::GetInstance().CreateFirstDevice();camera_-Open();// 注册图像回调camera_-RegisterConfiguration(newPylon::CSoftwareTriggerConfiguration,Pylon::RegistrationMode_ReplaceAll,Pylon::Cleanup_Delete);camera_-StartGrabbing(Pylon::GrabStrategy_LatestImageOnly);// 启动取图循环grabThread_std::thread([this](){Pylon::CGrabResultPtr ptrGrabResult;while(running_){if(camera_-RetrieveResult(1000,ptrGrabResult,Pylon::TimeoutHandling_ThrowException)){if(ptrGrabResult-GrabSucceeded()){fpsCounter_.OnNewFrame();// 关键通知帧率计数器// 处理图像...}ptrGrabResult.Release();}}});}doubleGetFPS(){returnfpsCounter_.GetFPS();}~BaslerCamera(){running_false;if(grabThread_.joinable())grabThread_.join();if(camera_-IsGrabbing())camera_-StopGrabbing();if(camera_-IsOpen())camera_-Close();}private:Pylon::CInstantCamera*camera_nullptr;std::thread grabThread_;std::atomicboolrunning_{true};FrameRateCounter fpsCounter_;};3. 堡盟BaumerBGAPI C SDK// BaumerFPS.cpp#includebgapi2_genicam/bgapi2_genicam.hpp#includeFrameRateCounter.hclassBaumerCamera{public:voidOpenAndStart(){BGAPI2::SystemList systemList;systemList.Refresh();autosystemsystemList.GetSystem(TFG);BGAPI2::InterfaceList interfaceList;system-GetInterfaces(interfaceList);interfaceList.Refresh();autointfinterfaceList.GetInterface(0);BGAPI2::DeviceList deviceList;intf-GetDevices(deviceList);deviceList.Refresh();device_deviceList.GetDevice(0);device_-Open();dataStream_device_-GetDataStream(0);dataStream_-Open();dataStream_-StartAcquisition();// 取图线程grabThread_std::thread([this](){while(running_){autobufferdataStream_-GetBuffer(100);// 100ms timeoutif(buffer!nullptr){fpsCounter_.OnNewFrame();// 关键通知帧率计数器// 处理图像...dataStream_-QueueBuffer(buffer);}}});}doubleGetFPS(){returnfpsCounter_.GetFPS();}~BaumerCamera(){running_false;if(grabThread_.joinable())grabThread_.join();if(dataStream_-IsOpen()){dataStream_-StopAcquisition();dataStream_-Close();}if(device_-IsOpen())device_-Close();}private:BGAPI2::Device*device_nullptr;BGAPI2::DataStream*dataStream_nullptr;std::thread grabThread_;std::atomicboolrunning_{true};FrameRateCounter fpsCounter_;}; 四、获取理论最大帧率C有时也需要查询相机的理论极限帧率海康:MV_CC_GetFloatValue(handle_, AcquisitionFrameRate, fValue)Basler:camera_-GetNodeMap()-GetNode(AcquisitionFrameRate)-GetValue()堡盟:device_-GetRemoteNode(AcquisitionFrameRate)-GetDouble()⚠️ 注意理论帧率受曝光时间、带宽限制、ROI 等因素影响通常需要先设置好其他参数再查询。 结语在 C 工业视觉应用中精准的帧率监控是性能调优的基石。通过本文提供的跨品牌代码模板你可以快速集成到自己的项目中实时掌握系统的真实吞吐能力。让每一微秒都高效让每一帧都不被浪费。