04 OCR 识别

OCR 和点阵 OCR 都必须指定识别范围。切换到普通 OCR 时，界面会自动加入识别模型、匹配阈值和识别范围；点阵 OCR 的参数需从 + 菜单添加。

OCR

OCR 使用应用发现到的公共模型读取自然文字，并可用期望文本或正则表达式确认命中。

图中展示期望文本、公开模型、阈值和固定识别范围组成的 OCR 配置。

参数	格式	默认/空值	必填与显示	运行影响与示例
期望文本	文本/正则列表	留空表示不限制	可选；OCR 时可添加	任一表达式命中即成功；例如`^开始`。留空返回阈值内全部文字
识别模型	下拉选择	`ppocr_v6/small`，界面显示 PP-OCRv6 Small（中英日多语种）	必填；切换到 OCR 自动显示	也可选择 PP-OCRv6 Tiny（中英多语种）；保存模型相对路径，模型不可用时会标记并阻止真实运行
匹配阈值	`0..1` 数字	`0.3`	可选；切换到 OCR 自动显示	过滤低可信文字，越高越严格
识别范围	`x1,y1,x2,y2` 或引用	无；空值校验失败	必填；切换到 OCR 自动显示	指定读取区域，例如`100,100,500,220`
范围偏移	`w1,h1,w2,h2`	不偏移	可选	调整识别范围四边

Small 是默认模型，支持中、英、日文字；Tiny 体积更小，支持中、英文字。模型下拉框只展示可用模型。项目中保存的旧模型路径若已不可用，会保留该值并显示“不可用”，不会被静默替换。切换模型后应重新测试识别结果。空期望文本不会导出限制条件，因此 OCR 以任一达到阈值的候选作为命中。

点阵 OCR 使用项目中的 .ddwf 字库识别规则点阵文字。

参数	格式	默认/空值	必填与显示	运行影响与示例
颜色	`RRGGBB` 或 `RRGGBB-TTRRGGBB`，多色用 `	`	空；空值校验失败	必填；点阵 OCR 时可添加
字库	项目字库相对路径	空；空值校验失败	必填	加载项目资源，例如`default.ddwf`
匹配阈值	`0..1` 数字	`0.8`	可选	控制字形相似度
分割行数	正整数	`1`	可选	把识别区域分为指定行数，例如`2`
分割列数	正整数	`1`	可选	把识别区域分为指定列数，例如`8`
读取方向	下拉选择	左到右	可选	可选左到右、右到左、上到下、下到上
目标文本	文本	空表示识别全部	可选	填写时查找连续文本，例如`开始`
识别范围	`x1,y1,x2,y2` 或引用	无；空值校验失败	必填	限定点阵文字区域