查找绑定窗口图片1 - FindWindowsFromPathAll
函数简介
在绑定窗口的指定区域内查找指定图像的所有匹配位置,模板通过文件路径指定,支持多图,返回全部匹配结果。
接口名称
FindWindowsFromPathAll
DLL调用
long FindWindowsFromPathAll(long instance, int x1, int y1, int x2, int y2, string templ, string deltaColor, double matchVal);
参数说明
| 参数名 | 类型 | 说明 |
|---|---|---|
| instance | 长整数型 | OLAPlug对象的指针,由 CreateCOLAPlugInterFace 接口生成。 |
| x1 | 整数型 | 搜索区域左上角X坐标 |
| y1 | 整数型 | 搜索区域左上角Y坐标 |
| x2 | 整数型 | 搜索区域右下角X坐标 |
| y2 | 整数型 | 搜索区域右下角Y坐标 |
| templ | 字符串 | 模板图片的路径,可以是多个图片,如"test.bmp|test2.bmp|test3.bmp" |
| deltaColor | 字符串 | 颜色差值,格式为"RRGGBB",如"101010" |
| matchVal | 双精度浮点数 | 相似度,如0.85,最大为1 |
示例
C++
long instance = CreateCOLAPlugInterFace();
BindWindow(instance, hwnd, 0, 0, 0);
// 在窗口全区域查找所有匹配位置
long resultPtr = FindWindowsFromPathAll(instance, 0, 0, 0, 0, "templ.bmp", "101010", 0.85);
char* result = GetStringFromPtr(instance, resultPtr);
FreeStringPtr(instance, resultPtr);
Python
# 待补充
返回值
字符串指针,返回JSON数组格式的所有匹配结果。DLL调用返回字符串指针地址,需要调用 FreeStringPtr 接口释放内存。
返回数据格式:
[{
"MatchVal": 0.85,
"MatchState": true,
"Index": 0,
"X": 100,
"Y": 200,
"Width": 100,
"Height": 100
}]
| 字段名 | 类型 | 说明 |
|---|---|---|
| MatchVal | 浮点数 | 匹配相似度。 |
| MatchState | 布尔 | 是否匹配成功。 |
| Index | 整数 | 结果索引(从 0 开始)。 |
| X | 整数 | X 坐标。 |
| Y | 整数 | Y 坐标。 |
| Width | 整数 | 宽度。 |
| Height | 整数 | 高度。 |
注意事项
- x1、y1、x2、y2都传0时,将搜索整个窗口客户区
