匹配动画窗口 - MatchAnimationFromPath

函数简介

匹配动画窗口，可用于GIF动画识别，在指定时间内识别动图，查找到立即返回结果，返回相对绑定窗口坐标。

接口名称

MatchAnimationFromPath

DLL调用

long MatchAnimationFromPath(long ola, int x1, int y1, int x2, int y2, string templ, double matchVal, int type, double angle, double scale, int delay, int time, int threadCount);

参数说明

参数名类型说明
ola长整数型OLAPlug对象的指针，由 CreateCOLAPlugInterFace 接口生成。
x1整数型查找区域的左上角X坐标
y1整数型查找区域的左上角Y坐标
x2整数型查找区域的右下角X坐标
y2整数型查找区域的右下角Y坐标
templ字符串模板图片的路径，可以是多个图片，如"test.bmp|test2.bmp|test3.bmp"
matchVal双精度浮点数相似度阈值，范围0-1，如0.85表示85%相似度
type整数型匹配类型：1-灰度匹配(速度快)；2-彩色匹配；3-透明匹配；4-透明彩色权重匹配；5-普通彩色匹配
angle双精度浮点数旋转角度，每次匹配后旋转指定角度继续匹配，角度越小匹配次数越多时间越长，0为不旋转速度最快
scale双精度浮点数窗口缩放比例，默认为1，可通过GetScaleFromWindows接口获取
delay整数型动画帧间隔，单位毫秒
time整数型总识别时间，单位毫秒
threadCount整数型用于查找的线程数，需根据delay帧率自行调整，过小会导致识别时间到期未识别完，过大会导致CPU占用过高

示例

C++
long instance = CreateCOLAPlugInterFace();
BindWindow(instance, hwnd, 0, 0, 0);
// 在5秒内以100ms间隔匹配动画，4线程
long resultPtr = MatchAnimationFromPath(instance, 0, 0, 0, 0, "anim.bmp", 0.85, 1, 0, 1.0, 100, 5000, 4);
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时，将搜索整个窗口客户区
  • 识别结果最长等待时间为 time + 1000ms
  • 返回的坐标是相对于绑定窗口客户区的坐标
Last Updated: