匹配绑定窗口图片6 - MatchWindowsThresholdFromPath

函数简介

在绑定窗口的指定区域内，通过二值化处理后匹配符合模板图片的坐标。此函数支持多模板匹配、旋转匹配和缩放匹配，返回相对绑定窗口的坐标位置。适用于需要精确图像识别的场景，如游戏自动化、界面测试等。

当x1, y1, x2, y2参数都传0时，将匹配窗口整个客户区。

接口名称

MatchWindowsThresholdFromPath

DLL调用

long MatchWindowsThresholdFromPath(long ola, int x1, int y1, int x2, int y2, string colorJson, string templ, double matchVal, double angle, double scale)

参数定义:

  • ola (长整型数): OLAPlug对象的指针，由 CreateCOLAPlugInterFace 接口生成。
  • x1 (整型数): 查找区域的左上角X坐标
  • y1 (整型数): 查找区域的左上角Y坐标
  • x2 (整型数): 查找区域的右下角X坐标
  • y2 (整型数): 查找区域的右下角Y坐标
  • colorJson (字符串): 颜色模型配置字符串，用于限定图像匹配中的颜色范围，格式说明见 颜色模型说明 - ColorModel。JSON格式示例：[{"StartColor":"3278FA","EndColor":"6496FF","Type":0}]；简化格式示例：3278FA-000000|6496FF-202020 或 3278FA~6496FF 或 FF0000|00FF00
  • templ (字符串): 模板图片的路径，支持多个图片，用"|"分隔，如"test.bmp|test2.bmp|test3.bmp"
  • matchVal (双精度浮点数): 相似度阈值，范围0-1，如0.85表示85%相似度
  • angle (双精度浮点数): 旋转角度，每次匹配后旋转指定角度继续匹配，直到匹配成功。角度越小匹配次数越多，时间越长。0表示不旋转，速度最快
  • scale (双精度浮点数): 窗口缩放比例，默认为1。可通过 GetScaleFromWindows 接口获取当前窗口缩放比例

示例:

// 定义颜色范围
string colorJson = R"([
    {
        "StartColor": "3278FA",
        "EndColor": "6496FF",
        "Type": 0
    },
    {
        "StartColor": "FF0000",
        "EndColor": "FF3333",
        "Type": 1
    }
])";

// 匹配图片
long resultPtr = MatchWindowsThresholdFromPath(ola, 0, 0, 800, 600, colorJson, "templates/button.bmp", 0.85, 45.0, 1.0);
if (resultPtr != 0) {
    string result = GetStringFromPtr(resultPtr);
    printf("匹配结果: %s\n", result.c_str());

    // 解析JSON结果
    // {
    //     "MatchVal": 0.85,//数据相似度
    //     "MatchState": true,//返回数据是否大于指定精度,用于快速判断识别结果
    //     "Index": 0,//多图识别时的返回索引
    //     "Angle": 45.0,//识别结果角度
    //     "X": 100,//识别结果X坐标
    //     "Y": 200,//识别结果Y坐标
    //     "Width":100,//识别结果宽度
    //     "Height":100//识别结果高度
    // }

    // 释放字符串内存
    FreeStringPtr(ola, resultPtr);
}

返回值

字符串: 返回JSON格式的匹配结果，包含以下字段：

  • MatchVal: 数据相似度，范围0-1
  • MatchState: 是否大于指定精度，用于快速判断识别结果
  • Index: 多图识别时的返回索引
  • Angle: 识别结果角度
  • X: 匹配点X坐标
  • Y: 匹配点Y坐标
  • Width: 匹配模板宽度
  • Height: 匹配模板高度

注意事项

  1. 颜色值必须使用RRGGBB格式的十六进制字符串
  2. 支持多个颜色范围的指定，每个范围可以设置不同的匹配类型
  3. 颜色匹配类型说明：
    • 0: 正常匹配，保留在颜色范围内的像素
    • 1: 反色匹配，保留在颜色范围外的像素
    • 2: 正常交集匹配，保留在颜色范围内的像素取交集
    • 3: 反色交集匹配，保留在颜色范围外的像素取交集
  4. 模板图片路径支持多个图片，用"|"分隔
  5. 相似度阈值范围必须在0-1之间
  6. 旋转角度越小，匹配次数越多，耗时越长
  7. 窗口缩放比例必须与实际情况相符
  8. DLL调用时，返回的字符串指针需要调用 FreeStringPtr 接口释放内存
  9. 建议在使用前检查参数的有效性
  10. 处理大图片时注意性能影响
  11. 返回的坐标是相对于绑定窗口的坐标
  12. 如果匹配失败，MatchState将为false
Last Updated: