查找指定颜色范围坐标 - FindMultiColor

函数简介

查找指定区域内符合指定颜色范围的第一个坐标点。此函数可以在指定区域内搜索符合特定颜色范围的第一个像素点，并返回其坐标。支持多种搜索方向，可以灵活应用于图像识别、自动化测试等场景。

ColorModel:

颜色每个通道单独计算范围，如颜色范围位3278FA，6496FF，实际对应R(50~100) G(120 ~150) B(250 ~255)

包含下限(>= color1) 包含上限(<= color2)

支持ARGB模式如#FFFFFFFF

支持反色模式，交集并集查询颜色

  • 0: 正常匹配，保留在颜色范围内的像素
  • 1: 反色匹配，保留在颜色范围外的像素
  • 2: 正常交集匹配，保留在颜色范围内的像素取交集
  • 3: 反色交集匹配，保留在颜色范围外的像素取交集 如{"StartColor": "3278FA", "EndColor": "6496FF","Type":0}

x1 , y1, x2, y2传 0, 0, 0, 0 为窗口整个客户区

返回数据为相对窗口坐标

接口名称

FindMultiColor

DLL调用

int FindMultiColor(long ola, int x1, int y1, int x2, int y2, string colorList, int dir, int* x, int* y)

参数定义:

  • ola (长整型数): OLAPlug对象的指针，由 CreateCOLAPlugInterFace 接口生成。
  • x1 (整型数): 查找区域的左上角X坐标
  • y1 (整型数): 查找区域的左上角Y坐标
  • x2 (整型数): 查找区域的右下角X坐标
  • y2 (整型数): 查找区域的右下角Y坐标
  • colorList (字符串): 颜色列表的json字符串，如： [{"StartColor": "3278FA", "EndColor": "6496FF","Type":0}, {"StartColor": "3278FA", "EndColor": "6496FF","Type":1}]
  • dir (整型数): 查找方向
    • 0: 从左到右,从上到下
    • 1: 从左到右,从下到上
    • 2: 从右到左,从上到下
    • 3: 从右到左,从下到上
    • 4: 从中心往外查找
    • 5: 从上到下,从左到右
    • 6: 从上到下,从右到左
    • 7: 从下到上,从左到右
    • 8: 从下到上,从右到左
  • x (整型数指针): 返回颜色坐标X坐标
  • y (整型数指针): 返回颜色坐标Y坐标

示例:

// 在窗口客户区查找指定颜色
int x = 0, y = 0;
string colorList = "[{\"StartColor\": \"3278FA\", \"EndColor\": \"6496FF\", \"Type\": 0}]";
int ret = FindMultiColor(ola, 0, 0, 0, 0, colorList, 0, &x, &y);
if (ret == 1) {
    printf("找到颜色点，坐标：(%d, %d)\n", x, y);
} else {
    printf("未找到颜色点\n");
}

// 在指定区域查找颜色（从中心往外查找）
int x = 0, y = 0;
string colorList = "[{\"StartColor\": \"FFFFFF\", \"EndColor\": \"FFFFFF\", \"Type\": 0}]";
int ret = FindMultiColor(ola, 100, 100, 200, 200, colorList, 4, &x, &y);
if (ret == 1) {
    printf("找到白色点，坐标：(%d, %d)\n", x, y);
} else {
    printf("未找到白色点\n");
}

COM调用

int FindMultiColor(int x1, int y1, int x2, int y2, string colorList, int dir, int* x, int* y)

参数定义:

  • x1 (整型数): 查找区域的左上角X坐标
  • y1 (整型数): 查找区域的左上角Y坐标
  • x2 (整型数): 查找区域的右下角X坐标
  • y2 (整型数): 查找区域的右下角Y坐标
  • colorList (字符串): 颜色列表的json字符串，如： [{"StartColor": "3278FA", "EndColor": "6496FF","Type":0}, {"StartColor": "3278FA", "EndColor": "6496FF","Type":1}]
  • dir (整型数): 查找方向
    • 0: 从左到右,从上到下
    • 1: 从左到右,从下到上
    • 2: 从右到左,从上到下
    • 3: 从右到左,从下到上
    • 4: 从中心往外查找
    • 5: 从上到下,从左到右
    • 6: 从上到下,从右到左
    • 7: 从下到上,从左到右
    • 8: 从下到上,从右到左
  • x (整型数指针): 返回颜色坐标X坐标
  • y (整型数指针): 返回颜色坐标Y坐标

示例:

# 在窗口客户区查找指定颜色
colorList = '[{"StartColor": "3278FA", "EndColor": "6496FF", "Type": 0}]'
ret, x, y = ola.FindMultiColor(0, 0, 0, 0, colorList, 0, x, y)
if ret == 1:
    messagebox("找到颜色点，坐标：(" + str(x) + ", " + str(y) + ")")
else:
    messagebox("未找到颜色点")

# 在指定区域查找颜色（从中心往外查找）
colorList = '[{"StartColor": "FFFFFF", "EndColor": "FFFFFF", "Type": 0}]'
ret, x, y = ola.FindMultiColor(100, 100, 200, 200, colorList, 4, x, y)
if ret == 1:
    messagebox("找到白色点，坐标：(" + str(x) + ", " + str(y) + ")")
else:
    messagebox("未找到白色点")

返回值

整型数:

  • 0: 失败，未找到符合条件的颜色点
  • 1: 成功，找到符合条件的颜色点

注意事项

  1. 颜色范围使用RRGGBB格式，每个通道单独计算范围
  2. 支持ARGB模式，如#FFFFFFFF
  3. 颜色匹配类型说明：
    • 0: 正常匹配，保留在颜色范围内的像素
    • 1: 反色匹配，保留在颜色范围外的像素
    • 2: 正常交集匹配，保留在颜色范围内的像素取交集
    • 3: 反色交集匹配，保留在颜色范围外的像素取交集
  4. 当x1,y1,x2,y2都传0时，会查找整个窗口客户区
  5. 返回的坐标是相对于窗口客户区的坐标
  6. 不同的查找方向会影响查找效率和结果，建议根据实际需求选择合适的查找方向
  7. 颜色范围越大，匹配的像素点越多，但可能会影响查找精度
  8. 使用反色模式时，会查找不在指定颜色范围内的点
  9. 使用交集模式时，需要同时满足所有颜色条件
  10. 使用并集模式时，满足任一颜色条件即可
Last Updated: