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

函数简介

查找图片符合指定颜色范围的所有颜色点。此函数可以在指定的图片中搜索所有符合特定颜色范围的像素点，并返回它们的坐标列表。适用于需要批量查找颜色点的场景，如图像分析、特征提取等。

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}

接口名称

FindMultiColorListFromPtr

DLL调用

long FindMultiColorListFromPtr(long ola, long imgPtr, string colorList)

参数定义:

  • ola (长整型数): OLAPlug对象的指针，由 CreateCOLAPlugInterFace 接口生成。
  • imgPtr (长整型数): OLAImage对象的地址
  • colorList (字符串): 颜色列表的json字符串，如： [{"StartColor": "3278FA", "EndColor": "6496FF","Type":0}, {"StartColor": "3278FA", "EndColor": "6496FF","Type":1}]

示例:

// 在图片中查找所有指定颜色点
string colorList = "[{\"StartColor\": \"3278FA\", \"EndColor\": \"6496FF\", \"Type\": 0}]";
long result = FindMultiColorListFromPtr(ola, imagePtr, colorList);
if (result != 0) {
    // 解析返回的JSON字符串
    // 注意：使用完后需要调用FreeStringPtr释放内存
    printf("找到颜色点列表：%s\n", result);
    FreeStringPtr(ola, result);
} else {
    printf("未找到颜色点\n");
}

// 在图片中查找所有白色点
string colorList = "[{\"StartColor\": \"FFFFFF\", \"EndColor\": \"FFFFFF\", \"Type\": 0}]";
long result = FindMultiColorListFromPtr(ola, imagePtr, colorList);
if (result != 0) {
    printf("找到白色点列表：%s\n", result);
    FreeStringPtr(ola, result);
} else {
    printf("未找到白色点\n");
}

COM调用

string FindMultiColorListFromPtr(long imgPtr, string colorList)

参数定义:

  • imgPtr (长整型数): OLAImage对象的地址
  • colorList (字符串): 颜色列表的json字符串，如： [{"StartColor": "3278FA", "EndColor": "6496FF","Type":0}, {"StartColor": "3278FA", "EndColor": "6496FF","Type":1}]

示例:

# 在图片中查找所有指定颜色点
colorList = '[{"StartColor": "3278FA", "EndColor": "6496FF", "Type": 0}]'
result = ola.FindMultiColorListFromPtr(imagePtr, colorList)
if result:
    # 解析返回的JSON字符串
    points = json.loads(result)
    for point in points:
        messagebox("找到颜色点，坐标：(" + str(point["x"]) + ", " + str(point["y"]) + ")")
else:
    messagebox("未找到颜色点")

# 在图片中查找所有白色点
colorList = '[{"StartColor": "FFFFFF", "EndColor": "FFFFFF", "Type": 0}]'
result = ola.FindMultiColorListFromPtr(imagePtr, colorList)
if result:
    points = json.loads(result)
    for point in points:
        messagebox("找到白色点，坐标：(" + str(point["x"]) + ", " + str(point["y"]) + ")")
else:
    messagebox("未找到白色点")

返回值

字符串: 返回识别到的坐标点列表的JSON字符串，格式如下：

[
  {
    "x": 1,
    "y": 2
  },
  {
    "x": 2,
    "y": 1
  }
]

注意事项

  1. 颜色范围使用RRGGBB格式，每个通道单独计算范围
  2. 支持ARGB模式，如#FFFFFFFF
  3. 颜色匹配类型说明：
    • 0: 正常匹配，保留在颜色范围内的像素
    • 1: 反色匹配，保留在颜色范围外的像素
    • 2: 正常交集匹配，保留在颜色范围内的像素取交集
    • 3: 反色交集匹配，保留在颜色范围外的像素取交集
  4. 返回的坐标是相对于图片的坐标
  5. 返回的JSON字符串需要解析后才能使用
  6. DLL调用返回的字符串指针需要调用 FreeStringPtr 接口释放内存
  7. 颜色范围越大，匹配的像素点越多，但可能会影响查找精度
  8. 如果图片中符合条件的点较多，返回的JSON字符串可能会很长，请注意内存使用
  9. 使用反色模式时，会查找不在指定颜色范围内的点
  10. 使用交集模式时，需要同时满足所有颜色条件
  11. 使用并集模式时，满足任一颜色条件即可
  12. 确保传入的图片指针是有效的，否则可能导致程序崩溃
Last Updated: