简介一套面向工业视觉与设备开发者的C#通用GIGE网口工业相机采图模块源码解决多品牌Gige协议相机统一接入、图像采集与预处理问题。模块内置相机参数设置、采图设置、IP设置三大界面支持图像上下、左右翻转及左右旋转并基于海康通用驱动实现自动识别品牌兼容海康、海康机器人、巴斯勒、大恒、大华等未安装厂商驱动也可调用内置驱动运行便于现场部署。资源共117个文件压缩包28.2MB其中62个dll为运行与驱动组件15个cs为源码核心另有exe可执行程序、resx资源文件及工程配置便于直接修改二次开发。已有197人学习适合C#中级开发者或机器视觉集成工程师参考。源码为原创可按实际相机型号扩展协议适合快速搭建工业取相原型或集成到现有上位机系统也能作为学习相机SDK封装与界面编程的范例。 搞上位机开发的年头一长会发现很多模块都在反复造轮子。工业相机采图就是一个典型去年项目用海康今年客户指定Basler明年又换成大恒每次都得把相机枚举、连接、取流、参数设置重新写一遍业务逻辑还被不同SDK的调用方式搅得一团糟。后来我干脆用C#封装了一套通用的GigE网口工业相机采图模块把SDK差异隔离在适配层对外统一提供采图能力并且支持图像上下翻转、左右翻转、左右旋转模块里自带相机参数设置界面和采图设置界面。这套模块在三个实际项目里换过相机品牌业务层代码一行没改。今天把完整的设计思路、核心源码和排查经验整理出来给正在做上位机视觉集成的朋友一个参考。1. 项目背景与整体设计思路先交代一下背景。我做的大多是产线视觉检测和定位引导项目相机固定在设备上倒装、侧装的现场非常多。相机装歪了怎么办软件里把图像转回来就行光这一点就说明图像翻转和旋转不是锦上添花而是现场调试的刚需。动手做通用模块之前我先把两个基础问题想清楚了为什么要选GigE接口以及怎么把通用这个概念真正落地而不是挂在嘴上。1.1 为什么选择GigE网口而不是USB3.0工业相机接口主流就三种USB3.0、GigE Vision、Camera Link。我优先选GigE原因很现实传输距离GigE用网线可以跑到100米USB3.0超过5米就要加延长方案。产线机台和工控机动不动隔十米八米USB3.0完全不现实。组网方便千兆网卡可以挂多台相机一块网卡带四到六台500万像素黑白相机做多工位检测很常见组网成本低。协议标准GigE Vision是公开标准大多数相机厂商都支持做通用模块的基础比其他私有接口好太多。成本低不用专用采集卡一张千兆网卡就能跑Camera Link采集卡动辄几千块对中小项目不友好。缺点也有千兆网口有效带宽大概在100MB/s上下500万像素黑白相机全速跑大概20到30fps。如果项目要4K60fpsGigE就带不动了。所以我给这个模块的定位是满足80%常规工业视觉集成的采图需求兼顾通用性和成本。1.2 通用模块的分层结构通用不是一套代码跑遍所有品牌而是对外接口稳定、可配置厂商SDK只出现在实现层。我按分层思路把项目整理成这样CameraModule/ ├── Contracts/ │ └── ICameraModule.cs // 统一相机接口 ├── Implementations/ │ ├── MvCameraModule.cs // 海康SDK实现 │ └── PylonCameraModule.cs // Basler SDK适配 ├── UI/ │ ├── CameraParamForm.cs // 相机参数设置界面 │ └── GrabParamForm.cs // 采图设置界面 └── Utils/ └── ImageProcessHelper.cs // 翻转/旋转、格式转换ICameraModule定义一组不与厂商绑定的方法Open、Close、StartGrab、StopGrab、SetParam、GetParam再定义一个OnImageGrabbed事件。上层界面和业务逻辑只依赖接口。换相机品牌时工厂类里改一行实例化代码就行其他全部保留。将来客户如果换大恒、华睿、凌云光这些同样支持GigE Vision的相机再写一个实现类就能接入。2. 核心技术点拆解SDK选型与图像翻转旋转原理准备动手前我把主流SDK的接口风格摸了一遍。这里把选型结论和关键原理写清楚能帮你省不少调研时间。2.1 主流工业相机的SDK怎么选SDK厂商开发难度.NET友好度适用相机MVS SDK海康机器人中等一般纯C接口海康全系pylon SDKBasler简单高类封装完善Basler全系Galaxy SDK大恒图像中等一般大恒全系DirectShow/GenICam通用-低只适合简单视频我明确的建议是做工业采图不要用DirectShow高帧率、硬触发、精确曝光、丢包重传它全都给不了。也不要试图直接操作GenICam底层标准不同厂家XML定义差异很大。最稳的做法是给每个厂商写一个适配实现就像上面代码结构里的MvCameraModule和PylonCameraModule。业务层看到的是同一个接口厂商差异被挡在适配层后面。2.2 翻转和旋转的本质与常见坑先理清概念。翻转是镜面反射上下翻转就是沿水平轴镜像左右翻转就是沿垂直轴镜像效果像照镜子但图内容方向没变。旋转是绕图像中心旋转解决的是相机安装方向带来的角度偏差。C#里最方便的API是Bitmap.RotateFlip传一个RotateFlipType枚举值可以同时处理旋转和翻转。常见值有RotateNoneFlipX左右翻转、RotateNoneFlipY上下翻转、Rotate90FlipNone顺时针90度等。这里有三个坑我在项目里都踩过第一RotateFlip是原地修改调用一次后原图就没法复用了。需要保留原图时必须先Clone一份。第二RotateFlip的翻转和旋转组合顺序会影响最终结果。先水平翻转再旋转90度和先旋转90度再水平翻转效果完全不同。第三旋转90度或270度之后图像的宽和高会互换后续计算ROI时容易算错。我在模块里固定了一套处理顺序先水平翻转再垂直翻转最后旋转。这样暴露给外界的配置项就两个布尔值加一个角度视觉工程师现场设置起来很清楚不需要去理解底层像素变换。3. 参数设置界面与采图设置界面实现模块里两个界面是客户吐槽体验的重灾区设计得要顺手。我这里说说我的方案。3.1 相机参数设置界面的交互设计常规参数至少要覆盖曝光时间、增益、触发模式、帧率上限、图像宽高、像素格式彩色相机还要有白平衡。但如果只是把参数一行一行列出来客户用起来会很难受因为某些参数改了不是立即生效比如重新改图像宽高通常要停流重启采图过程中改触发模式也可能导致状态不一致。我的处理方式是分组和状态分离。曝光和增益放一组点击应用后才调SDK写入如果正在采图且相机支持实时调节就立即生效不支持就给提示。图像格式区域从相机支持的像素格式里做下拉列表默认用Mono8或RGB24减少格式转换的坑。触发模式给三个选项连续、软触发、硬触发。选硬触发时再出现触发源和触发沿配置这是现场用得最多的设置。界面显示不从SDK实时读取所有值而是读一个模块内部维护的CameraState对象。用户点刷新才从相机读最新值点应用才写相机。这样避免界面轮询SDK导致卡顿也让参数值不会莫名其妙被外部改掉。3.2 采图设置界面与扫码触发场景采图设置界面管理的是图像从相机出来之后怎么办。我会放这几个模块保存路径和命名规则支持时间戳加帧号的命名也支持覆盖式命名方便测试图片格式选择BMP、PNG、JPEG触发方式显示和相机参数界面联动这里只读避免两套参数写入打架帧率上限做节流还有采集超时时间软触发模式下相机没在规定时间内出图时要能报超时事件。这里特别想聊一下扫码枪触发场景。很多项目用扫码枪读取条码后上位机要立刻触发相机拍照用于追溯或外观检测。我在模块里把扫码枪事件设计成一个可注册的回调事件触发后就调用相机软触发同时把条码和图像文件名关联起来。如果现场走的是硬触发扫码枪或光电信号直接接相机IO口那么上位机只需要监听帧计数变化并做条码绑定。两种方式都留接口应对不同现场。3.3 UI刷新与采集线程解耦C#上位机采集卡顿九成是直接在SDK回调里操作了UI。回调运行在SDK内部线程你在里面更新Image控件或者保存大图界面不卡才怪。最直观的例子一张500万像素灰度图转Bitmap再塞给PictureBox一次操作可能要几十毫秒而相机帧间隔可能只有三十毫秒回调一积压界面和内存一起出问题。我用的方案是生产者消费者模式。采集回调只做一件事把图像字节数组拷贝一份塞进ConcurrentQueue队列。UI侧开一个定时器每秒15次从队列取最新帧显示。取出来后如果还有就丢掉旧帧保证界面永远显示实时画面。保存图片的操作放到单独线程处理不让回调阻塞。内存方面要注意队列里只保留最新一帧一旦积压超过5帧就丢旧帧。如果不做这个限制高帧率跑一小时内存会一路涨到爆。4. 核心代码实现与关键步骤代码是模块的核心。下面我把海康SDK适配层的几个关键代码块拆开讲Basler的pylon SDK思路一样只是API风格不同。4.1 相机枚举与连接枚举设备这一步海康SDK调用MV_CC_EnumDevicesMV_CC_DEVICE_INFO_LIST deviceList new MV_CC_DEVICE_INFO_LIST(); int ret MV_CC_EnumDevices(MV_CC_DEVICE_GIGE, ref deviceList); if (ret ! MV_OK) { // 枚举失败常见原因是网络不通或防火墙拦截 return; }拿到设备信息后创建句柄并打开设备MV_CC_DEVICE_INFO deviceInfo deviceList.pDeviceInfo[0]; MyCamera myCamera new MyCamera(); ret myCamera.MV_CC_CreateHandle(ref deviceInfo); if (ret ! MV_OK) return; ret myCamera.MV_CC_OpenDevice(MV_ACCESS_EXCLUSIVE); if (ret ! MV_OK) { myCamera.MV_CC_DestroyHandle(); return; }打开成功后我一般会顺手设置一下传输层的重传参数比如开启包重传和适当的接收缓存。不同相机默认配置不同但这一步能降低大图传输时的丢包概率尤其是跨交换机或多相机共享带宽时。网络这块的细节后面在常见问题部分再展开。4.2 图像采集回调处理采图回调是最容易被人忽略细节的地方。海康SDK回调里的pData指针只在这个回调执行期间有效下一帧来了就会被覆盖。所以回调里必须立刻将像素数据拷贝成托管数组private void CaptureCallback(IntPtr pData, ref MV_FRAME_OUT_INFO pFrameInfo, IntPtr user) { if (pData IntPtr.Zero) return; int frameLen (int)pFrameInfo.nFrameLen; byte[] frameData new byte[frameLen]; Marshal.Copy(pData, frameData, 0, frameLen); FrameData frame new FrameData { Data frameData, Width pFrameInfo.nWidth, Height pFrameInfo.nHeight, PixelFormat (PixelFormatType)pFrameInfo.enPixelType, Timestamp DateTime.Now }; _frameQueue.Enqueue(frame); }回调里不要做任何耗时操作包括转Bitmap、写文件、更新UI这些全部丢给消费者线程去处理。另外整个回调体一定要包一层异常捕获不能让异常逃出SDK回调否则采图线程会异常崩溃。UI侧取帧并转Bitmap的代码private void PreviewTimerTick(object sender, EventArgs e) { if (!_frameQueue.TryDequeue(out FrameData frame)) return; Bitmap bitmap ConvertToBitmap(frame); bitmap ImageProcessHelper.Transform(bitmap, Config.FlipX, Config.FlipY, Config.RotateAngle); if (_previewBox.Image ! null) _previewBox.Image.Dispose(); _previewBox.Image bitmap; }ConvertToBitmap根据像素格式构建BitmapMono8灰度图直接用8位位图RGB24则用PixelFormat.Format24bppRgb。4.3 图像翻转旋转实现与性能优化图像处理辅助类的核心方法如下执行顺序固定先水平翻转再垂直翻转最后按角度旋转public static Bitmap Transform(Bitmap source, bool flipX, bool flipY, int rotateAngle) { if (source null) return null; Bitmap result (Bitmap)source.Clone(); try { if (flipX) { result.RotateFlip(RotateFlipType.RotateNoneFlipX); } if (flipY) { result.RotateFlip(RotateFlipType.RotateNoneFlipY); } switch (rotateAngle % 360) { case 90: result.RotateFlip(RotateFlipType.Rotate90FlipNone); break; case 180: result.RotateFlip(RotateFlipType.Rotate180FlipNone); break; case 270: result.RotateFlip(RotateFlipType.Rotate270FlipNone); break; } return result; } catch { result.Dispose(); throw; } }这个方法的注意点我在前面提过Clone之后原图要记得Dispose旋转90度和270度之后宽高互换翻转旋转顺序不能改。如果相机SDK本身支持ReverseX、ReverseY这类硬件镜像参数我建议在采图开始前设置到相机里软件层就能省掉一次像素级处理对高帧率项目帮助明显。我的模块里加了优先使用相机硬件翻转的开关界面勾选后软件Transform里的flipX和flipY都会置为false。5. 常见问题与排查技巧实录最后这部分是项目现场积累出来的经验每一条都对应过真实的加班夜晚。5.1 枚举不到相机的排查顺序这个问题占工业相机使用问题的一半以上。新的相机装上去SDK工具里也搜不到设备按这个顺序排查先查网卡IP。GigE相机一般要求电脑和相机在同一网段比如相机默认192.168.1.100就把电脑本地连接改成192.168.1.50子网掩码255.255.255.0。再关掉Windows防火墙或放行SDK使用的UDP端口。第三步在网卡高级设置里把Jumbo Packet巨型帧调整为9KB或9014字节能减少大图传输分包数量。如果还是不行用厂商自带客户端工具先验证设备厂家工具也连不上问题就在链路不在代码。多网卡电脑还要注意相机接的不是默认网卡时枚举可能搜不到需要安装GigE Vision过滤器驱动并绑定到对应网卡。5.2 卡顿丢帧和内存问题相机能连上但一跑起来界面卡、图片跳帧大概率是代码层面而不是相机本身的问题。最典型的就是在采集回调里做了重活把转Bitmap和保存图片全放在回调里CPU直接打满帧率自然掉。改成生产者消费者模式后这个问题基本消失。其次是网络丢包。打开SDK自带的丢包统计看一下丢包率不是0就查网线和巨帧设置生产环境一定要用超五类及以上规格的工业网线接头要压紧。最后是UI显示区域过大重绘开销高这种情况可以降低预览帧率到10到15fps肉眼看不出差别CPU占用能降一大截。内存问题则要重点排查Bitmap有没有及时Dispose。我在预览里换帧时先Dispose旧图队列里丢弃旧帧时不直接丢对象而是让它自然被GC回收。如果代码里有事件订阅相机关闭时一定要退订事件否则对象被事件引用着回收不掉内存会缓慢增长。5.3 多品牌相机参数名称不一致通用模块绕不开参数名称不一致的问题。海康的曝光时间节点叫ExposureTimeBasler叫ExposureTime部分大恒型号可能叫Exposure或Shutter。如果界面直接绑定SDK节点名换个相机品牌就要重新改界面非常难受。我的方案是在Contracts层定义一套自己的标准参数名比如ExposureTimeUs、GainDb、TriggerMode、PixelFormat每个适配实现内部做名称映射。界面只写标准名到具体SDK时才翻译成厂商节点。这样换相机品牌时参数设置界面完全不用变现场人员不用重新学习。5.4 扫码枪触发采图的时序问题扫码枪通过串口或网络把条码发给上位机上位机再触发相机拍照最容易出现的问题是条码已经收到但相机还在上一帧状态软触发信号没有及时响应导致图片和条码对不上。我在模块的事件处理里强制做三件事先把扫码信息和当前帧计数绑定再根据当前触发模式选择软触发或直接读取硬触发最新帧最后以条码加图片路径加时间戳的结构对外发布视觉线程按条码关联图片做判断即可。另外在采图回调里判断帧序号是否连续递增发现断号就输出告警日志这个小功能在现场救过我很多次。这个模块我维护了两年多最大的体会是上位机采集模块不追求代码炫技稳定、可维护、现场好排查才是第一位。图像翻转这种功能表面看着简单组合顺序一变就是坑。这套思路可以直接搬到你自己的项目里细节上按相机品牌适配一下就行。后面我打算再补一版多相机并发采集和自动对焦的封装等真正落地了再来分享。本文还有配套的精品资源点击获取