图像函数

图色识别

6 个函数

获取坐标颜色

Image.getColor(横坐标: integer, 纵坐标: integer): string

读取当前截图指定坐标，返回 #RRGGBB 颜色。

参数2 项
序号名称类型参数说明
1 横坐标 整 当前截图中要读取的 X 坐标（横向位置）。
2 纵坐标 整 当前截图中要读取的 Y 坐标（纵向位置）。
返回值至少接收一个返回值
序号名称类型返回说明
1 颜色 字 指定像素的颜色；坐标无效时为空字符。

坐标比色

Image.compareColor(横坐标: integer, 纵坐标: integer, 目标颜色: string, 颜色容差: integer): integer

判断指定像素是否在目标颜色容差内。

参数4 项
序号名称类型参数说明
1 横坐标 整 当前截图中要比较的 X 坐标（横向位置）。
2 纵坐标 整 当前截图中要比较的 Y 坐标（纵向位置）。
3 目标颜色 字 要查找或比较的目标颜色，格式 #RRGGBB。示例：#FF0000
4 颜色容差 整 范围 0～255；0 最严格，数值越大范围越宽。快捷值仅为常用预设，可手动填写
返回值至少接收一个返回值
序号名称类型返回说明
1 是否匹配 整 坐标颜色是否匹配目标颜色。
  • 1：条件成立
  • 0：条件不成立

多点比色

Image.compareMultiColor(固定色表: string, 颜色容差: integer): integer

同时核对多个固定坐标的颜色，适合判断一个界面状态是否完整出现。

参数2 项
序号名称类型参数说明
1 固定色表 字 格式为 x,y,#RRGGBB，多个点用 | 分隔。示例：100,200,#FFFFFF|120,200,#FF0000；也可用截屏工具生成。
2 颜色容差 整 范围 0～255；0 最严格，数值越大范围越宽。快捷值仅为常用预设，可手动填写
返回值至少接收一个返回值
序号名称类型返回说明
1 是否匹配 整 全部坐标颜色是否匹配。
  • 1：条件成立
  • 0：条件不成立

区域找色

Image.findColor(目标颜色: string, 颜色容差: integer, 范围横坐标: integer, 范围纵坐标: integer, 范围宽度: integer, 范围高度: integer, 查找方向: integer): image

按查找方向返回范围内第一个匹配颜色的位置。

参数7 项
序号名称类型参数说明
1 目标颜色 字 要查找或比较的目标颜色，格式 #RRGGBB。示例：#FF0000
2 颜色容差 整 范围 0～255；0 最严格，数值越大范围越宽。快捷值仅为常用预设，可手动填写
3 范围横坐标 整 查找区域左上角 X 坐标；X、Y、宽、高都填 0 时使用全屏。
4 范围纵坐标 整 查找区域左上角 Y 坐标；X、Y、宽、高都填 0 时使用全屏。
5 范围宽度 整 查找区域宽度；X、Y、宽、高都填 0 时使用全屏。
6 范围高度 整 查找区域高度；X、Y、宽、高都填 0 时使用全屏。
7 查找方向 整 扫描顺序：0 左上到右下，1 右上到左下，2 左下到右上，3 右下到左上。
返回值至少接收一个返回值
序号名称类型返回说明
1 图像结果 图 返回统一图像结果集合，未命中时总个数为 0。每项只包含名称、X、Y、宽、高和相似度；使用获取名称、获取X、获取Y、获取宽、获取高和获取相似度读取。相似度范围为 0～1，保留两位小数。

区域颜色统计

Image.colorStats(目标颜色: string, 颜色容差: integer, 范围横坐标: integer, 范围纵坐标: integer, 范围宽度: integer, 范围高度: integer): (integer, integer, number)

统计目标颜色的像素覆盖情况。区域覆盖率＝匹配像素数÷范围像素总数×100；血量等进度＝当前匹配像素数÷满值匹配像素数×100，满值需用相同范围、颜色和容差采集。

参数6 项
序号名称类型参数说明
1 目标颜色 字 要查找或比较的目标颜色，格式 #RRGGBB。示例：#FF0000
2 颜色容差 整 范围 0～255；0 最严格，数值越大范围越宽。快捷值仅为常用预设，可手动填写
3 范围横坐标 整 统计范围 X；全屏可填 0
4 范围纵坐标 整 统计范围 Y；全屏可填 0
5 范围宽度 整 统计范围宽；全屏可填 0
6 范围高度 整 统计范围高；全屏可填 0
返回值至少接收一个返回值
序号名称类型返回说明
1 匹配像素数 整 范围内匹配目标颜色的像素数量。
2 范围像素总数 整 有效统计范围的全部像素数量，即范围宽度乘以高度。
3 区域颜色覆盖率 浮 匹配像素数÷范围像素总数×100，范围 0～100，四舍五入保留两位小数。

区域色块查找

Image.findColorBlock(目标颜色: string, 颜色容差: integer, 范围横坐标: integer, 范围纵坐标: integer, 范围宽度: integer, 范围高度: integer, 最小宽度: integer, 最小高度: integer): image

查找由目标颜色连续组成的色块，返回各色块的位置、大小和填充率。这里的相似度表示色块像素数除以外接矩形像素数。

参数8 项
序号名称类型参数说明
1 目标颜色 字 要查找或比较的目标颜色，格式 #RRGGBB。示例：#FF0000
2 颜色容差 整 范围 0～255；0 最严格，数值越大范围越宽。快捷值仅为常用预设，可手动填写
3 范围横坐标 整 查找区域左上角 X 坐标；X、Y、宽、高都填 0 时使用全屏。
4 范围纵坐标 整 查找区域左上角 Y 坐标；X、Y、宽、高都填 0 时使用全屏。
5 范围宽度 整 查找区域宽度；X、Y、宽、高都填 0 时使用全屏。
6 范围高度 整 查找区域高度；X、Y、宽、高都填 0 时使用全屏。
7 最小宽度 整 色块最小宽度，必须大于 0；快捷值仅为预设，可手动填写
8 最小高度 整 色块最小高度，必须大于 0；快捷值仅为预设，可手动填写
返回值至少接收一个返回值
序号名称类型返回说明
1 图像结果 图 返回统一图像结果集合，未命中时总个数为 0。每项只包含名称、X、Y、宽、高和相似度；使用获取名称、获取X、获取Y、获取宽、获取高和获取相似度读取。相似度范围为 0～1，保留两位小数。