颜色-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)

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

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

colors.red(color)

  • color {number} | {string} 颜色值
  • return {number}

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

colors.green(color)

  • color {number} | {string} 颜色值
  • return {number}

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

colors.blue(color)

  • color {number} | {string} 颜色值
  • return {number}

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

colors.alpha(color)

  • color {number} | {string} 颜色值
  • return {number}

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

colors.rgb(red, green, blue)

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

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

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

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

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

colors.parseColor(colorStr)

  • colorStr {string} 表示颜色的字符串，例如"#112233"
  • return {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 Eopen in new window)。
    • hs: hs 欧拉距离匹配。hs 为 HSV 空间的色调值。
  • return {Boolean}

返回两个颜色是否相似。

colors.equals(color1, color2)

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

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

log(colors.equals("#112233", "#112234"));
log(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