匹配动画窗口1 - MatchAnimationFromPtr

函数简介

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

接口名称

MatchAnimationFromPtr

DLL调用

long MatchAnimationFromPtr(long ola, int x1, int y1, int x2, int y2, long 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长整数型OLAImage对象的地址，由LoadImage等接口生成
matchVal双精度浮点数相似度阈值，范围0-1，如0.85表示85%相似度
type整数型匹配类型：1-灰度匹配(速度快)；2-彩色匹配；3-透明匹配；4-透明彩色权重匹配；5-普通彩色匹配
angle双精度浮点数旋转角度，每次匹配后旋转指定角度继续匹配，角度越小匹配次数越多时间越长，0为不旋转速度最快
scale双精度浮点数窗口缩放比例，默认为1，可通过GetScaleFromWindows接口获取
delay整数型动画帧间隔，单位毫秒
time整数型总识别时间，单位毫秒
threadCount整数型用于查找的线程数，需根据delay帧率自行调整，过小会导致识别时间到期未识别完，过大会导致CPU占用过高

示例

// 创建OLA对象
long ola = CreateCOLAPlugInterFace();

// 加载模板图片
long templ = LoadImage(ola, "animation.bmp");

// 执行动画匹配
long ret = MatchAnimationFromPtr(ola, 0, 0, 0, 0, templ, 0.85, 1, 45.0, 1.0, 20, 1000, 5);

// 检查操作是否成功
if (ret != 0) {
    char* result = (char*)ret;
    printf("匹配结果: %s\n", result);
    // 释放返回的字符串内存
    FreeStringPtr(result);
}

// 释放模板图片内存
FreeImagePtr(ola, templ);

返回值

字符串指针，返回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: