文章
文章商铺文档快讯

Autojs模块：图色操作

找图找色的核心知识

哔哩哔哩：https://www.bilibili.com/video/BV1crfiYZEa4/

图色基础

1、颜色的表示方法

#AARRGGBB
#RRGGBB

AA 是Alpha通道(透明度)的值，
RR 是R通道(红色)的值，
GG 是G通道(绿色)的值，
BB是B通道(蓝色)的值

可以通过colors.toString()把颜色整数转换为字符串

通过colors.parseColor()把颜色字符串解析为颜色整数

2、颜色的转换方法

//返回颜色值的字符串，格式为 "#AARRGGBB"。
colors.toString(colorNum)

//返回颜色color的R通道的值，范围0~255.
colors.red(Num | Str)

//返回颜色color的G通道的值，范围0~255.
colors.green(Num | Str)

//返回颜色color的B通道的值，范围0~255.
colors.blue(Num | Str)

//返回颜色color的Alpha通道的值，范围0~255.
colors.alpha(Num | Str)

//返回这些颜色通道构成的整数颜色值。Alpha通道将是255（不透明）。
colors.rgb(redNum, greenNum, blueNum)

//返回这些颜色通道构成的整数颜色值。
colors.argb(alpha, red, green, blue)

//返回颜色的整数值。
colors.parseColor(colorStr)

3、判断颜色是否相似或相等

//返回两个颜色是否相似。
colors.isSimilar(num|str, num|str[, thresholdNum, algorithm])


//返回两个颜色是否相等。*注意该函数会忽略Alpha通道的值进行比较。
colors.equals(num|str, num|str)

4、autojs内置颜色

colors.BLACK
黑色，颜色值 #FF000000

colors.DKGRAY
深灰色，颜色值 #FF444444

colors.GRAY
灰色，颜色值 #FF888888

colors.LTGRAY
亮灰色，颜色值 #FFCCCCCC

colors.WHITE
白色，颜色值 #FFFFFFFF

colors.RED
红色，颜色值 #FFFF0000

colors.GREEN
绿色，颜色值 #FF00FF00

colors.BLUE
蓝色，颜色值 #FF0000FF

colors.YELLOW
黄色，颜色值 #FFFFFF00

colors.CYAN
青色，颜色值 #FF00FFFF

colors.MAGENTA
品红色，颜色值 #FFFF00FF

colors.TRANSPARENT
透明，颜色值 #00000000

5、图片回收机制（防内存泄露）

image对象创建后尽量在不使用时进行回收，同时避免循环创建大量图片。

Image对象通过调用recycle()函数来回收。

// 读取图片
var img = images.read("./1.png");
//对图片进行操作
... 
// 回收图片
img.recycle();

例外的是，caputerScreen()返回的图片不需要回收。

6、读取图片

images.read(path)    //返回Image对象 / null

images.load(url)     //返回Image对象 / null

images.copy(img)     //返回Image对象

7、Image对象

Image.getWidth()  //返回以像素为单位图片宽度。

Image.getHeight()  //返回以像素为单位的图片高度。

Image.saveTo(path) //把图片保存到路径path。（如果文件存在则覆盖）

Image.pixel(x, y)   //返回图片image在点(x, y)处的像素的ARGB值。

8、图片对象的保存方法

Image.saveTo(path) //把图片保存到路径path。（如果文件存在则覆盖）

images.save(image, path[, format = "png", quality = 100])  //如果文件不存在会被创建；文件存在会被覆盖。

9、图片的编码转换（base64和bytes)

images.fromBase64(base64) //返回img对象

images.toBase64(img[, format = "png", quality = 100])  //返回base64数据

images.fromBytes(bytes)  //返回img对象

images.toBytes(img[, format = "png", quality = 100]) //返回字节

10、封装获取屏幕小图的函数

images.clip(img, x, y, w, h)  //从图片img的位置(x, y)处剪切大小为w * h的区域，并返回该剪切区域的新图片。


//封装获取屏幕小图的函数

function getImg(x1,y1,x2,y2,path){
    
    var img = images.captureScreen()

    var imgS = images.clip(img, x1, y1, x2-x1, y2-y1)
    
    imgS.saveTo(path)
    
    img.recycle();
}

11、图片处理的函数（非专业可以略过）

images.resize(img, size[, interpolation])    //调整图片大小

images.scale(img, fx, fy[, interpolation])   //放缩图片，并返回放缩后的图片。

images.rotate(img, degress[, x, y])   //将图片逆时针旋转degress度，返回旋转后的图片对象。

images.concat(img1, image2[, direction])   //连接两张图片，并返回连接后的图像。如果两张图片大小不一致，小的那张将适当居中。

images.grayscale(img)   //灰度化图片，并返回灰度化后的图片。

image.threshold(img, threshold, maxVal[, type])   //将图片阈值化，并返回处理后的图像。

images.adaptiveThreshold(img, maxValue, adaptiveMethod, thresholdType, blockSize, C)   //对图片进行自适应阈值化处理，并返回处理后的图像。

