简介围绕C#与HALCON构建的机器视觉检测系统是一套面向机器视觉初学者与中高级开发者的完整工程源码聚焦工件表面质量检测场景。系统按图像采集、预处理、特征提取、决策反馈和图形界面等模块组织展示相机取图、去噪增强、形状与模板匹配、缺陷判定及报警联动的实现路径适合用于课程实践、项目原型验证和二次开发参考。压缩包共245个文件、约45.48MB以80个C#源码文件为核心配有35张BMP测试图像、29个DLL与23个PDB依赖调试文件以及10个resx/resources界面资源、6个csproj工程文件、3个exe和sln解决方案等目录结构较完整便于直接打开工程梳理调用关系。已有7066人学习下载。读者可据此理解C#调用HALCON算子、视觉流程编排、检测结果展示与工程部署方式并借助测试图复现实验、定位问题积累可迁移的机器视觉系统开发经验。1. 一条外观检测线的真实取舍C# 与 HALCON 到底谁管哪一段某产线要做零件外观检测最初的想法很朴素用 C# 把相机采到的图读成 Bitmap自己写阈值、找轮廓、算尺寸。真跑到现场就卡住了——换一批来料光照差两档阈值全废亚像素定位没有测量值跳动比公差还大模板匹配要从头造轮子。后来改成 C# 写上位机、HALCON 做算法内核机器视觉里最费劲的那部分交给成熟算子库视觉检测系统里界面、流程、数据、报警、配方这些工程活留在 C# 里。这份 C# 与 HALCON 联合开发的机器视觉软件系统源代码就是按这个分工搭起来的完整视觉检测系统相机采集、模板定位、尺寸测量、缺陷判定、结果落盘、配方切换一条链走完。它适合正在做机器视觉方向毕设或课程设计的学生也适合要把一套能跑的 C# 视觉软件直接搬到自己设备上改的工程师。2. 需求拆解与选型把「能看见缺陷」翻译成节拍、精度和软件栈2.1 检测项怎么落成可量化的指标需求沟通里最容易翻车的一句话是「要能检出划伤」。这句话没法验收也没法写代码。负责的做法是先把它拆成四列测什么、用什么成像方式测、精度要到多少、判定阈值是多少。检测项一般分三类——尺寸类长度、直径、间距、角度、位置类装配偏移、缺件、错件、表面类划伤、脏污、毛刺、压痕。三类在算法上的实现路径完全不同尺寸类靠测量工具位置类靠模板匹配加区域比对表面类多半要靠 Blob 分析、频域滤波或者差异图。精度这一栏要用像素当量倒推不能拍脑袋。视场 40mm、相机 2448×2048像素当量约 0.016mm/pixelHALCON 的亚像素边缘通常能做到 1/4 像素以内折算下来重复性在 0.004mm 量级。所以一个标称 ±0.02mm 的尺寸项在这个配置下是有余量的要是公差要求 ±0.005mm那就该换远心镜头、提高分辨率或者上背光而不是指望算法硬扛。我一般会先算这笔账再谈选型省得后面相机都装好了才发现精度不够。检测项成像方式精度要求判定方式外形长宽背光、远心镜头±0.02mm卡尺工具测边缘对距离孔位偏移同轴光±0.03mm模板匹配定位后测圆心表面划伤低角度环形光最小 0.1mm×2mmBlob 面积长宽比筛选缺件/错件正面均匀光有无判断区域灰度均值与模板比对装配间隙侧向条形光±0.05mm测量矩形内双边缘间距节拍是另一条硬约束。单件 300ms 的产线一次曝光加传输大概吃掉 6080ms算法预算只剩 200ms 出头还得留出通讯和界面刷新的余量。所以算法流程要做成「先粗后精」先用降采样图像做快速定位把 ROI 缩到工件附近再做全分辨率的测量和判定。这套系统的流程编排就是按这个思路排的每个工具只在自己关心的 ROI 里跑不整图扫。2.2 C# 做上位机、HALCON 做算法核的分层依据有人会问HDevelop 也能拖界面为什么还要 C#答案是工程化。产线上的软件不只是跑算法它要连 PLC、要存追溯数据、要做用户权限、要支持十几个料号的配方切换、要能在客户现场远程看日志。这些事 HDevelop 做得吃力.NET 生态里是现成的。反过来纯 C# 加 OpenCVSharp 也能做视觉但形状模板匹配的抗遮挡能力、亚像素边缘的稳定性、标定工具链的完整度调起来的隐性成本很高。所以分工线画在这里C# 负责「壳」——界面、流程调度、多线程、数据库、通讯协议、配置管理、日志与报警HALCON 负责「眼」——图像预处理、模板匹配、边缘提取、测量、Blob 分析、标定换算。两边通过 HALCON 的 .NET 接口HObject / HTuple交接边界清晰。这条线画对了后面加检测项就是加一个工具类不用动主流程。分层还有个现实好处算法参数可以外置成配方工艺工程师改参数不用重新编译。这套系统里所有阈值、ROI 偏移、匹配分数下限、灰度上下限都放在配方文件里程序启动时加载切换料号时热更新。2.3 算子与相机选型的对照取舍选型时最常纠结的几组我把自己会怎么选列出来场景常见选择 A常见选择 B我一般选工件有旋转、部分遮挡NCC 灰度匹配形状模板匹配B对光照变化和遮挡更稳边缘位置测量手写梯度找极值measure_pos 测量工具B亚像素和抗噪现成表面缺陷提取固定阈值 Blob动态阈值 形态学B适应光照漂移大幅面高速采集USB3 面阵GigE 面阵看线长超过 5m 用 GigE精密尺寸普通 FA 镜头双远心镜头B视场内的放大倍率一致性更好相机接口这块GigE 的优点是线缆长、多相机组网方便缺点是延迟比 USB3 略高USB3 带宽足、延迟低但线长限制在 35m工业现场走线要提前规划。这套系统里采集层做了接口抽象换相机只改一个配置项算法层完全不用动——这也是分层带来的直接收益。提示选型阶段就把「精度、节拍、视场、景深」四个数写进需求文档后面所有争论都回到这四个数上比争论用哪个算子有效得多。3. 总体架构设计三层结构与六个模块的职责边界3.1 表现层、业务层、算法层的划分整套软件按三层切。表现层是 WinForm 或 WPF 的主界面负责实时图像显示、结果列表、参数编辑、报警提示它不碰任何 HALCON 算子只消费业务层给出来的结果对象。业务层是流程引擎和调度中心管着「取图 → 定位 → 测量 → 判定 → 存档 → 通讯」这条流水线同时管配方加载、权限校验、异常上报。算法层是 HALCON 的封装每个检测能力包装成一个工具类对外只暴露「输入图像 参数 → 输出测量值」这样的签名。这样切的好处是测试好做。算法层的每个工具可以单独拿一批离线图片跑回归业务层可以用假的图像源做流程测试界面层改动不影响算法正确性。做毕设答辩时这一点特别加分——老师问「你怎么验证算法是对的」你能拿出分层测试的记录比说「我跑了一遍看着没问题」有说服力得多。六个模块分别是设备接入相机、光源、PLC/IO、图像预处理、定位与测量、判定与分类、数据与追溯、配方与权限。每个模块内部的类只依赖下一层的接口不允许跨层直接调。比如判定模块不能自己去读相机它只接收测量模块的结果数组。3.2 图像从相机到算法再到数据库的流转通路高节拍下最容易出问题的是图像流转。做法是采集与处理分离相机回调线程只做一件事——把 HObject 塞进一个有界队列然后立刻返回绝不在回调里跑算法。算法线程从队列里取图处理处理完把结果对象推到结果队列界面线程和存盘线程各自消费。队列要有界满了就丢最旧的一帧并记一条丢帧日志避免内存无限堆积。// 采集线程与算法线程之间的有界缓冲容量按节拍和算法耗时估算 private readonly BlockingCollectionHObject _imageQueue new BlockingCollectionHObject(8); // 相机回调只负责入队禁止在这里做任何耗时运算 private void OnImageGrabbed(HObject image) { HObject copy; HOperatorSet.CopyImage(image, out copy); // 回调缓冲会被复用必须拷贝 if (!_imageQueue.TryAdd(copy)) { // 队列满说明算法跟不上节拍丢弃并计数事后看日志定位瓶颈 copy.Dispose(); Interlocked.Increment(ref _dropCount); } } // 算法线程主循环 private void ProcessLoop() { foreach (var img in _imageQueue.GetConsumingEnumerable(_cts.Token)) { using (img) { var result _pipeline.Run(img); // 内部依次调用各工具 _resultQueue.Add(result); } } }这里的关键点是CopyImage。很多相机 SDK 的回调缓冲区是复用的你把引用直接传出去下一帧到来时图像内容就被覆盖了现象是「偶尔检测到上一件的缺陷」这种问题查起来极其折磨。拷贝一次的代价远小于排查成本。队列容量 8 是按「算法单帧 80ms、节拍 300ms」估的实际项目里按实测的算法耗时乘 23 倍来定太大反而掩盖性能问题。3.3 模块之间的接口约定与异常传递工具层统一接口是为了让流程配置化。每个检测工具实现同一个契约流程引擎按配方里配置的顺序依次执行public interface IVisionTool { string Name { get; } // 工具标识配方里按名字引用 ToolResult Execute(HObject image, JObject param); // param 来自配方文件的节点 } public class ToolResult { public bool Success { get; set; } // 算法是否正常执行完 public int ErrorCode { get; set; } // 非 0 表示执行失败界面按码查提示 public double[] Values { get; set; } // 测量值数组单位统一为毫米 public bool IsOk { get; set; } // 判定结论与 Success 分开 public string DefectCode { get; set; } // NG 时的缺陷编码用于统计 }Success和IsOk必须分开。算法没跑通找不到模板、图像过曝、边缘数量不对是执行异常产品合格与否是判定结论两者混在一起会导致「算法失败被当成 NG 品流出去」这在追溯时是灾难。执行异常要走独立的报警通道让设备停下来等人处理而不是默默计数。结果落盘用一张主表加一张明细表就够了主表存单件结论明细存每个测量项的值方便后面按项做趋势分析CREATE TABLE InspectionRecord ( Id INTEGER PRIMARY KEY AUTOINCREMENT, Sn TEXT NOT NULL, -- 产品条码/流水号 RecipeCode TEXT NOT NULL, -- 料号用于分料号统计 Result INTEGER NOT NULL, -- 1OK, 0NG DefectCode TEXT, -- NG 缺陷编码OK 时为空 ImagePath TEXT, -- NG 图像存档路径 CreateTime TEXT NOT NULL ); CREATE INDEX idx_record_sn ON InspectionRecord(Sn); CREATE INDEX idx_record_time ON InspectionRecord(CreateTime); CREATE TABLE MeasureDetail ( Id INTEGER PRIMARY KEY AUTOINCREMENT, RecordId INTEGER NOT NULL, ItemName TEXT NOT NULL, -- 测量项名称与配方节点对应 Value REAL NOT NULL, LowerLimit REAL, UpperLimit REAL, IsOk INTEGER NOT NULL );索引这两条不是凑数。按 Sn 查是为了追溯按时间查是为了做日报和趋势图产线上这两个查询是每天都跑的。明细表拆出来是因为一个工件可能有十几二十个测量项塞进主表的 JSON 字段里查起来费劲做 SPC 分析时更难受。4. 核心模块实现采集、定位、测量、判级四段代码落地4.1 相机接入与 HObject 的生命周期相机接入层要做三件事打开设备、配置参数、稳定取图。HALCON 用open_framegrabber统一封装各家接口参数随接口类型不同而不同具体字段要按相机厂商的接口文档对齐不能照抄。public class CameraDevice : IDisposable { private HTuple _acqHandle null; private readonly object _lock new object(); public void Open(string interfaceName, string deviceId) { // 参数顺序固定含义依次为接口名、水平/垂直分辨率、起始位置、 // 图像宽高、场序、位深、色彩空间、泛型参数、外部触发、相机类型、设备标识 HOperatorSet.OpenFramegrabber( interfaceName, 0, 0, 0, 0, 0, 0, progressive, -1, default, -1, false, default, deviceId, -1, -1, out _acqHandle); // 关掉自动曝光和自动增益产线上这两个必须锁死否则测量值会漂 HOperatorSet.SetFramegrabberParam(_acqHandle, ExposureTime, 8000); HOperatorSet.SetFramegrabberParam(_acqHandle, Gain, 0); } public HObject GrabOnce(int timeoutMs) { lock (_lock) // 同一句柄不能并发调用加锁是最省事的做法 { HOperatorSet.GrabImageAsync(out HObject image, _acqHandle, timeoutMs); return image; } } public void Dispose() { if (_acqHandle ! null) { HOperatorSet.CloseFramegrabber(_acqHandle); _acqHandle null; } } }自动曝光这一条值得单独说。调试时开着自动曝光画面好看上线后光源老化、环境光变化相机会自己调增益灰度整体漂移阈值型检测项集体失效。血泪经验是调试阶段就用固定曝光固定增益把光源亮度调到能拿到稳定灰度的位置之后不再动它。真要适应不同料号的反光差异靠配方里的曝光参数切换不靠相机自动。HObject 是托管包装的非托管资源必须显式释放。用using或者 try/finally 里的Dispose()不能指望 GC。这一点在第 5 章展开。4.2 形状模板匹配与亚像素定位定位是整个流程的地基定位偏了后面所有测量都偏。做法分两步建模阶段从一张标准件图像里抠出特征明显的区域生成形状模板运行阶段用模板在当前图里找位姿。// 建模在一张合格品图像上框出特征区生成形状模板 public HTuple CreateTemplate(HObject image, double row1, double col1, double row2, double col2) { HOperatorSet.GenRectangle1(out HObject roi, row1, col1, row2, col2); HOperatorSet.ReduceDomain(image, roi, out HObject domain); roi.Dispose(); // 角度范围 -0.39~0.39 rad约 ±22.5°覆盖来料旋转 // 金字塔层数、对比度、最小对比度都交给 auto让算子按图像自选 HOperatorSet.CreateShapeModel( domain, auto, -0.39, 0.79, auto, auto, use_polarity, auto, auto, out HTuple modelId); domain.Dispose(); return modelId; } // 运行在当前图中查找返回行、列、角度、得分 public bool Find(HTuple modelId, HObject image, out double row, out double col, out double angle) { HOperatorSet.FindShapeModel( image, modelId, -0.39, 0.79, 0.7, // 最小得分低于它认为没找到 1, // 最多找几个匹配单件检测取 1 0.5, // 重叠度 least_squares, // 亚像素模式精度最高的那一档 0, // 金字塔层数0 表示用建模时的设置 0.9, // 贪婪度越大越快越可能漏 out HTuple r, out HTuple c, out HTuple a, out HTuple score); row r.Length 0 ? r.D.ToArray()[0] : 0; col c.Length 0 ? c.D.ToArray()[0] : 0; angle a.Length 0 ? a.D.ToArray()[0] : 0; return score.Length 0 score.D[0] 0.7; }参数里最需要现场调的是MinScore和Greediness。MinScore 定太低0.5 以下会把相似结构误认成目标定太高0.85 以上则在来料表面有轻微脏污时找不到。经验值是先设 0.7拿一批包含边界样本的图跑看得分分布取一个能把 OK 品和误匹配分开的阈值。Greediness 默认 0.9如果发现偶尔漏检先往 0.8 降一档试试速度会慢一些但更稳。建模区域的选择也有讲究不要选大面积的均匀区域那种区域没有梯度信息模板会退化成靠边缘支撑抗噪能力差要选带角点、圆孔、缺口这类强特征的位置。模板图像尽量用实际产线的相机和光源拍别拿实验室的样品图凑合光学条件不一样模板的对比度参数就不对了。4.3 测量与判级从像素值到 OK/NG 结论有了位姿测量就好办了。思路是把模板坐标系里定义好的测量位置通过刚性变换映射到当前图像的实际位置再用测量工具在映射后的位置取边缘。这样来料有平移旋转也不影响。// 模板坐标系下的基准点与测量矩形参数建模时在标准件上确定 private const double TplRow 512.0; private const double TplCol 640.0; private const double TplAngle 0.0; public double MeasureGap(HObject image, double mRow, double mCol, double mAngle, JObject param) { // 1. 用匹配位姿构造模板坐标 - 当前图像坐标的刚性变换 HOperatorSet.VectorAngleToRigid(TplRow, TplCol, TplAngle, mRow, mCol, mAngle, out HTuple homMat2D); // 2. 把模板里定义好的测量中心映射过去测量框跟着工件一起转 HOperatorSet.AffineTransPoint2d(homMat2D, TplRow, TplCol - 80, out HTuple row, out HTuple col); HTuple phi TplAngle mAngle; // 3. 生成测量矩形长 60 宽 12方向沿工件边插值选双线性 HOperatorSet.GenMeasureRectangle2(row, col, phi, 30, 6, 60, 12, bilinear, out HTuple handle); // 4. 在矩形内找边缘对sigma1.0 抑制噪声threshold30 控制灵敏度 HOperatorSet.MeasurePos(image, handle, 1.0, 30, all, all, out HTuple edgeRow1, out HTuple edgeCol1, out HTuple amp1, out HTuple edgeRow2, out HTuple edgeCol2, out HTuple amp2, out HTuple intraDist, out HTuple interDist); HOperatorSet.CloseMeasure(handle); if (intraDist.Length 1) throw new VisionException(1001, 测量框内未找到成对边缘检查光照或测量框位置); // interDist 是相邻边缘间距像素乘像素当量换成毫米 double pixelScale param.Valuedouble(PixelScale); // 由标定得到如 0.0163 return interDist.D[0] * pixelScale; }Sigma和Threshold这两个参数是测量的手感所在。Sigma 是高斯平滑的系数来料表面粗糙、图像噪点大就调大到 1.52.0代价是边缘位置会被轻微模糊精度略降图像干净就保持 1.0 甚至 0.8。Threshold 是边缘幅度阈值它决定什么算作边缘——太低会把噪点当边缘太高会漏掉对比度弱的真实边缘。稳妥的做法是打开边缘幅度输出看一批图的幅度分布把阈值定在噪声幅度和真实边缘幅度之间。判级就是拿测量值和配方里的上下限比public (bool ok, string defectCode) Judge(double value, JObject param) { double lower param.Valuedouble(LowerLimit); double upper param.Valuedouble(UpperLimit); double tol param.Valuedouble(JudgeTolerance); // 判定死区默认 0 // 死区的作用刚好卡在边界上的值做二次确认避免 OK/NG 反复横跳 if (value lower - tol) return (false, param.Valuestring(DefectCodeLow)); if (value upper tol) return (false, param.Valuestring(DefectCodeHigh)); return (true, null); }判定死区这个小设计在批量生产时很关键。没有它的时候一个值在上下限附近抖同一个工件可能这次 OK 下次 NG操作员会怀疑设备有问题。加了死区之后边界附近的值统一往宽松方向靠配合趋势图看反而更容易发现工艺漂移。NG 图像一定要存。存图策略按「日期 / 料号 / 时间戳_缺陷码」的目录结构落盘保留最近 30 天超期自动清理。这张图在后续分析缺陷成因、和供应商扯皮的时候是唯一的证据链。4.4 配方管理换料号不改代码配方是这套系统里最能体现工程成熟度的部分。十几个料号每个料号的 ROI、阈值、模板、上下限都不同如果写死在代码里每换一次料就要改代码重新发版现场根本没法用。配方的组织方式是一棵 JSON 树根节点是料号下面是工具链数组每个工具节点带自己的参数{ RecipeCode: P-1024, PixelScale: 0.0163, Tools: [ { Name: Locate, Type: ShapeMatch, TemplateFile: tpl_1024.shm, MinScore: 0.72, AngleStart: -0.39, AngleExtent: 0.79 }, { Name: GapA, Type: MeasurePair, RefRow: 512, RefCol: 560, LowerLimit: 1.98, UpperLimit: 2.06, JudgeTolerance: 0.005, DefectCodeLow: GAP_SMALL, DefectCodeHigh: GAP_LARGE }, { Name: Scratch, Type: BlobDefect, MinArea: 120, MaxAspect: 8.0, GrayLow: 40, DefectCode: SCRATCH } ] }流程引擎按Tools数组顺序执行遇到Locate就把位姿写进上下文后面的测量工具从上下文里取。新增一个检测项只是在数组里加一个节点代码零改动。配方的加载和热切换要注意两点一是切换时必须在流程空闲的间隙做不能在一件工件处理到一半时换参数二是每次切换记一条日志包含料号、操作人、时间出问题时能对上是哪次切换引入的偏差。注意配方文件建议加版本号和校验值现场出现过配置文件被人手工改坏、程序启动直接崩的情况加个校验能提前拦住。5. 避坑与常见问题排查内存、线程、标定三处最容易翻车的地方5.1 内存只涨不落现象程序跑两三个小时内存从 200MB 涨到 2GB最后卡死或者被系统杀掉。原因几乎都是 HObject 没释放。HALCON 的图像和区域对象底层是非托管内存C# 的 GC 只回收包装对象不会主动去释放底层句柄峰值节拍下对象创建速度远超终结器回收速度句柄就堆起来了。解决方法是所有 HObject 都走using或者在方法末尾显式Dispose()尤其注意异常分支——try 块里创建了对象catch 里直接 return那个对象就漏了。// 反面写法异常一抛img 和 region 都不会被释放 HObject img; HOperatorSet.ReadImage(out img, path); HObject region; HOperatorSet.Threshold(img, out region, 0, 128); DoSomething(region); // 若这里抛异常上面两个对象泄漏 // 正确写法用 using 包住无论走哪条分支都释放 using (HObject img new HObject()) using (HObject region new HObject()) { HOperatorSet.ReadImage(out img, path); HOperatorSet.Threshold(img, out region, 0, 128); DoSomething(region); }排查手段任务管理器看句柄数比看内存更准句柄只涨不落就是泄漏。也可以在每个流程节点前后打一条get_system(handle_count)的日志几个循环就能定位到是哪个工具漏了。5.2 多线程下的偶发崩溃现象单线程跑一天没事改成多线程后随机崩报的是访问冲突或者算子内部错误日志里看不出规律。原因是 HALCON 的 HTuple 和 HObject 不是线程安全的两个线程同时操作同一个对象或者在 A 线程创建、B 线程释放都可能出问题。解法是「谁创建谁释放跨线程只传值不传引用」算法线程处理完把测量值double 数组和结果码传出去不要把 HObject 传来传去确实要传图像就在目标线程里CopyImage一份。另外 HALCON 的算子在内部已经做了并行外层再开一堆线程抢 CPU 反而是负优化算法线程一般开 12 个就够。5.3 标定与像素当量换算翻车现象测量值整体偏大或偏小百分之几重复性很好但准确度不对。原因多半在像素当量上。像素当量不是拿标称视场除分辨率算出来的那个值忽略了镜头畸变和实际放大倍率偏差。正确做法是拿一块标准量块或者标定板在同一工作距离下拍图量出已知长度对应的像素数两者相除。更严谨的做法是做多点标定把镜头畸变一起拟合掉视场边缘的测量值才不会系统性偏大。还有个容易忽略的点更换镜头、调整工作距离、甚至相机被撞了一下像素当量都要重新标。我见过一个项目调试时标定过后来调焦换了镜头没重标整批产品尺寸超差却判 OK流到客户那边才发现。现在我的习惯是每次动过光学系统就在配方里改标定日期并在开机自检里加一条「标定有效期提醒」。5.4 触发时序错位与丢帧现象检测结果和产品对不上号或者偶尔漏检一件。这类问题多半在触发链路上。相机是硬触发还是软触发、PLC 给信号到相机曝光的延迟多少、编码器分频对不对、光源频闪和曝光是否同步任何一环错位都会导致「拍到了相邻的一件」。排查方法是拿一张带标记的样件连续跑 100 件把每件的图像和条码一一对应看错位会立刻暴露。修复上硬触发优先于软触发触发信号走光耦隔离别用普通 IO 直连曝光时间和光源延时要在配方里成组配置不能分开调。5.5 部署环境缺运行库现象开发机上跑得好好的拷到产线电脑上双击就报错或者一打开相机就崩。原因是目标机缺 HALCON 运行时或者 .NET 运行时版本不匹配也可能是相机厂商的驱动没装、网卡巨帧没开。部署前要列一张环境清单.NET 运行时版本、HALCON 运行库位数32/64 位必须和主程序一致、相机驱动版本、网卡巨帧和中断亲和性设置、系统电源计划改成高性能别让 CPU 降频。这张清单每次部署都过一遍比现场抓瞎强。6. 验收与答辩用一组可复现的数据证明系统「测得准、跑得稳」验收这一步很多人栽在「我说它准」上。合格的做法是拿数据说话而且数据要可复现。我一般准备三组测试准确性测试、重复性测试、稳定性测试。准确性用标准件。拿 10 件已知尺寸的标准件或者三坐标测过的样件每件测 10 次算每个测量项的平均值和标准值的偏差。偏差要小于公差的三分之一超了就得回去查标定或者算法。重复性用同一件产品连续测 30 次算标准差这个数反映的是系统自身的抖动一般要求小于公差的十分之一。稳定性是连续跑 48 小时统计总检数、误检数、漏检数、算法异常次数同时记录内存和句柄曲线。验收项指标测试方法记录内容测量准确性偏差 ≤ 公差/310 件标准件 × 10 次均值、偏差、最大值重复性标准差 ≤ 公差/10同件连续 30 次标准差、极差检出率≥ 99.5%200 件含已知缺陷样本漏检数、漏检类型误检率≤ 0.5%200 件合格品误检数、误检原因节拍≤ 设计值连续 500 件计时平均、P95、最大值长时间稳定性8 小时无异常连续运行内存曲线、异常次数节拍统计最好在程序里内建别拿秒表掐// 每个流程节点前后打点落库后直接出 P95 报表 var sw Stopwatch.StartNew(); var result _pipeline.Run(image); sw.Stop(); _repo.SaveTiming(result.Sn, result.RecipeCode, sw.Elapsed.TotalMilliseconds);答辩时的讲法我的建议是倒过来讲先讲误检漏检的数据和你是怎么把这两个数压下去的再讲架构和代码。老师最想听的不是「我用了什么技术」而是「你怎么知道它是对的」。你可以拿出那张 200 件样本的混淆矩阵讲某一类缺陷一开始漏检率 8%查下来是 Blob 面积下限设太大把下限从 200 调到 120 之后降到 0.5%——这种带数字的调试过程比任何架构图都有说服力。还有一个常被问到的点如果换个料号怎么办。这时候现场演示配方切换30 秒内完成切换后连续跑 20 件全部正确这一下就把「课程作业」和「能交付的系统」区分开了。从那以后我每次做完一套视觉系统验收前都强制走一遍「标准件 重复性 8 小时连续跑」这三关哪怕时间再紧也不跳。跳过一次后面在现场补的功夫是省下来那点时间的好几倍。希望这套结构和记录方法能帮到你需要对照完整实现的话仓库里的源代码可以直接拿去做参考。本文还有配套的精品资源点击获取
简介围绕C#与HALCON构建的机器视觉检测系统是一套面向机器视觉初学者与中高级开发者的完整工程源码聚焦工件表面质量检测场景。系统按图像采集、预处理、特征提取、决策反馈和图形界面等模块组织展示相机取图、去噪增强、形状与模板匹配、缺陷判定及报警联动的实现路径适合用于课程实践、项目原型验证和二次开发参考。压缩包共245个文件、约45.48MB以80个C#源码文件为核心配有35张BMP测试图像、29个DLL与23个PDB依赖调试文件以及10个resx/resources界面资源、6个csproj工程文件、3个exe和sln解决方案等目录结构较完整便于直接打开工程梳理调用关系。已有7066人学习下载。读者可据此理解C#调用HALCON算子、视觉流程编排、检测结果展示与工程部署方式并借助测试图复现实验、定位问题积累可迁移的机器视觉系统开发经验。1. 一条外观检测线的真实取舍C# 与 HALCON 到底谁管哪一段某产线要做零件外观检测最初的想法很朴素用 C# 把相机采到的图读成 Bitmap自己写阈值、找轮廓、算尺寸。真跑到现场就卡住了——换一批来料光照差两档阈值全废亚像素定位没有测量值跳动比公差还大模板匹配要从头造轮子。后来改成 C# 写上位机、HALCON 做算法内核机器视觉里最费劲的那部分交给成熟算子库视觉检测系统里界面、流程、数据、报警、配方这些工程活留在 C# 里。这份 C# 与 HALCON 联合开发的机器视觉软件系统源代码就是按这个分工搭起来的完整视觉检测系统相机采集、模板定位、尺寸测量、缺陷判定、结果落盘、配方切换一条链走完。它适合正在做机器视觉方向毕设或课程设计的学生也适合要把一套能跑的 C# 视觉软件直接搬到自己设备上改的工程师。2. 需求拆解与选型把「能看见缺陷」翻译成节拍、精度和软件栈2.1 检测项怎么落成可量化的指标需求沟通里最容易翻车的一句话是「要能检出划伤」。这句话没法验收也没法写代码。负责的做法是先把它拆成四列测什么、用什么成像方式测、精度要到多少、判定阈值是多少。检测项一般分三类——尺寸类长度、直径、间距、角度、位置类装配偏移、缺件、错件、表面类划伤、脏污、毛刺、压痕。三类在算法上的实现路径完全不同尺寸类靠测量工具位置类靠模板匹配加区域比对表面类多半要靠 Blob 分析、频域滤波或者差异图。精度这一栏要用像素当量倒推不能拍脑袋。视场 40mm、相机 2448×2048像素当量约 0.016mm/pixelHALCON 的亚像素边缘通常能做到 1/4 像素以内折算下来重复性在 0.004mm 量级。所以一个标称 ±0.02mm 的尺寸项在这个配置下是有余量的要是公差要求 ±0.005mm那就该换远心镜头、提高分辨率或者上背光而不是指望算法硬扛。我一般会先算这笔账再谈选型省得后面相机都装好了才发现精度不够。检测项成像方式精度要求判定方式外形长宽背光、远心镜头±0.02mm卡尺工具测边缘对距离孔位偏移同轴光±0.03mm模板匹配定位后测圆心表面划伤低角度环形光最小 0.1mm×2mmBlob 面积长宽比筛选缺件/错件正面均匀光有无判断区域灰度均值与模板比对装配间隙侧向条形光±0.05mm测量矩形内双边缘间距节拍是另一条硬约束。单件 300ms 的产线一次曝光加传输大概吃掉 6080ms算法预算只剩 200ms 出头还得留出通讯和界面刷新的余量。所以算法流程要做成「先粗后精」先用降采样图像做快速定位把 ROI 缩到工件附近再做全分辨率的测量和判定。这套系统的流程编排就是按这个思路排的每个工具只在自己关心的 ROI 里跑不整图扫。2.2 C# 做上位机、HALCON 做算法核的分层依据有人会问HDevelop 也能拖界面为什么还要 C#答案是工程化。产线上的软件不只是跑算法它要连 PLC、要存追溯数据、要做用户权限、要支持十几个料号的配方切换、要能在客户现场远程看日志。这些事 HDevelop 做得吃力.NET 生态里是现成的。反过来纯 C# 加 OpenCVSharp 也能做视觉但形状模板匹配的抗遮挡能力、亚像素边缘的稳定性、标定工具链的完整度调起来的隐性成本很高。所以分工线画在这里C# 负责「壳」——界面、流程调度、多线程、数据库、通讯协议、配置管理、日志与报警HALCON 负责「眼」——图像预处理、模板匹配、边缘提取、测量、Blob 分析、标定换算。两边通过 HALCON 的 .NET 接口HObject / HTuple交接边界清晰。这条线画对了后面加检测项就是加一个工具类不用动主流程。分层还有个现实好处算法参数可以外置成配方工艺工程师改参数不用重新编译。这套系统里所有阈值、ROI 偏移、匹配分数下限、灰度上下限都放在配方文件里程序启动时加载切换料号时热更新。2.3 算子与相机选型的对照取舍选型时最常纠结的几组我把自己会怎么选列出来场景常见选择 A常见选择 B我一般选工件有旋转、部分遮挡NCC 灰度匹配形状模板匹配B对光照变化和遮挡更稳边缘位置测量手写梯度找极值measure_pos 测量工具B亚像素和抗噪现成表面缺陷提取固定阈值 Blob动态阈值 形态学B适应光照漂移大幅面高速采集USB3 面阵GigE 面阵看线长超过 5m 用 GigE精密尺寸普通 FA 镜头双远心镜头B视场内的放大倍率一致性更好相机接口这块GigE 的优点是线缆长、多相机组网方便缺点是延迟比 USB3 略高USB3 带宽足、延迟低但线长限制在 35m工业现场走线要提前规划。这套系统里采集层做了接口抽象换相机只改一个配置项算法层完全不用动——这也是分层带来的直接收益。提示选型阶段就把「精度、节拍、视场、景深」四个数写进需求文档后面所有争论都回到这四个数上比争论用哪个算子有效得多。3. 总体架构设计三层结构与六个模块的职责边界3.1 表现层、业务层、算法层的划分整套软件按三层切。表现层是 WinForm 或 WPF 的主界面负责实时图像显示、结果列表、参数编辑、报警提示它不碰任何 HALCON 算子只消费业务层给出来的结果对象。业务层是流程引擎和调度中心管着「取图 → 定位 → 测量 → 判定 → 存档 → 通讯」这条流水线同时管配方加载、权限校验、异常上报。算法层是 HALCON 的封装每个检测能力包装成一个工具类对外只暴露「输入图像 参数 → 输出测量值」这样的签名。这样切的好处是测试好做。算法层的每个工具可以单独拿一批离线图片跑回归业务层可以用假的图像源做流程测试界面层改动不影响算法正确性。做毕设答辩时这一点特别加分——老师问「你怎么验证算法是对的」你能拿出分层测试的记录比说「我跑了一遍看着没问题」有说服力得多。六个模块分别是设备接入相机、光源、PLC/IO、图像预处理、定位与测量、判定与分类、数据与追溯、配方与权限。每个模块内部的类只依赖下一层的接口不允许跨层直接调。比如判定模块不能自己去读相机它只接收测量模块的结果数组。3.2 图像从相机到算法再到数据库的流转通路高节拍下最容易出问题的是图像流转。做法是采集与处理分离相机回调线程只做一件事——把 HObject 塞进一个有界队列然后立刻返回绝不在回调里跑算法。算法线程从队列里取图处理处理完把结果对象推到结果队列界面线程和存盘线程各自消费。队列要有界满了就丢最旧的一帧并记一条丢帧日志避免内存无限堆积。// 采集线程与算法线程之间的有界缓冲容量按节拍和算法耗时估算 private readonly BlockingCollectionHObject _imageQueue new BlockingCollectionHObject(8); // 相机回调只负责入队禁止在这里做任何耗时运算 private void OnImageGrabbed(HObject image) { HObject copy; HOperatorSet.CopyImage(image, out copy); // 回调缓冲会被复用必须拷贝 if (!_imageQueue.TryAdd(copy)) { // 队列满说明算法跟不上节拍丢弃并计数事后看日志定位瓶颈 copy.Dispose(); Interlocked.Increment(ref _dropCount); } } // 算法线程主循环 private void ProcessLoop() { foreach (var img in _imageQueue.GetConsumingEnumerable(_cts.Token)) { using (img) { var result _pipeline.Run(img); // 内部依次调用各工具 _resultQueue.Add(result); } } }这里的关键点是CopyImage。很多相机 SDK 的回调缓冲区是复用的你把引用直接传出去下一帧到来时图像内容就被覆盖了现象是「偶尔检测到上一件的缺陷」这种问题查起来极其折磨。拷贝一次的代价远小于排查成本。队列容量 8 是按「算法单帧 80ms、节拍 300ms」估的实际项目里按实测的算法耗时乘 23 倍来定太大反而掩盖性能问题。3.3 模块之间的接口约定与异常传递工具层统一接口是为了让流程配置化。每个检测工具实现同一个契约流程引擎按配方里配置的顺序依次执行public interface IVisionTool { string Name { get; } // 工具标识配方里按名字引用 ToolResult Execute(HObject image, JObject param); // param 来自配方文件的节点 } public class ToolResult { public bool Success { get; set; } // 算法是否正常执行完 public int ErrorCode { get; set; } // 非 0 表示执行失败界面按码查提示 public double[] Values { get; set; } // 测量值数组单位统一为毫米 public bool IsOk { get; set; } // 判定结论与 Success 分开 public string DefectCode { get; set; } // NG 时的缺陷编码用于统计 }Success和IsOk必须分开。算法没跑通找不到模板、图像过曝、边缘数量不对是执行异常产品合格与否是判定结论两者混在一起会导致「算法失败被当成 NG 品流出去」这在追溯时是灾难。执行异常要走独立的报警通道让设备停下来等人处理而不是默默计数。结果落盘用一张主表加一张明细表就够了主表存单件结论明细存每个测量项的值方便后面按项做趋势分析CREATE TABLE InspectionRecord ( Id INTEGER PRIMARY KEY AUTOINCREMENT, Sn TEXT NOT NULL, -- 产品条码/流水号 RecipeCode TEXT NOT NULL, -- 料号用于分料号统计 Result INTEGER NOT NULL, -- 1OK, 0NG DefectCode TEXT, -- NG 缺陷编码OK 时为空 ImagePath TEXT, -- NG 图像存档路径 CreateTime TEXT NOT NULL ); CREATE INDEX idx_record_sn ON InspectionRecord(Sn); CREATE INDEX idx_record_time ON InspectionRecord(CreateTime); CREATE TABLE MeasureDetail ( Id INTEGER PRIMARY KEY AUTOINCREMENT, RecordId INTEGER NOT NULL, ItemName TEXT NOT NULL, -- 测量项名称与配方节点对应 Value REAL NOT NULL, LowerLimit REAL, UpperLimit REAL, IsOk INTEGER NOT NULL );索引这两条不是凑数。按 Sn 查是为了追溯按时间查是为了做日报和趋势图产线上这两个查询是每天都跑的。明细表拆出来是因为一个工件可能有十几二十个测量项塞进主表的 JSON 字段里查起来费劲做 SPC 分析时更难受。4. 核心模块实现采集、定位、测量、判级四段代码落地4.1 相机接入与 HObject 的生命周期相机接入层要做三件事打开设备、配置参数、稳定取图。HALCON 用open_framegrabber统一封装各家接口参数随接口类型不同而不同具体字段要按相机厂商的接口文档对齐不能照抄。public class CameraDevice : IDisposable { private HTuple _acqHandle null; private readonly object _lock new object(); public void Open(string interfaceName, string deviceId) { // 参数顺序固定含义依次为接口名、水平/垂直分辨率、起始位置、 // 图像宽高、场序、位深、色彩空间、泛型参数、外部触发、相机类型、设备标识 HOperatorSet.OpenFramegrabber( interfaceName, 0, 0, 0, 0, 0, 0, progressive, -1, default, -1, false, default, deviceId, -1, -1, out _acqHandle); // 关掉自动曝光和自动增益产线上这两个必须锁死否则测量值会漂 HOperatorSet.SetFramegrabberParam(_acqHandle, ExposureTime, 8000); HOperatorSet.SetFramegrabberParam(_acqHandle, Gain, 0); } public HObject GrabOnce(int timeoutMs) { lock (_lock) // 同一句柄不能并发调用加锁是最省事的做法 { HOperatorSet.GrabImageAsync(out HObject image, _acqHandle, timeoutMs); return image; } } public void Dispose() { if (_acqHandle ! null) { HOperatorSet.CloseFramegrabber(_acqHandle); _acqHandle null; } } }自动曝光这一条值得单独说。调试时开着自动曝光画面好看上线后光源老化、环境光变化相机会自己调增益灰度整体漂移阈值型检测项集体失效。血泪经验是调试阶段就用固定曝光固定增益把光源亮度调到能拿到稳定灰度的位置之后不再动它。真要适应不同料号的反光差异靠配方里的曝光参数切换不靠相机自动。HObject 是托管包装的非托管资源必须显式释放。用using或者 try/finally 里的Dispose()不能指望 GC。这一点在第 5 章展开。4.2 形状模板匹配与亚像素定位定位是整个流程的地基定位偏了后面所有测量都偏。做法分两步建模阶段从一张标准件图像里抠出特征明显的区域生成形状模板运行阶段用模板在当前图里找位姿。// 建模在一张合格品图像上框出特征区生成形状模板 public HTuple CreateTemplate(HObject image, double row1, double col1, double row2, double col2) { HOperatorSet.GenRectangle1(out HObject roi, row1, col1, row2, col2); HOperatorSet.ReduceDomain(image, roi, out HObject domain); roi.Dispose(); // 角度范围 -0.39~0.39 rad约 ±22.5°覆盖来料旋转 // 金字塔层数、对比度、最小对比度都交给 auto让算子按图像自选 HOperatorSet.CreateShapeModel( domain, auto, -0.39, 0.79, auto, auto, use_polarity, auto, auto, out HTuple modelId); domain.Dispose(); return modelId; } // 运行在当前图中查找返回行、列、角度、得分 public bool Find(HTuple modelId, HObject image, out double row, out double col, out double angle) { HOperatorSet.FindShapeModel( image, modelId, -0.39, 0.79, 0.7, // 最小得分低于它认为没找到 1, // 最多找几个匹配单件检测取 1 0.5, // 重叠度 least_squares, // 亚像素模式精度最高的那一档 0, // 金字塔层数0 表示用建模时的设置 0.9, // 贪婪度越大越快越可能漏 out HTuple r, out HTuple c, out HTuple a, out HTuple score); row r.Length 0 ? r.D.ToArray()[0] : 0; col c.Length 0 ? c.D.ToArray()[0] : 0; angle a.Length 0 ? a.D.ToArray()[0] : 0; return score.Length 0 score.D[0] 0.7; }参数里最需要现场调的是MinScore和Greediness。MinScore 定太低0.5 以下会把相似结构误认成目标定太高0.85 以上则在来料表面有轻微脏污时找不到。经验值是先设 0.7拿一批包含边界样本的图跑看得分分布取一个能把 OK 品和误匹配分开的阈值。Greediness 默认 0.9如果发现偶尔漏检先往 0.8 降一档试试速度会慢一些但更稳。建模区域的选择也有讲究不要选大面积的均匀区域那种区域没有梯度信息模板会退化成靠边缘支撑抗噪能力差要选带角点、圆孔、缺口这类强特征的位置。模板图像尽量用实际产线的相机和光源拍别拿实验室的样品图凑合光学条件不一样模板的对比度参数就不对了。4.3 测量与判级从像素值到 OK/NG 结论有了位姿测量就好办了。思路是把模板坐标系里定义好的测量位置通过刚性变换映射到当前图像的实际位置再用测量工具在映射后的位置取边缘。这样来料有平移旋转也不影响。// 模板坐标系下的基准点与测量矩形参数建模时在标准件上确定 private const double TplRow 512.0; private const double TplCol 640.0; private const double TplAngle 0.0; public double MeasureGap(HObject image, double mRow, double mCol, double mAngle, JObject param) { // 1. 用匹配位姿构造模板坐标 - 当前图像坐标的刚性变换 HOperatorSet.VectorAngleToRigid(TplRow, TplCol, TplAngle, mRow, mCol, mAngle, out HTuple homMat2D); // 2. 把模板里定义好的测量中心映射过去测量框跟着工件一起转 HOperatorSet.AffineTransPoint2d(homMat2D, TplRow, TplCol - 80, out HTuple row, out HTuple col); HTuple phi TplAngle mAngle; // 3. 生成测量矩形长 60 宽 12方向沿工件边插值选双线性 HOperatorSet.GenMeasureRectangle2(row, col, phi, 30, 6, 60, 12, bilinear, out HTuple handle); // 4. 在矩形内找边缘对sigma1.0 抑制噪声threshold30 控制灵敏度 HOperatorSet.MeasurePos(image, handle, 1.0, 30, all, all, out HTuple edgeRow1, out HTuple edgeCol1, out HTuple amp1, out HTuple edgeRow2, out HTuple edgeCol2, out HTuple amp2, out HTuple intraDist, out HTuple interDist); HOperatorSet.CloseMeasure(handle); if (intraDist.Length 1) throw new VisionException(1001, 测量框内未找到成对边缘检查光照或测量框位置); // interDist 是相邻边缘间距像素乘像素当量换成毫米 double pixelScale param.Valuedouble(PixelScale); // 由标定得到如 0.0163 return interDist.D[0] * pixelScale; }Sigma和Threshold这两个参数是测量的手感所在。Sigma 是高斯平滑的系数来料表面粗糙、图像噪点大就调大到 1.52.0代价是边缘位置会被轻微模糊精度略降图像干净就保持 1.0 甚至 0.8。Threshold 是边缘幅度阈值它决定什么算作边缘——太低会把噪点当边缘太高会漏掉对比度弱的真实边缘。稳妥的做法是打开边缘幅度输出看一批图的幅度分布把阈值定在噪声幅度和真实边缘幅度之间。判级就是拿测量值和配方里的上下限比public (bool ok, string defectCode) Judge(double value, JObject param) { double lower param.Valuedouble(LowerLimit); double upper param.Valuedouble(UpperLimit); double tol param.Valuedouble(JudgeTolerance); // 判定死区默认 0 // 死区的作用刚好卡在边界上的值做二次确认避免 OK/NG 反复横跳 if (value lower - tol) return (false, param.Valuestring(DefectCodeLow)); if (value upper tol) return (false, param.Valuestring(DefectCodeHigh)); return (true, null); }判定死区这个小设计在批量生产时很关键。没有它的时候一个值在上下限附近抖同一个工件可能这次 OK 下次 NG操作员会怀疑设备有问题。加了死区之后边界附近的值统一往宽松方向靠配合趋势图看反而更容易发现工艺漂移。NG 图像一定要存。存图策略按「日期 / 料号 / 时间戳_缺陷码」的目录结构落盘保留最近 30 天超期自动清理。这张图在后续分析缺陷成因、和供应商扯皮的时候是唯一的证据链。4.4 配方管理换料号不改代码配方是这套系统里最能体现工程成熟度的部分。十几个料号每个料号的 ROI、阈值、模板、上下限都不同如果写死在代码里每换一次料就要改代码重新发版现场根本没法用。配方的组织方式是一棵 JSON 树根节点是料号下面是工具链数组每个工具节点带自己的参数{ RecipeCode: P-1024, PixelScale: 0.0163, Tools: [ { Name: Locate, Type: ShapeMatch, TemplateFile: tpl_1024.shm, MinScore: 0.72, AngleStart: -0.39, AngleExtent: 0.79 }, { Name: GapA, Type: MeasurePair, RefRow: 512, RefCol: 560, LowerLimit: 1.98, UpperLimit: 2.06, JudgeTolerance: 0.005, DefectCodeLow: GAP_SMALL, DefectCodeHigh: GAP_LARGE }, { Name: Scratch, Type: BlobDefect, MinArea: 120, MaxAspect: 8.0, GrayLow: 40, DefectCode: SCRATCH } ] }流程引擎按Tools数组顺序执行遇到Locate就把位姿写进上下文后面的测量工具从上下文里取。新增一个检测项只是在数组里加一个节点代码零改动。配方的加载和热切换要注意两点一是切换时必须在流程空闲的间隙做不能在一件工件处理到一半时换参数二是每次切换记一条日志包含料号、操作人、时间出问题时能对上是哪次切换引入的偏差。注意配方文件建议加版本号和校验值现场出现过配置文件被人手工改坏、程序启动直接崩的情况加个校验能提前拦住。5. 避坑与常见问题排查内存、线程、标定三处最容易翻车的地方5.1 内存只涨不落现象程序跑两三个小时内存从 200MB 涨到 2GB最后卡死或者被系统杀掉。原因几乎都是 HObject 没释放。HALCON 的图像和区域对象底层是非托管内存C# 的 GC 只回收包装对象不会主动去释放底层句柄峰值节拍下对象创建速度远超终结器回收速度句柄就堆起来了。解决方法是所有 HObject 都走using或者在方法末尾显式Dispose()尤其注意异常分支——try 块里创建了对象catch 里直接 return那个对象就漏了。// 反面写法异常一抛img 和 region 都不会被释放 HObject img; HOperatorSet.ReadImage(out img, path); HObject region; HOperatorSet.Threshold(img, out region, 0, 128); DoSomething(region); // 若这里抛异常上面两个对象泄漏 // 正确写法用 using 包住无论走哪条分支都释放 using (HObject img new HObject()) using (HObject region new HObject()) { HOperatorSet.ReadImage(out img, path); HOperatorSet.Threshold(img, out region, 0, 128); DoSomething(region); }排查手段任务管理器看句柄数比看内存更准句柄只涨不落就是泄漏。也可以在每个流程节点前后打一条get_system(handle_count)的日志几个循环就能定位到是哪个工具漏了。5.2 多线程下的偶发崩溃现象单线程跑一天没事改成多线程后随机崩报的是访问冲突或者算子内部错误日志里看不出规律。原因是 HALCON 的 HTuple 和 HObject 不是线程安全的两个线程同时操作同一个对象或者在 A 线程创建、B 线程释放都可能出问题。解法是「谁创建谁释放跨线程只传值不传引用」算法线程处理完把测量值double 数组和结果码传出去不要把 HObject 传来传去确实要传图像就在目标线程里CopyImage一份。另外 HALCON 的算子在内部已经做了并行外层再开一堆线程抢 CPU 反而是负优化算法线程一般开 12 个就够。5.3 标定与像素当量换算翻车现象测量值整体偏大或偏小百分之几重复性很好但准确度不对。原因多半在像素当量上。像素当量不是拿标称视场除分辨率算出来的那个值忽略了镜头畸变和实际放大倍率偏差。正确做法是拿一块标准量块或者标定板在同一工作距离下拍图量出已知长度对应的像素数两者相除。更严谨的做法是做多点标定把镜头畸变一起拟合掉视场边缘的测量值才不会系统性偏大。还有个容易忽略的点更换镜头、调整工作距离、甚至相机被撞了一下像素当量都要重新标。我见过一个项目调试时标定过后来调焦换了镜头没重标整批产品尺寸超差却判 OK流到客户那边才发现。现在我的习惯是每次动过光学系统就在配方里改标定日期并在开机自检里加一条「标定有效期提醒」。5.4 触发时序错位与丢帧现象检测结果和产品对不上号或者偶尔漏检一件。这类问题多半在触发链路上。相机是硬触发还是软触发、PLC 给信号到相机曝光的延迟多少、编码器分频对不对、光源频闪和曝光是否同步任何一环错位都会导致「拍到了相邻的一件」。排查方法是拿一张带标记的样件连续跑 100 件把每件的图像和条码一一对应看错位会立刻暴露。修复上硬触发优先于软触发触发信号走光耦隔离别用普通 IO 直连曝光时间和光源延时要在配方里成组配置不能分开调。5.5 部署环境缺运行库现象开发机上跑得好好的拷到产线电脑上双击就报错或者一打开相机就崩。原因是目标机缺 HALCON 运行时或者 .NET 运行时版本不匹配也可能是相机厂商的驱动没装、网卡巨帧没开。部署前要列一张环境清单.NET 运行时版本、HALCON 运行库位数32/64 位必须和主程序一致、相机驱动版本、网卡巨帧和中断亲和性设置、系统电源计划改成高性能别让 CPU 降频。这张清单每次部署都过一遍比现场抓瞎强。6. 验收与答辩用一组可复现的数据证明系统「测得准、跑得稳」验收这一步很多人栽在「我说它准」上。合格的做法是拿数据说话而且数据要可复现。我一般准备三组测试准确性测试、重复性测试、稳定性测试。准确性用标准件。拿 10 件已知尺寸的标准件或者三坐标测过的样件每件测 10 次算每个测量项的平均值和标准值的偏差。偏差要小于公差的三分之一超了就得回去查标定或者算法。重复性用同一件产品连续测 30 次算标准差这个数反映的是系统自身的抖动一般要求小于公差的十分之一。稳定性是连续跑 48 小时统计总检数、误检数、漏检数、算法异常次数同时记录内存和句柄曲线。验收项指标测试方法记录内容测量准确性偏差 ≤ 公差/310 件标准件 × 10 次均值、偏差、最大值重复性标准差 ≤ 公差/10同件连续 30 次标准差、极差检出率≥ 99.5%200 件含已知缺陷样本漏检数、漏检类型误检率≤ 0.5%200 件合格品误检数、误检原因节拍≤ 设计值连续 500 件计时平均、P95、最大值长时间稳定性8 小时无异常连续运行内存曲线、异常次数节拍统计最好在程序里内建别拿秒表掐// 每个流程节点前后打点落库后直接出 P95 报表 var sw Stopwatch.StartNew(); var result _pipeline.Run(image); sw.Stop(); _repo.SaveTiming(result.Sn, result.RecipeCode, sw.Elapsed.TotalMilliseconds);答辩时的讲法我的建议是倒过来讲先讲误检漏检的数据和你是怎么把这两个数压下去的再讲架构和代码。老师最想听的不是「我用了什么技术」而是「你怎么知道它是对的」。你可以拿出那张 200 件样本的混淆矩阵讲某一类缺陷一开始漏检率 8%查下来是 Blob 面积下限设太大把下限从 200 调到 120 之后降到 0.5%——这种带数字的调试过程比任何架构图都有说服力。还有一个常被问到的点如果换个料号怎么办。这时候现场演示配方切换30 秒内完成切换后连续跑 20 件全部正确这一下就把「课程作业」和「能交付的系统」区分开了。从那以后我每次做完一套视觉系统验收前都强制走一遍「标准件 重复性 8 小时连续跑」这三关哪怕时间再紧也不跳。跳过一次后面在现场补的功夫是省下来那点时间的好几倍。希望这套结构和记录方法能帮到你需要对照完整实现的话仓库里的源代码可以直接拿去做参考。本文还有配套的精品资源点击获取
