简介这份资源面向具备一定C#基础、希望在桌面端实现图像颜色识别的开发者围绕OpenCV的C#封装OpenCvSharp展开重点讲解HSV颜色空间下的颜色筛选与掩码处理可用于自动化检测、机器人视觉、物体定位等场景的入门与练手。压缩包共59个文件约35.14MB以cs源码、dll依赖库、resx与resources界面资源为主另含sln解决方案、exe可执行程序、config配置及少量jpg、png示例图片构成一个可直接编译运行的完整工程。已有1722人学习下载说明其在C#颜色识别方向具有一定参考价值。工程内含HSV参数设置、主界面、图像显示与放大等多个窗体模块并附HSV颜色体系示意图读者可据此理解色调、饱和度、亮度的取值范围掌握cvtColor转换、InRange生成二值掩码、按掩码保留目标颜色等关键流程并在此基础上调整阈值以适配不同颜色识别需求。1. 从一张偏色的工位照片说起opencv颜色识别.zip 到底装了什么上周帮产线调一个物料分拣的小工具现场灯光一打红色料块在相机里偏成了橙粉色阈值一卡就漏检。翻回这份opencv颜色识别.zip问题其实不在算法而在颜色空间选错了。这个包围绕 OpenCV 的 HSV 颜色识别展开核心是把 RGB 里纠缠在一起的颜色信息拆成色相、饱和度、明度三个独立通道再用inRange做区间掩膜配合形态学去噪和轮廓提取把「识别某个颜色」这件事跑通。它同时给了 Python 版和 C# 版OpenCvSharp两条线适合做视觉分拣、色块定位、简单色卡校验的从业者也适合刚接触 OpenCV 想找个能跑通的完整例子的人。下面按「HSV 为什么这么用 → 两条技术栈怎么落地 → 参数怎么调 → 坑在哪」拆开讲。2. HSV 颜色空间与 inRange为什么识别颜色要先换空间2.1 RGB 做阈值为什么容易翻车RGB 三个通道都在表达「亮度叠加」同一个红色物体光照强一点 R 冲到 255、G 和 B 也跟着涨光照弱一点三个值一起掉。你想用R 200 and G 80 and B 80卡红色白天能过傍晚就全漏。更麻烦的是 RGB 立方体里「红色」不是一个规整的盒子而是一个斜着穿过原点的锥形区域用矩形阈值去框它必然带进一堆邻近色。HSV 换了个思路HHue色相只描述「这是什么颜色」用 0180 的圆环表示OpenCV 里为了塞进 8 位无符号数把标准 0360 砍了一半SSaturation饱和度描述颜色纯不纯VValue明度描述亮不亮。红色物体在光照变化时H 基本稳定在 0 附近或 170180 附近变的只是 V。这就把「颜色判断」和「亮度判断」解耦了阈值区间可以卡得很窄还不怕光照抖动。提示OpenCV 的 H 范围是 0180 而不是 0360这是新手第一个大坑后面参数表会专门说。2.2 inRange 的掩膜逻辑与形态学收尾cv2.inRange(hsv, lower, upper)干的事很朴素逐像素判断是否落在[lower, upper]闭区间内落在里面给 255否则给 0输出一张单通道二值图。这张图就是「候选颜色区域」。但真实图像里总有噪点、反光、边缘毛刺直接拿它找轮廓会得到一堆碎块。所以标准流程是import cv2 import numpy as np img cv2.imread(sample.jpg) # BGR 转 HSV注意 OpenCV 读进来默认是 BGR 不是 RGB hsv cv2.cvtColor(img, cv2.COLOR_BGR2HSV) # 红色在 H 上跨了 0 边界所以要分两段卡再合并 lower1 np.array([0, 120, 70]) upper1 np.array([10, 255, 255]) lower2 np.array([170, 120, 70]) upper2 np.array([180, 255, 255]) mask1 cv2.inRange(hsv, lower1, upper1) mask2 cv2.inRange(hsv, lower2, upper2) mask cv2.bitwise_or(mask1, mask2) # 开运算去小噪点闭运算补内部空洞 kernel np.ones((5, 5), np.uint8) mask cv2.morphologyEx(mask, cv2.MORPH_OPEN, kernel) mask cv2.morphologyEx(mask, cv2.MORPH_CLOSE, kernel) # 找外轮廓只取最外层 contours, _ cv2.findContours(mask, cv2.RETR_EXTERNAL, cv2.CHAIN_APPROX_SIMPLE) for c in contours: area cv2.contourArea(c) if area 500: # 面积过滤去掉残余噪点 continue x, y, w, h cv2.boundingRect(c) cv2.rectangle(img, (x, y), (x w, y h), (0, 255, 0), 2) cv2.imshow(result, img) cv2.waitKey(0)这段代码的逻辑链条是转空间 → 分段卡红色 → 合并掩膜 → 形态学清理 → 面积过滤 → 画框。几个参数值得单独说lower/upper里的 S 下限设 120 是为了排除灰白色饱和度低的像素 H 值不稳定容易误判V 下限 70 是排除过暗区域暗处噪声大kernel用 5×5 是经验值太小去不掉噪点太大把目标边缘啃掉area 500这个阈值必须按你的实际分辨率和目标大小调1080p 下一个小色块可能就几百像素卡 500 会直接漏掉。2.3 红色为什么必须分两段H 是个环形量红色横跨 0 度。你写lower[170,...] upper[10,...]inRange会认为下界大于上界直接返回全黑。正确做法就是上面那样拆成[0,10]和[170,180]两段分别卡再按位或。绿色、蓝色不跨边界一段就够。这个细节在 C# 版里同样成立OpenCvSharp 的Cv2.InRange行为一致。3. Python 与 OpenCvSharp 双线落地从读图到框出目标3.1 Python 线先跑通再谈调参拿到包先别急着改参数用包里自带的示例图跑一遍确认环境没问题。依赖就两个pip install opencv-python numpy跑通后建议加一个实时调参的小工具比盲猜阈值高效得多。用 TrackBar 把 H/S/V 的上下界挂到滑动条上边拖边看掩膜变化import cv2 import numpy as np def nothing(x): pass cv2.namedWindow(track) # 六个滑动条对应 H/S/V 的上下界 for name, val, maxv in [(Hl, 0, 180), (Hh, 180, 180), (Sl, 0, 255), (Sh, 255, 255), (Vl, 0, 255), (Vh, 255, 255)]: cv2.createTrackbar(name, track, val, maxv, nothing) cap cv2.VideoCapture(0) # 0 是默认摄像头也可换成视频文件路径 while True: ok, frame cap.read() if not ok: break hsv cv2.cvtColor(frame, cv2.COLOR_BGR2HSV) lo np.array([cv2.getTrackbarPos(Hl, track), cv2.getTrackbarPos(Sl, track), cv2.getTrackbarPos(Vl, track)]) hi np.array([cv2.getTrackbarPos(Hh, track), cv2.getTrackbarPos(Sh, track), cv2.getTrackbarPos(Vh, track)]) mask cv2.inRange(hsv, lo, hi) cv2.imshow(mask, mask) cv2.imshow(frame, frame) if cv2.waitKey(1) 0xFF 27: # ESC 退出 break cap.release() cv2.destroyAllWindows()滑动条的价值在于你能直观看到「H 往左拖一点橙色料块就进来了」这种边界效应比对着数值表猜快十倍。调好后把六个值抄进正式脚本的lower/upper里即可。注意createTrackbar的 max 对 H 是 180别写成 360否则拖到一半就超出有效范围。3.2 C# 线OpenCvSharp 的等价写法C# 项目里用 OpenCvSharp4NuGet 装两个包OpenCvSharp4和对应平台的 runtimeWindows 下是OpenCvSharp4.runtime.win。核心 API 和 Python 一一对应但类型是Scalar和Mat数组下标从Vec3b取using OpenCvSharp; using var src Cv2.ImRead(sample.jpg); using var hsv new Mat(); Cv2.CvtColor(src, hsv, ColorConversionCodes.BGR2HSV); // Scalar 顺序是 H、S、V和 Python 的数组一致 var lower1 new Scalar(0, 120, 70); var upper1 new Scalar(10, 255, 255); var lower2 new Scalar(170, 120, 70); var upper2 new Scalar(180, 255, 255); using var mask1 new Mat(); using var mask2 new Mat(); Cv2.InRange(hsv, lower1, upper1, mask1); Cv2.InRange(hsv, lower2, upper2, mask2); using var mask new Mat(); Cv2.BitwiseOr(mask1, mask2, mask); // 形态学核用 Mat.Ones类型必须是 CV_8U using var kernel Mat.Ones(5, 5, MatType.CV_8UC1); Cv2.MorphologyEx(mask, mask, MorphTypes.Open, kernel); Cv2.MorphologyEx(mask, mask, MorphTypes.Close, kernel); Cv2.FindContours(mask, out Point[][] contours, out _, RetrievalModes.External, ContourApproximationModes.ApproxSimple); foreach (var c in contours) { double area Cv2.ContourArea(c); if (area 500) continue; Rect r Cv2.BoundingRect(c); Cv2.Rectangle(src, r, new Scalar(0, 255, 0), 2); } Cv2.ImShow(result, src); Cv2.WaitKey(0);几个 C# 特有的点Mat.Ones的MatType必须写CV_8UC1写成默认的浮点类型会在MorphologyEx里直接抛异常FindContours的out参数在 OpenCvSharp4 里是Point[][]不是Mat[]Scalar的四个分量是 double传整数没问题但别传负数。这套写法和 Python 版输出完全一致方便两边对照排查。3.3 两条线的选型边界Python 适合快速验证、调参、写离线批处理脚本C# 适合嵌进桌面工具或工控上位机部署时不用带 Python 运行时。如果你的场景是产线实时检测C# 的启动开销和内存占用更可控如果是算法预研Python 的迭代速度无可替代。包里两条线都给了建议先用 Python 把阈值调准再把数值搬到 C#别在 C# 里反复编译试参数那个循环太慢。4. 阈值参数怎么定一张表把 H/S/V 卡准4.1 常用颜色的参考区间下面这张表是 OpenCV H∈[0,180] 体系下的经验起点实际必须用 3.1 的滑动条在你的相机和光源下微调直接抄只能保证「大致对」颜色H 下界H 上界S 下界S 上界V 下界V 上界红低段01012025570255红高段17018012025570255橙112212025570255黄233510025570255绿36858025550255蓝9013010025550255紫1311608025550255S 下限卡 80120 是通用做法低于这个值的像素接近灰白H 值会剧烈跳变是误检的主要来源。V 下限卡 5070 是为了避开阴影区但如果你要识别的目标本身偏暗这个值得往下放代价是噪声变多需要靠形态学补回来。4.2 参数调整的三个抓手第一抓 H 宽度。目标颜色纯度高就卡窄±5混色多就放宽±15但放宽会带进邻近色要靠 S/V 收紧来补偿。第二抓 S 下限。现场如果有白色背景或反光S 下限往上提能显著压掉误检。第三抓面积阈值。它和分辨率强相关换相机必须重算经验公式是「目标最小边长像素数² × 0.3」比如目标最小 40 像素见方面积阈值取 480 左右。注意调参时一定要用现场实际光源和实际物料别用网图。色温差 1000KH 值能偏 58阈值区间直接错位。5. 避坑与排查五个真实翻车现场5.1 掩膜全黑一个轮廓都没有现象代码跑通无报错mask输出全黑。原因九成是 H 范围写成了 0360或者lower的某个分量大于upper。OpenCV 的 H 上限是 180写 360 时inRange不会报错只是永远不命中。解决打印hsv图中心像素的H/S/V值确认量级检查lower upper逐分量成立红色跨边界必须分段。5.2 目标框住了但框得忽大忽小现象同一物体帧间检测框面积跳动明显。原因通常是形态学核太大把边缘啃得不稳定或者面积阈值卡在目标面积的临界点附近。解决核降到 3×3 试面积阈值下调 30% 留余量如果目标本身有反光导致掩膜内部空洞闭运算的核可以单独放大到 7×7开运算保持 3×3两个操作分开设核。5.3 C# 里 MorphologyEx 抛异常现象Python 版正常C# 版在MorphologyEx处崩。原因基本是Mat.Ones的MatType用了默认浮点类型形态学要求核是CV_8UC1。解决显式写Mat.Ones(5, 5, MatType.CV_8UC1)另外确认mask是单通道InRange输出本来就是单通道但如果中间做过CvtColor要检查通道数。5.4 白天好用晚上全漏现象光照一变检测率断崖下跌。原因是 V 下限卡太高暗环境下目标 V 值整体下移掉出区间。解决V 下限从 70 降到 40 试同时把 S 下限提 1020 补偿噪声更稳的做法是加自动曝光或补光别指望纯靠阈值扛光照变化那是玄学。5.5 红色总是漏一半现象红色目标只框住一部分或者干脆没有。原因就是没做 H 分段只卡了[0,10]漏掉高段或只卡[170,180]漏掉低段。解决两段inRange后bitwise_or合并这是红色识别的固定动作别省。6. 进阶把单帧识别改成能落地的检测循环单张图跑通只是起点真正要用得把上面这套封成函数接进视频流或相机循环并且加上帧间稳定性判断。我一般会这么收口把「转 HSV → 分段 inRange → 形态学 → 找轮廓 → 面积过滤」封成一个detect_color(frame, ranges)返回目标框列表主循环里对连续 3 帧都检测到的框才输出避免单帧噪声触发误动作。下面这个骨架可以直接套def detect_color(frame, ranges, min_area500): hsv cv2.cvtColor(frame, cv2.COLOR_BGR2HSV) mask None for lo, hi in ranges: # ranges 是 [(lower1,upper1),(lower2,upper2)] m cv2.inRange(hsv, lo, hi) mask m if mask is None else cv2.bitwise_or(mask, m) kernel np.ones((3, 3), np.uint8) mask cv2.morphologyEx(mask, cv2.MORPH_OPEN, kernel) mask cv2.morphologyEx(mask, cv2.MORPH_CLOSE, kernel) contours, _ cv2.findContours(mask, cv2.RETR_EXTERNAL, cv2.CHAIN_APPROX_SIMPLE) boxes [] for c in contours: if cv2.contourArea(c) min_area: continue boxes.append(cv2.boundingRect(c)) return boxes # 帧间稳定连续 3 帧都有检测才认为有效 stable 0 while True: ok, frame cap.read() if not ok: break boxes detect_color(frame, [(lower1, upper1), (lower2, upper2)]) stable stable 1 if boxes else 0 if stable 3: for (x, y, w, h) in boxes: cv2.rectangle(frame, (x, y), (x w, y h), (0, 255, 0), 2) cv2.imshow(out, frame) if cv2.waitKey(1) 0xFF 27: breakranges用列表传是为了兼容红色这种需要分段的颜色单段颜色传一个元素就行。stable计数是最便宜的防抖比卡尔曼滤波省事代价是响应延迟 23 帧产线节拍快的话要权衡。验证方法很直接拿一段现场录像回放统计漏检帧和误检帧漏检多就放宽 H/S误检多就收紧 S 下限和面积阈值别一次改多个参数改一个跑一遍录像不然出了问题都不知道是哪个参数惹的。血泪经验是每次换相机、换光源、换物料颜色这套阈值都得重调一遍没有一劳永逸的参数。从那以后我每次上新工位都强制先用滑动条工具跑十分钟再写正式代码省下的返工时间远超这十分钟。希望帮到你。本文还有配套的精品资源点击获取