images.cvtColor(img, code[, dstCn])   //对图像进行颜色空间转换，并返回转换后的图像。

images.inRange(img, lowerBound, upperBound)   //将图片二值化，在lowerBound~upperBound范围以外的颜色都变成0，在范围以内的颜色都变成255。

images.interval(img, color, interval)   //将图片二值化，在color-interval ~ color+interval范围以外的颜色都变成0，在范围以内的颜色都变成255。这里对color的加减是对每个通道而言的。

images.blur(img, size[, anchor, type])  //对图像进行模糊（平滑处理），返回处理后的图像。

images.medianBlur(img, size)   //对图像进行中值滤波，返回处理后的图像。

images.gaussianBlur(img, size[, sigmaX, sigmaY, type])   //对图像进行高斯模糊，返回处理后的图像。

images.matToImage(mat)   //把Mat对象转换为Image对象。

12、请求截图权限

images.requestScreenCapture([landscape])

常用格式：

//自动点击获取授权，根据自己的手机型号修改
threads.start(function(){
    //在新线程执行的代码
    while(true){
        if(text('立即开始').findOnce()) {
            text('立即开始').findOnce().click()
            break;
        }else{
            sleep(3000)
        }
    }
});



//请求截图
if(!requestScreenCapture()){
    toast("请求截图失败");
    exit();
}

13、截屏功能

images.captureScreen()  //返回Image对象

captureScreen()

区别：返回Image对象，保存到路径，不返回

images.captureScreen(path)

captureScreen(path)

14、获取图片某点的颜色

images.pixel(image, x, y)

Image.pixel(x, y)

15、在图片中寻找颜色及Point对象讲解

images.findColor(image, color, options)

findColor(image, color, options)    //全局函数


//循环找色例子

requestScreenCapture();

//循环找色，找到红色(#ff0000)时停止并报告坐标
while(true){
    var img = captureScreen();
    var point = findColor(img, "#ff0000");
    if(point){
        toast("找到红色，坐标为(" + point.x + ", " + point.y + ")");
    }
}


//区域找色例子

<//读取本地图片/sdcard/1.png>
var img = images.read("/sdcard/1.png");
//判断图片是否加载成功
if(!img){
    toast("没有该图片");
    exit();
}
//在该图片中找色，指定找色区域为在位置(400, 500)的宽为300长为200的区域，指定找色临界值为4
var point = findColor(img, "#00ff00", {
     region: [400, 500, 300, 200],
     threshold: 4
 });
if(point){
    toast("找到啦:" + point);
}else{
    toast("没找到");
}
  • image {Image} 图片
  • color {number} | {string} 要寻找的颜色的RGB值。如果是一个整数，则以0xRRGGBB的形式代表RGB值（A通道会被忽略）；如果是字符串，则以”#RRGGBB”代表其RGB值。
  • options {Object} 选项

在图片中寻找颜色color。找到时返回找到的点Point，找不到时返回null。

选项包括：

  • region {Array} 找色区域。是一个两个或四个元素的数组。(region[0], region[1])表示找色区域的左上角；region[2]*region[3]表示找色区域的宽高。如果只有region只有两个元素，则找色区域为(region[0], region[1])到屏幕右下角。如果不指定region选项，则找色区域为整张图片。
  • threshold {number} 找色时颜色相似度的临界值，范围为0255（越小越相似，0为颜色相等，255为任何颜色都能匹配）。默认为4。threshold和浮点数相似度(0.01.0)的换算为 similarity = (255 – threshold) / 255.

该函数也可以作为全局函数使用。

16、区域找色的简便方法

images.findColorInRegion(img, color, x, y[, width, height, threshold])

17、在图片中寻找完全相等的颜色点

images.findColorEquals(img, color[, x, y, width, height])

该函数也可以作为全局函数使用。

18、多点找色

images.findMultiColors(img, firstColor, colors[, options])

例子
images.findMultiColors(img, "#123456", [[10, 20, "#ffffff"], [30, 40, "#000000"]])

例子
var m = images.findMultiColors(img, "#ffffff", [[253, 1, "#03d96a"]],{
	region: [,]
    threshold: 0
});

19、图片中某个位置是否是特定颜色

images.detectsColor(image, color, x, y[, threshold = 16, algorithm = "diff"])


if(!requestScreenCapture()){
    toast("请求截图失败");
    exit();
}
text("排行榜").waitFor();
sleep(1000);
//找到点赞控件
var like = id("com.tencent.mm:id/bo_").find().get(1);
sleep(1000)
//获取该控件中点坐标
var x = like.bounds().centerX();
var y = like.bounds().centerY();
//截图
var img = captureScreen();
//判断在该坐标的颜色是否为橙红色
if(images.detectsColor(img, "#dedede", x, y)){
    //是的话则已经是点赞过的了，不做任何动作
    log("没有点过赞")
    like.parent().parent().click();
}else{
    //否则点击点赞按钮
    log("已经点赞了")
}

