查找绑定窗口图片3 - FindWindowsFromPtrAll
函数简介
在绑定窗口的指定区域内查找指定图像的所有匹配位置,模板通过内存指针传入,返回全部匹配结果。
接口名称
FindWindowsFromPtrAll
DLL调用
long FindWindowsFromPtrAll(long instance, int x1, int y1, int x2, int y2, long templ, string deltaColor, double matchVal);
参数说明
| 参数名 | 类型 | 说明 |
|---|---|---|
| instance | 长整数型 | OLAPlug对象的指针,由 CreateCOLAPlugInterFace 接口生成。 |
| x1 | 整数型 | 搜索区域左上角X坐标 |
| y1 | 整数型 | 搜索区域左上角Y坐标 |
| x2 | 整数型 | 搜索区域右下角X坐标 |
| y2 | 整数型 | 搜索区域右下角Y坐标 |
| templ | 长整数型 | OLAImage对象的地址,由LoadImage等接口生成 |
| deltaColor | 字符串 | 颜色差值,格式为"RRGGBB",如"101010" |
| matchVal | 双精度浮点数 | 相似度,如0.85,最大为1 |
示例
C++
long instance = CreateCOLAPlugInterFace();
BindWindow(instance, hwnd, 0, 0, 0);
long templ = LoadImage(instance, "templ.bmp");
// 通过内存指针在窗口中查找所有匹配位置
long resultPtr = FindWindowsFromPtrAll(instance, 0, 0, 0, 0, templ, "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时,将搜索整个窗口客户区
