匹配绑定窗口图片5 - MatchWindowsThresholdFromPtrAll

函数简介

二值化后匹配所有符合模板图片的坐标，模板通过内存指针传入，返回相对绑定窗口坐标。

接口名称

MatchWindowsThresholdFromPtrAll

DLL调用

long MatchWindowsThresholdFromPtrAll(long ola, int x1, int y1, int x2, int y2, string colorJson, long templ, double matchVal, double angle, double scale);

参数说明

参数名类型说明
ola长整数型OLAPlug对象的指针，由 CreateCOLAPlugInterFace 接口生成。
x1整数型查找区域的左上角X坐标
y1整数型查找区域的左上角Y坐标
x2整数型查找区域的右下角X坐标
y2整数型查找区域的右下角Y坐标
colorJson字符串颜色模型配置字符串，格式说明见 颜色模型说明 - ColorModel。JSON格式示例：[{"StartColor":"3278FA","EndColor":"6496FF","Type":0}]；简化格式示例：3278FA-000000|6496FF-202020 或 3278FA~6496FF 或 FF0000|00FF00
templ长整数型OLAImage对象的地址，由LoadImage等接口生成
matchVal双精度浮点数相似度，如0.85，最大为1
angle双精度浮点数旋转角度，每次匹配后旋转指定角度继续匹配，角度越小匹配次数越多时间越长，0为不旋转速度最快
scale双精度浮点数窗口缩放比例，默认为1，可通过GetScaleFromWindows接口获取

示例

C++
long instance = CreateCOLAPlugInterFace();
BindWindow(instance, hwnd, 0, 0, 0);
long templ = LoadImage(instance, "templ.bmp");
// 二值化后匹配所有结果
long resultPtr = MatchWindowsThresholdFromPtrAll(instance, 0, 0, 0, 0, "FF0000~FF5555", templ, 0.85, 0, 1.0);
char* result = GetStringFromPtr(instance, resultPtr);
FreeStringPtr(instance, resultPtr);

返回值

字符串指针，返回JSON数组格式的匹配结果。DLL调用返回字符串指针地址，需要调用 FreeStringPtr 接口释放内存。

返回数据格式：

[{
    "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整数高度。

注意事项

  • x1、y1、x2、y2都传0时，将搜索整个窗口客户区
  • 返回的坐标是相对于绑定窗口客户区的坐标
Last Updated: