工业读码是什么问题，用在哪些工况
消费场景的码印在纸上，高对比度、正对、静止。工业场合常见的是 激光打标在金属或塑胶表面（无颜色差，靠微观形貌成像）、 点阵喷码、直接部件标识 DPM， 以及起翘、褶皱、被油污覆盖的标签。用途主要是追溯与防错， 读不出来就意味着流程中断。 敏洽 机器视觉检测软件 内置条码与二维码识别，支持一维码与 DataMatrix、QR； 有刻印字符时配合 OCR（PaddleOCR 引擎）。
实际会遇到的几个坑
1. 低对比度：先改打光，不是先换解码器
激光打在不锈钢或铝件上的码，明暗来自表面微观形貌，不是颜色差， 环形光正打会一片反光。有效手段是利用形貌差异： 低角度掠射让粗糙区散射、光滑区不反射，或用暗场。 深色阳极氧化件有时要反向思路——同轴光让平滑基面全亮、刻痕区变暗。
2. 分辨率不够，模块只占一两个像素
每个最小模块要有足够像素数，经验上不少于三到四个，低质量码更多。 常见错误是为兼顾大视野把码拍得很小，解码本质上不可能。 应按最小模块尺寸反推分辨率与视野再选相机镜头； 一个视野兼顾不了就分工位或加一路读码相机。
3. 遮挡：纠错能力不能当设计余量
DataMatrix 与 QR 都有纠错，但定位结构不受纠错保护—— DataMatrix 的 L 形定位边与交替边界、QR 的定位图形与定时图形， 是解码器找码并建立网格的前提，被油污或划伤盖住整个码就找不到。 某个位置总被夹具压到，就改打码位置或读码角度。
4. 变形：曲面与倾斜的处理不同
倾斜的透视变形好办：解码器的透视校正通常能处理， 不行就调相机角度或用图像校正算子对齐。 曲面的非线性变形麻烦：圆柱面上模块间距沿弧长被压缩， 压缩率随位置变化，规则栅格不存在了。手段有取曲率小的中间一段、 用远心或长焦减小透视、多角度取能读通的一张、或做柱面展开校正。
5. 运动模糊与触发时机
曝光期内工件位移超过一个模块尺寸，模块边界就被抹平。 对策是缩短曝光并用频闪光源补亮度，同时用触发保证每次拍照落在同一相位。 敏洽软件支持硬件 IO、编码器、通讯软触发、连续采集四种， 运动读码优先编码器位置触发，并允许同一件多次重拍。
6. 读不出来的处理流程没定
读不出来之后是停线报警、打「无码」标记继续走、还是自动剔除？ 这影响追溯体系的完整性，必须在方案阶段定清楚并写进接口文档。 同时要设计人工补录通道，补录数据与自动读到的要区分开。 失败图片必须留存。
方案与硬件条件
| 问题类型 | 主要手段 | 注意事项 |
|---|---|---|
| 低对比度（金属码） | 低角度掠射或暗场；必要时同轴光反向利用 | 先看放大图能否分清模块 |
| 低对比度（膜下 / 油污） | 交叉偏振压反光；特定波长照明 | 偏振有光损，需补光 |
| 模块像素不足 | 按最小模块反推分辨率与视野；必要时单设读码相机 | 每模块不少于 3~4 像素 |
| 部分遮挡 | 保证定位结构清洁完整；调整视角避开遮挡物 | 纠错留给意外 |
| 倾斜变形 | 图像校正对齐 + 解码器透视校正 | 相对容易 |
| 曲面变形 | 取小段视野、远心 / 长焦、多角度拍摄、柱面展开 | 曲率过大时改打码位置 |
| 运动模糊 | 短曝光 + 频闪；编码器位置触发；允许重拍 | 曝光内位移不超一个模块 |
| 字符与码并存 | 条码二维码识别 + OCR（PaddleOCR）双路校验 | 不一致时报警 |
| 项目 | 要求与说明 |
|---|---|
| 码制支持 | 一维码与 DataMatrix、QR；支持低对比度与部分遮挡 |
| 相机 | USB/UVC、大华、海康、度申已适配；Mock 虚拟相机可用失败图片离线复现 |
| 触发 | 硬件 IO、编码器、通讯软触发、连续采集；运动读码优先编码器 |
| 工位并发 | 单机 4 工位并发，可同时承担读码与其他检测 |
| 结果输出 | C++ 侧输出解码内容与原始数据，是否与工单匹配由 C# 侧判定 |
| 失败留存 | 失败图片必须留存，用于分析是打码质量还是成像问题 |
| 运行环境 | Qt 6.9.2 + C++17 + OpenCV 4.x + ONNX Runtime；Windows 10/11 x64 与 Ubuntu 22.04 x64 |
| 客户准备 | 真实带码样品（含质量差的）、打码工艺参数、失败处理流程定义 |
要来的样品必须包含质量差的那批。 只用打得最好的样品定方案，上线后遇到批次波动就会大面积失败。
相关交付情况
交付顺序：先拿真实样品试拍，按几种打光各拍一组看能否稳定成像； 再确认分辨率与视野满足最小模块的像素要求；然后才是软件实现与失败流程。 某类样品在任何打光下都读不出，结论应反馈到打码工艺环节。
交付包括成像方案、硬件选型建议清单、读码软件与配方管理、失败图片与结果留存、
接口文档（触发方式、IO 定义、通讯点表、解码结果格式、失败处理约定）。
算法按模块授权；已有上位机的客户可只要跨语言 SDK
（mqvision.dll / libmqvision.so，
支持 C、C++、C#、Java JNI、Python，另有 Qt-free 版本）。
常见问题
有具体设备清单或工件样品，可以直接给判断
提供设备型号、PLC 品牌与需要采集的数据项，或提供被检工件照片与精度要求，敏洽可先给出可行性判断与硬件前置条件，再谈软件工作量与报价。