准备OCR模型 - OcrPrepareModels

函数简介

按 JSON 批量准备 OCR 模型：加载内置/文件/内存包、写配置、可选预热与激活。适合脚本一次性把模型就绪，再进入识别循环。

接口名称

OcrPrepareModels

DLL 调用

long OcrPrepareModels(long ola, string prepareJson);

参数说明

参数名	类型	说明
ola	长整数型	OLAPlug 对象指针。
prepareJson	字符串	UTF-8 JSON 对象，含 Models 数组。

Models 元素常用字段

字段	说明
Source	builtin / file / memory
ModelHandle	内置为 0
PackagePath / Password	文件源加密包
Config	推理配置对象，字段同 OCR模型配置说明
Warmup	true 时对该模型执行热身
Iterations	热身次数
Activate	true 时设为当前 active 模型并做 activation prime

示例

{
  "Models": [
    {
      "Source": "builtin",
      "ModelHandle": 0,
      "Warmup": true,
      "Iterations": 1,
      "Activate": true
    }
  ]
}

返回值

JSON 字符串指针，须 FreeStringPtr。Success=false 表示至少一个模型准备失败；Models 含逐项 State / 诊断。

Activate=true 的内部 activation prime 不计入 OcrWarmupModel 的 Warmup.Runs。

注意事项

创建欧拉对象不会调用本接口。需要不挡主流程时，请用 OcrWarmupModel 的 async=1。