匹配绑定窗口图片 - MatchWindowsFromPathAll

函数简介

匹配所有符合模板图片的位置信息，模板通过文件路径指定，返回相对绑定窗口坐标。

接口名称

MatchWindowsFromPathAll

DLL调用

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

参数说明

参数名类型说明
ola长整数型OLAPlug对象的指针，由 CreateCOLAPlugInterFace 接口生成。
x1整数型查找区域的左上角X坐标
y1整数型查找区域的左上角Y坐标
x2整数型查找区域的右下角X坐标
y2整数型查找区域的右下角Y坐标
templ字符串模板图片的路径，可以是多个图片，如"test.bmp|test2.bmp|test3.bmp"
matchVal双精度浮点数相似度，如0.85，最大为1
type整数型匹配类型：1-灰度匹配(速度快)；2-彩色匹配；3-透明匹配；4-透明彩色权重匹配；5-普通彩色匹配
angle双精度浮点数旋转角度，每次匹配后旋转指定角度继续匹配，角度越小匹配次数越多时间越长，0为不旋转速度最快
scale双精度浮点数窗口缩放比例，默认为1，可通过GetScaleFromWindows接口获取

示例

C++
long instance = CreateCOLAPlugInterFace();
BindWindow(instance, hwnd, 0, 0, 0);
// 在窗口全区域匹配所有结果，灰度匹配，不旋转
long resultPtr = MatchWindowsFromPathAll(instance, 0, 0, 0, 0, "templ.bmp", 0.85, 1, 0, 1.0);
char* result = GetStringFromPtr(instance, resultPtr);
FreeStringPtr(instance, resultPtr);

返回值

字符串指针，返回JSON数组格式的匹配结果。多图识别时Index字段标识是第几个图片返回的结果，索引从0开始。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: