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#

colors.toString(color)#

• color {number} 整数 RGB 颜色值
• 返回 {string}

返回颜色值的字符串，格式为 "#AARRGGBB"。

colors.red(color)#

• color {number} | {string} 颜色值
• 返回 {number}

返回颜色 color 的 R 通道的值，范围 0~255.

colors.green(color)#

• color {number} | {string} 颜色值
• 返回 {number}

返回颜色 color 的 G 通道的值，范围 0~255.

colors.blue(color)#

• color {number} | {string} 颜色值
• 返回 {number}

返回颜色 color 的 B 通道的值，范围 0~255.

colors.alpha(color)#

• color {number} | {string} 颜色值
• 返回 {number}

返回颜色 color 的 Alpha 通道的值，范围 0~255.

colors.rgb(red, green, blue)#

• red {number} 颜色的 R 通道的值
• blue {number} 颜色的 G 通道的值
• green {number} 颜色的 B 通道的值
• 返回 {number}

返回这些颜色通道构成的整数颜色值。Alpha 通道将是 255（不透明）。

colors.argb(alpha, red, green, blue)#

• alpha {number} 颜色的 Alpha 通道的值
• red {number} 颜色的 R 通道的值
• green {number} 颜色的 G 通道的值
• blue {number} 颜色的 B 通道的值
• 返回 {number}

返回这些颜色通道构成的整数颜色值。

colors.parseColor(colorStr)#

• colorStr {string} 表示颜色的字符串，例如"#112233"
• 返回 {number}

返回颜色的整数值。

colors.isSimilar(color2, color2[, threshold, algorithm])#

• color1 {number} | {string} 颜色值 1
• color1 {number} | {string} 颜色值 2
• threshold {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)#

• color1 {number} | {string} 颜色值 1
• color1 {number} | {string} 颜色值 2
• 返回 {Boolean}

返回两个颜色是否相等。*注意该函数会忽略 Alpha 通道的值进行比较。

1log(colors.equals("#112233", "#112234"));
2log(colors.equals(0xff112233, 0xff223344));

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