查找文字 - FindStrDetail

函数简介

查找指定文字的坐标，默认返回最优结果，支持 ShowMatchWindow 弹窗显示结果。

接口名称

FindStrDetail

DLL调用

long FindStrDetail(long ola, int x1, int y1, int x2, int y2, string str, string colorList, string dict, double matchVal);

参数说明

参数名类型说明
ola长整数型OLAPlug对象的指针，由 CreateCOLAPlugInterFace 接口生成。
x1整数型查找区域的左上角X坐标
y1整数型查找区域的左上角Y坐标
x2整数型查找区域的右下角X坐标
y2整数型查找区域的右下角Y坐标
str字符串要查找的文字
colorList字符串颜色模型配置字符串，用于限定图像匹配中的颜色范围，格式说明见 颜色模型说明 - ColorModel。JSON格式示例：[{"StartColor":"3278FA","EndColor":"6496FF","Type":0}]；简化格式示例：`3278FA-000000
dict字符串字库名称，为空时搜索所有字库
matchVal双精度浮点数相似度，如 0.85，最大为 1

示例

C++
long instance = CreateCOLAPlugInterFace();
BindWindow(instance, hwnd, 0, 0, 0);
// 查找文字"确定"并返回详细JSON结果
long resultPtr = FindStrDetail(instance, 0, 0, 0, 0, "确定", "FFFFFF-101010", "", 0.85);
char* json = GetStringFromPtr(instance, resultPtr);
FreeStringPtr(instance, resultPtr);

返回值

字符串指针地址，返回JSON格式的匹配结果，如：

{
    "MatchVal": 0.85,
    "MatchState": true,
    "Index": 0,
    "Angle": 45.0,
    "X": 100,
    "Y": 200,
    "Width": 100,
    "Height": 100
}
字段名类型说明
MatchVal浮点数匹配相似度。
MatchState布尔是否匹配成功。
Index整数结果索引（从 0 开始）。
Angle浮点数匹配角度。
X整数X 坐标。
Y整数Y 坐标。
Width整数宽度。
Height整数高度。
  • MatchVal：实际匹配的相似度值
  • MatchState：是否匹配成功
  • Index：多图匹配时的图片索引，从0开始
  • Angle：匹配到的图像旋转角度
  • X/Y：匹配点坐标
  • Width/Height：匹配模板宽高

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

Last Updated: