-
Images#
+
colors#
+
在Auto.js有两种方式表示一个颜色。
+
一种是使用一个字符串"#AARRGGBB"或"#RRGGBB"，其中 AA 是Alpha通道(透明度)的值，RR 是R通道(红色)的值，GG 是G通道(绿色)的值，BB是B通道(蓝色)的值。例如"#ffffff"表示白色, "#7F000000"表示半透明的黑色。
+
另一种是使用一个16进制的"32位整数" 0xAARRGGBB 来表示一个颜色，例如 0xFF112233表示颜色"#112233", 0x11223344表示颜色"#11223344"。
+
可以通过colors.toString()把颜色整数转换为字符串，通过colors.parseColor()把颜色字符串解析为颜色整数。
+
colors.toString(color)#
+
返回颜色值的字符串，格式为 "#AARRGGBB"。
+
colors.red(color)#
+
返回颜色color的R通道的值，范围0~255.
+
colors.green(color)#
+
返回颜色color的G通道的值，范围0~255.
+
colors.blue(color)#
+
返回颜色color的B通道的值，范围0~255.
+
colors.alpha(color)#
+
返回颜色color的Alpha通道的值，范围0~255.
+
colors.rgb(red, green, blue)#
+
返回这些颜色通道构成的整数颜色值。Alpha通道将是255（不透明）。
+
colors.argb(alpha, red, green, blue)#
+
返回这些颜色通道构成的整数颜色值。
+
colors.parseColor(colorStr)#
+
返回颜色的整数值。
+
colors.isSimilar(color2, color2[, threshold, algorithm])#
+
+color1 <number> | <string> 颜色值1color1 <number> | <string> 颜色值2threshold <number> 颜色相似度临界值，默认为4。取值范围为0~255。这个值越大表示允许的相似程度越小，如果这个值为0，则两个颜色相等时该函数才会返回true。algorithm <string> 颜色匹配算法，默认为"diff", 包括:
+- "diff": 差值匹配。与给定颜色的R、G、B差的绝对值之和小于threshold时匹配。
+- "rgb": rgb欧拉距离相似度。与给定颜色color的rgb欧拉距离小于等于threshold时匹配。
+- "rgb+": 加权rgb欧拉距离匹配(LAB Delta E)。
+- "hs": hs欧拉距离匹配。hs为HSV空间的色调值。
+
+- 返回 <Boolean>
+
+
返回两个颜色是否相似。
+
colors.equals(color1, color2)#
+
返回两个颜色是否相等。*注意该函数会忽略Alpha通道的值进行比较。
+
log(colors.equals("#112233", "#112234"));
+log(colors.equals(0xFF112233, 0xFF223344));
+
Images#
images模块提供了一些手机设备中常见的图片处理函数，包括截图、读写图片、图片剪裁、找色、找图等。
images.requestScreenCapture([landscape])#
向系统申请屏幕截图权限，返回是否请求成功。
第一次使用该函数会弹出截图权限请求，建议选择“总是允许”。
-
这个函数只是申请截图权限，并不会真正执行截图，真正的截图函数是[captureScreen][]。
-
该函数在截图脚本中只需执行一次，而无需每次调用[captureScreen][]都调用一次。
+
这个函数只是申请截图权限，并不会真正执行截图，真正的截图函数是captureScreen()。
+
该函数在截图脚本中只需执行一次，而无需每次调用captureScreen()都调用一次。
如果不指定landscape值，则截图方向由当前设备屏幕方向决定，因此务必注意执行该函数时的屏幕方向。
建议在本软件界面运行该函数，在其他软件界面运行时容易出现一闪而过的黑屏现象。
示例:
@@ -379,48 +464,6 @@ if(p){
threshold: threshold
})
该函数也可以作为全局函数使用。
-
colors#
-
colors是颜色处理的工具对象。包含一些常用方法，包括android.graphics.Color的所有方法以及toString方法。
-
colors.toString(color)#
-
返回颜色值的字符串，格式为 #AARRGGBB。
-
colors.red(color)#
-
返回颜色color的R通道的值，范围0~255.
-
colors.green(color)#
-
返回颜色color的G通道的值，范围0~255.
-
colors.blue(color)#
-
返回颜色color的B通道的值，范围0~255.
-
colors.alpha(color)#
-
返回颜色color的Alpha通道的值，范围0~255.
-
colors.rgb(red, green, blue)#
-
返回这些颜色通道构成的整数颜色值。Alpha通道将是255（不透明）。
-
colors.argb(alpha, red, green, blue)#
-
返回这些颜色通道构成的整数颜色值。
Image#
表示一张图片，可以是截图的图片，或者本地读取的图片，或者从网络获取的图片。
Image.getWidth()#
diff --git a/app/src/main/assets/docs/overview.html b/app/src/main/assets/docs/overview.html
index 41a2c3ae..2350f9f2 100644
--- a/app/src/main/assets/docs/overview.html
+++ b/app/src/main/assets/docs/overview.html
@@ -103,6 +103,7 @@
threads: 多线程支持。
ui: UI界面。用于显示自定义的UI界面，和用户交互。
+
除此之外，Auto.js内置了对Promise。