OCR 模型配置说明

OCR Ex 系列与 OcrSetModelConfig / OcrGetModelConfig 使用按 模型句柄 维度的推理调参（与全局 SetOcrConfig 不同）。

概念	说明
`modelHandle = 0`	内置 PP-OCR mobile 模型，无需 OcrLoadModel
`modelHandle > 0`	OcrLoadModel / OcrLoadModelMemory 返回值
OCR 加密包魔数	OLAOENC1
YOLO 加密包魔数	OLAYENC1（见 YOLO 模块）

configJson 字段（Set / Get 共用）

Set 时未出现的键保持不变。Get 成功时另含 Success、ModelHandle、BackendId 及只读项 OcrEnableMkldnn、OcrUseAngleCls、OcrPrecision。

字段 (PascalCase)	snake_case	类型	说明	默认
OcrLimitSideLen	limit_side_len	int	检测前缩放目标边长（像素）	960
OcrDetDbThresh	det_db_thresh	double	DB 二值化阈值，建议 0~1	0.3
OcrDetDbBoxThresh	det_db_box_thresh	double	DB 框置信度阈值	0.6
OcrDetDbUnclipRatio	det_db_unclip_ratio	double	DB 框扩张比例	1.5
OcrRecImgH	rec_img_h	int	识别裁剪行高（像素）	48
OcrRecImgW	rec_img_w	int	识别输入宽度上限	320
OcrCpuThreads	cpu_threads	int	CPU 推理线程数（ncnn）	8
OcrUseGpu	use_gpu	bool	是否启用 GPU（ncnn Vulkan）	内置首次尝试 true
OcrGpuId	gpu_id	int	Vulkan GPU 索引，仅 use_gpu=true	0

Runtime 对象

Runtime / runtime 可包含 Common、Ncnn、PaddleInference、PaddleInferenceDll 等子对象（FastCache、RegionCache、RuntimeDir 等，详见插件头文件注释）。

Get 成功示例

{
  "Success": true,
  "ModelHandle": 1001,
  "OcrLimitSideLen": 960,
  "OcrDetDbThresh": 0.3,
  "OcrDetDbBoxThresh": 0.6,
  "OcrDetDbUnclipRatio": 1.5,
  "OcrRecImgH": 48,
  "OcrRecImgW": 320,
  "OcrCpuThreads": 8,
  "OcrUseGpu": true,
  "OcrGpuId": 0,
  "BackendId": "ncnn"
}

与旧接口关系

旧接口	新接口
`Ocr`（无模型句柄）	`OcrEx(..., modelHandle)`，`modelHandle=0` 为内置 mobile
`OcrDetails`	`OcrDetailsEx`
`OcrV5` / `OcrV5Details` 等（已移除）	`OcrEx` / `OcrDetailsEx` 等
全局 `SetOcrConfig`	按句柄的 `OcrSetModelConfig`

OCR 模型配置说明

推荐流程

configJson 字段（Set / Get 共用）

Runtime 对象

Get 成功示例

与旧接口关系