20、全屏找图

images.findImage(img, template[, options]）

  • img {Image} 大图片
  • template {Image} 小图片（模板）
  • options {Object} 找图选项

找图。在大图片img中查找小图片template的位置（模块匹配），找到时返回位置坐标(Point)，找不到时返回null。

选项包括：

  • threshold {number} 图片相似度。取值范围为0~1的浮点数。默认值为0.9。
  • region {Array} 找图区域。参见findColor函数关于region的说明。
  • level {number} 一般而言不必修改此参数。不加此参数时该参数会根据图片大小自动调整。找图算法是采用图像金字塔进行的, level参数表示金字塔的层次, level越大可能带来越高的找图效率，但也可能造成找图失败（图片因过度缩小而无法分辨）或返回错误位置。因此，除非您清楚该参数的意义并需要进行性能调优，否则不需要用到该参数。

该函数也可以作为全局函数使用。

一个最简单的找图例子如下：

var img = images.read("/sdcard/大图.png");
var templ = images.read("/sdcard/小图.png");
var p = findImage(img, templ);
if(p){
    toast("找到啦:" + p);
}else{
    toast("没找到");
}

稍微复杂点的区域找图例子如下：

auto();
requestScreenCapture();
var wx = images.read("/sdcard/微信图标.png");
//返回桌面
home();
//截图并找图
var p = findImage(captureScreen(), wx, {
    region: [0, 50],
    threshold: 0.8
});
if(p){
    toast("在桌面找到了微信图标啦: " + p);
}else{
    toast("在桌面没有找到微信图标");
}

21、区域找图

images.findImageInRegion(img, template, x, y[, width, height, threshold])

区域找图的简便方法。相当于：

images.findImage(img, template, {
    region: [x, y, width, height],
    threshold: threshold
})

该函数也可以作为全局函数使用。

22、批量找图

images.matchTemplate(img, template, options)

  • img {Image} 大图片
  • template {Image} 小图片（模板）
  • opstions{Object} 找图选项：
    • threshold {number} 图片相似度。取值范围为0~1的浮点数。默认值为0.9。
    • region {Array} 找图区域。参见findColor函数关于region的说明。
    • max {number} 找图结果最大数量，默认为5
    • level {number} 一般而言不必修改此参数。不加此参数时该参数会根据图片大小自动调整。找图算法是采用图像金字塔进行的, level参数表示金字塔的层次, level越大可能带来越高的找图效率，但也可能造成找图失败（图片因过度缩小而无法分辨）或返回错误位置。因此，除非您清楚该参数的意义并需要进行性能调优，否则不需要用到该参数。
  • 返回 {MatchingResult}

在大图片中搜索小图片，并返回搜索结果MatchingResult。

该函数可以用于找图时找出多个位置，可以通过max参数控制最大的结果数量。

也可以对匹配结果进行排序、求最值等操作。

23、MatchingResult对象的使用方法（一）

matches

  • {Array} 匹配结果的数组。

数组的元素是一个Match对象：

  • point {Point} 匹配位置
  • similarity {number} 相似度

例如:

var result = images.matchTemplate(img, template, {
    max: 100
});
result.matches.forEach(match => {
    log("point = " + match.point + ", similarity = " + match.similarity);
});

24、MatchingResult对象的使用方法（二）

points

  • {Array} 匹配位置的数组。

first()

  • 返回 {Match}

第一个匹配结果。如果没有任何匹配，则返回null。

last()

  • 返回 {Match}

最后一个匹配结果。如果没有任何匹配，则返回null。

leftmost()

  • 返回 {Match}

位于大图片最左边的匹配结果。如果没有任何匹配，则返回null。

topmost()

  • 返回 {Match}

位于大图片最上边的匹配结果。如果没有任何匹配，则返回null。

rightmost()

  • 返回 {Match}

位于大图片最右边的匹配结果。如果没有任何匹配，则返回null。

bottommost()

  • 返回 {Match}

位于大图片最下边的匹配结果。如果没有任何匹配，则返回null。

best()

  • 返回 {Match}

相似度最高的匹配结果。如果没有任何匹配，则返回null。

worst()

  • 返回 {Match}

相似度最低的匹配结果。如果没有任何匹配，则返回null。

sortBy(cmp)

  • cmp {Function}|{string} 比较函数，或者是一个字符串表示排序方向。例如”left”表示将匹配结果按匹配位置从左往右排序、”top”表示将匹配结果按匹配位置从上往下排序，”left-top”表示将匹配结果按匹配位置从左往右、从上往下排序。方向包括left（左）, top （上）, right （右）, bottom（下）。
  • {MatchingResult}

对匹配结果进行排序，并返回排序后的结果。

var result = images.matchTemplate(img, template, {
    max: 100
});
log(result.sortBy("top-right"));

0 条回复 A文章作者 M管理员
    暂无讨论，说说你的看法吧