取色 - GetColor

函数简介

获取指定坐标点(x, y)的颜色值。此函数可以获取窗口上指定位置的颜色，返回格式为"AARRGGBB"的十六进制颜色字符串。适用于颜色检测、图像分析等场景。

接口名称

GetColor

DLL调用

long GetColor(long ola, int x, int y)

参数定义:

  • ola (长整型数): OLAPlug对象的指针，由 CreateCOLAPlugInterFace 接口生成。
  • x (整型数): 要获取颜色的X坐标
  • y (整型数): 要获取颜色的Y坐标

示例:

// 获取指定坐标的颜色
long colorPtr = GetColor(ola, 100, 100);
if (colorPtr != 0) {
    // 获取颜色字符串
    string color = GetStringFromPtr(colorPtr);
    printf("坐标(100, 100)的颜色为：%s\n", color.c_str());
    
    // 释放字符串内存
    FreeStringPtr(ola, colorPtr);
} else {
    printf("获取颜色失败\n");
}

// 检查特定颜色
long colorPtr = GetColor(ola, 30, 30);
if (colorPtr != 0) {
    string color = GetStringFromPtr(colorPtr);
    if (color == "ffffff") {
        printf("找到白色\n");
    }
    FreeStringPtr(ola, colorPtr);
}

COM调用

string GetColor(int x, int y)

参数定义:

  • x (整型数): 要获取颜色的X坐标
  • y (整型数): 要获取颜色的Y坐标

示例:

# 获取指定坐标的颜色
color = ola.GetColor(100, 100)
if color:
    messagebox("坐标(100, 100)的颜色为：" + color)
else:
    messagebox("获取颜色失败")

# 检查特定颜色
color = ola.GetColor(30, 30)
if color == "ffffff":
    messagebox("找到白色")

返回值

字符串: 返回指定坐标点的颜色值，格式为"RRGGBB"的十六进制字符串（小写）。如果获取失败返回空字符串。

注意事项

  1. 坐标必须在有效范围内，否则可能导致程序异常
  2. 返回的颜色字符串为小写，便于与工具匹配
  3. DLL调用时，返回的字符串指针需要调用 FreeStringPtr 接口释放内存
  4. 颜色格式为6位十六进制数，如"ffffff"表示白色
  5. 建议在使用前检查坐标是否有效
  6. 如果坐标超出屏幕范围，将返回空字符串
  7. 颜色值不包含透明度信息
  8. 建议在循环中获取颜色时注意内存管理
  9. 颜色值可用于后续的颜色匹配和比较操作
  10. 如果需要带透明度的颜色值，请使用其他相关函数
Last Updated: