从字库中识别文字 - OcrFromDictDetails

函数简介

从字库中识别指定区域的文字并返回详细信息，需提前加载数据库。x1、y1、x2、y2 传 0, 0, 0, 0 为窗口整个客户区。支持多个字库同时识别，多个字库用 | 分割，如 dict1|dict2。

接口名称

OcrFromDictDetails

DLL调用

long OcrFromDictDetails(long instance, int x1, int y1, int x2, int y2, string colorJson, string dict_name, double matchVal);

参数说明

参数名类型说明
instance长整数型OLAPlug对象的指针，由 CreateCOLAPlugInterFace 接口生成。
x1整数型左上角x坐标
y1整数型左上角y坐标
x2整数型右下角x坐标
y2整数型右下角y坐标
colorJson字符串颜色模型配置字符串，用于限定图像匹配中的颜色范围，格式说明见 颜色模型说明 - ColorModel。JSON格式示例：[{"StartColor":"3278FA","EndColor":"6496FF","Type":0}]；简化格式示例：`3278FA-000000
dict_name字符串字库名称，为空时搜索所有字库，也可以传入字库文件如 dict.txt
matchVal双精度浮点数匹配值

示例

C++
long instance = CreateCOLAPlugInterFace();
BindWindow(instance, hwnd, 0, 0, 0);
// 从字库"mydict"中识别窗口全区域文字并返回详细信息
long resultPtr = OcrFromDictDetails(instance, 0, 0, 0, 0, "FFFFFF-101010", "mydict", 0.85);
char* json = GetStringFromPtr(instance, resultPtr);
FreeStringPtr(instance, resultPtr);

返回值

字符串指针地址，返回识别到的JSON字符串，如：

{
    "Regions": [
        {
            "Score": 0,
            "Text": "bbbbbb",
            "Center": { "x": 100, "y": 200 },
            "Vertices": [
                { "x": 75, "y": 190 },
                { "x": 125, "y": 190 },
                { "x": 125, "y": 210 },
                { "x": 75, "y": 210 }
            ],
            "Angle": 0
        }
    ],
    "Text": "bbbbbb"
}
字段名类型说明
Regions数组Regions 结果列表，详见下方字段说明。
Text字符串识别文本。

Regions 元素字段说明：

字段名类型说明
Score整数识别置信度分值。
Text字符串识别文本。
Center对象中心点坐标对象。
Vertices数组顶点坐标集合。
Angle整数角度值。

Regions[].Center 字段说明：

字段名类型说明
x整数X 坐标。
y整数Y 坐标。

Regions[].Vertices 元素字段说明：

字段名类型说明
x整数X 坐标。
y整数Y 坐标。
  • Regions：所有识别到的数据集
  • Score：识别评分，分值越高越准确
  • Center：识别结果中心点
  • Vertices：识别结果的4个顶点
  • Angle：识别结果角度

返回的字符串指针需调用 FreeStringPtr 释放内存。

Last Updated: