文本检测（Text / OCR · OCV）

此页面的用途

识别并校验检测框内文本（丝印、字符、批次 / 日期等），同时支持 OCR（识别字符内容）与 OCV（与参考图像比对）两种方式。

如何进入

模板编辑器中绘制对应 ROI 后，在参数面板中配置该工具的参数。

操作流程

用途：识别并校验检测框内文本（丝印、字符、批次 / 日期等）。检测框上的三角箭头表示文本阅读方向，应与实际字符方向一致。同时支持 OCR（识别字符内容）与 OCV（与参考图像比对）两种方式。

文本工具参数

参数说明

  • 期望文本（Expected Text）/ 期望文本 (反向)（Expected Text Reverse）：目标字符串；反向用于 180° 方向。

  • 启用 OCR（Enable OCR）：识别检测框内字符内容并与期望文本比对。

  • 启用 OCV（Enable OCV）：将检测框与 OCV 参考（OCV References） 图像比对，输出 OCV 最佳匹配分数（OCV Best Match Score）。

  • OCV 接受阈值（OCV Acceptance Threshold）：提高阈值可降低漏报（false negative）。

  • OCR/OCV 通过条件（Pass Condition）：可选 OCR 与 OCV 均须通过 或 OCR 或 OCV 任一通过。

  • 最大不匹配字符数（Max Mismatch Count）：与期望文本比较时允许的最大不匹配字符数（仅当识别与参考长度相同时才显示不匹配计数）。

  • 模糊模式（Blur Mode）：启用后形状相似的字符（如 1 / l）视为正确，可通过反馈加入模糊表。

  • 双向检测（Bidirectional Inspection）：进行 0° / 180° 两次识别，任一方向匹配即判 OK。

  • 启用旋转（Enable Rotation）/ 自动搜索文本位置（Auto search text location）：当文本在框内位置有偏移时，加强搜索以提升识别稳定性。

常见问题与提示

小技巧

  • OCR vs OCV 怎么选：OCR 识别具体字符内容（需要验证字符是什么），OCV 仅验证字符外观与参考是否一致（不识别具体内容）。普通情况下 OCR 更稳定、误报更少；字符模糊或字体特殊时优先用 OCV。

  • OCR 检测框画多大：建议比文字宽约 20% 左右 即可，过大容易识别到框外文字。

  • 白底黑字 / 黄底黑字识别失败：当前部分背景色组合 OCR 模型支持有限，可关闭 OCR、改用 OCV 比对字符外观。

  • 手动添加的文本检测框识别不出：先确认字符方向与 OCR 框内方向一致，必要时启用 双向检测 / 启用旋转 选项。