Color 类型

继承于 ValueType

模块: cc 父模块: cc

cc.Color 用于表示颜色。

它包含 RGBA 四个以浮点数保存的颜色分量，每个的值都在 0 到 255 之间。

您也可以通过使用 cc.color 的便捷方法来创建一个新的 Color。

索引

属性（properties）

• WHITE Color 纯白色，RGBA 是 [255, 255, 255, 255]。
• BLACK Color 纯黑色，RGBA 是 [0, 0, 0, 255]。
• TRANSPARENT Color 透明，RGBA 是 [0, 0, 0, 0]。
• GRAY Color 灰色，RGBA 是 [127.5, 127.5, 127.5]。
• RED Color 纯红色，RGBA 是 [255, 0, 0]。
• GREEN Color 纯绿色，RGBA 是 [0, 255, 0]。
• BLUE Color 纯蓝色，RGBA 是 [0, 0, 255]。
• YELLOW Color 黄色，RGBA 是 [255, 235, 4]。
• ORANGE Color 橙色，RGBA 是 [255, 127, 0]。
• CYAN Color 青色，RGBA 是 [0, 255, 255]。
• MAGENTA Color 洋红色（品红色），RGBA 是 [255, 0, 255]。
• r number 获取或者设置红色通道
• g number 获取或者设置绿色通道
• b number 获取或者设置蓝色通道
• a number 获取或者设置透明通道

方法

• copy Copy content of a color into another.
• clone Clone a new color.
• set Set the components of a color to the given values.
• fromHex Converts the hexadecimal formal color into rgb formal.
• fromHEX Converts the hexadecimal formal color into rgb formal.
• add Add components of two colors, respectively.
• subtract Subtract components of color b from components of color a, respectively.
• multiply Multiply components of two colors, respectively.
• divide Divide components of color a by components of color b, respectively.
• scale Scales a color by a number.
• lerp Performs a linear interpolation between two colors.
• toArray 颜色转数组
• fromArray 数组转颜色
• premultiplyAlpha 颜色 RGB 预乘 Alpha 通道
• constructor
• clone 克隆当前颜色。
• equals 判断两个颜色是否相等。
• lerp 线性插值
• toString 转换为方便阅读的字符串。
• getR 获取当前颜色的红色值。
• setR 设置当前的红色值，并返回当前对象。
• getG 获取当前颜色的绿色值。
• setG 设置当前的绿色值，并返回当前对象。
• getB 获取当前颜色的蓝色值。
• setB 设置当前的蓝色值，并返回当前对象。
• getA 获取当前颜色的透明度值。
• setA 设置当前的透明度，并返回当前对象。
• toCSS 转换为 CSS 格式。
• fromHEX 读取 16 进制颜色。
• toHEX 转换为 16 进制。
• toRGBValue 转换为 24bit 的 RGB 值。
• fromHSV 读取 HSV（色彩模型）格式。
• toHSV 转换为 HSV（色彩模型）格式。
• set 设置颜色
• multiply 将当前颜色乘以与指定颜色

Details

属性（properties）

WHITE

纯白色，RGBA 是 [255, 255, 255, 255]。

BLACK

纯黑色，RGBA 是 [0, 0, 0, 255]。

TRANSPARENT

透明，RGBA 是 [0, 0, 0, 0]。

GRAY

灰色，RGBA 是 [127.5, 127.5, 127.5]。

RED

纯红色，RGBA 是 [255, 0, 0]。

GREEN

纯绿色，RGBA 是 [0, 255, 0]。

BLUE

纯蓝色，RGBA 是 [0, 0, 255]。

YELLOW

黄色，RGBA 是 [255, 235, 4]。

ORANGE

橙色，RGBA 是 [255, 127, 0]。

CYAN

青色，RGBA 是 [0, 255, 255]。

MAGENTA

洋红色（品红色），RGBA 是 [255, 0, 255]。

r

获取或者设置红色通道

g

获取或者设置绿色通道

b

获取或者设置蓝色通道

a

获取或者设置透明通道

方法

copy

Copy content of a color into another.

clone

Clone a new color.

set

Set the components of a color to the given values.

fromHex

Converts the hexadecimal formal color into rgb formal.

fromHEX

Converts the hexadecimal formal color into rgb formal.

add

Add components of two colors, respectively.

subtract

Subtract components of color b from components of color a, respectively.

multiply

Multiply components of two colors, respectively.

divide

Divide components of color a by components of color b, respectively.

scale

Scales a color by a number.

lerp

Performs a linear interpolation between two colors.

toArray

颜色转数组

参数列表

• ofs Unknown 数组起始偏移量

fromArray

数组转颜色

参数列表

• ofs Unknown 数组起始偏移量

premultiplyAlpha

颜色 RGB 预乘 Alpha 通道

参数列表

• out Unknown 返回颜色
• color Unknown 预乘处理的目标颜色

constructor

参数列表

• r Number red component of the color, default value is 0.
• g Number green component of the color, defualt value is 0.
• b Number blue component of the color, default value is 0.
• a Number alpha component of the color, default value is 255.

clone

克隆当前颜色。

示例

var color = new cc.Color();
var newColor = color.clone();// Color {r: 0, g: 0, b: 0, a: 255}

equals

判断两个颜色是否相等。

参数列表

• other Color

示例

var color1 = cc.Color.WHITE;
var color2 = new cc.Color(255, 255, 255);
cc.log(color1.equals(color2)); // true;
color2 = cc.Color.RED;
cc.log(color2.equals(color1)); // false;

lerp

线性插值

参数列表

• to Color
• ratio number the interpolation coefficient.
• out Color optional, the receiving vector.

示例

// Converts a white color to a black one trough time.
update: function (dt) {
    var color = this.node.color;
    if (color.equals(cc.Color.BLACK)) {
        return;
    }
    this.ratio += dt * 0.1;
    this.node.color = cc.Color.WHITE.lerp(cc.Color.BLACK, ratio);
}

toString

转换为方便阅读的字符串。

示例

var color = cc.Color.WHITE;
color.toString(); // "rgba(255, 255, 255, 255)"

getR

获取当前颜色的红色值。

setR

设置当前的红色值，并返回当前对象。

参数列表

• red Number the new Red component.

示例

var color = new cc.Color();
color.setR(255); // Color {r: 255, g: 0, b: 0, a: 255}

getG

获取当前颜色的绿色值。

setG

设置当前的绿色值，并返回当前对象。

参数列表

• green Number the new Green component.

示例

var color = new cc.Color();
color.setG(255); // Color {r: 0, g: 255, b: 0, a: 255}

getB

获取当前颜色的蓝色值。

setB

设置当前的蓝色值，并返回当前对象。

参数列表

• blue Number the new Blue component.

示例

var color = new cc.Color();
color.setB(255); // Color {r: 0, g: 0, b: 255, a: 255}

getA

获取当前颜色的透明度值。

setA

设置当前的透明度，并返回当前对象。

参数列表

• alpha Number the new Alpha component.

示例

var color = new cc.Color();
color.setA(0); // Color {r: 0, g: 0, b: 0, a: 0}

toCSS

转换为 CSS 格式。

参数列表

• opt String "rgba", "rgb", "#rgb" or "#rrggbb".

示例

var color = cc.Color.BLACK;
color.toCSS();          // "rgba(0,0,0,1.00)";
color.toCSS("rgba");    // "rgba(0,0,0,1.00)";
color.toCSS("rgb");     // "rgba(0,0,0)";
color.toCSS("#rgb");    // "#000";
color.toCSS("#rrggbb"); // "#000000";

fromHEX

读取 16 进制颜色。

参数列表

• hexString String

示例

var color = cc.Color.BLACK;
color.fromHEX("#FFFF33"); // Color {r: 255, g: 255, b: 51, a: 255};

toHEX

转换为 16 进制。

参数列表

• fmt String "#rgb", "#rrggbb" or "#rrggbbaa".

示例

var color = cc.Color.BLACK;
color.toHEX("#rgb");     // "000";
color.toHEX("#rrggbb");  // "000000";

toRGBValue

转换为 24bit 的 RGB 值。

示例

var color = cc.Color.YELLOW;
color.toRGBValue(); // 16771844;

fromHSV

读取 HSV（色彩模型）格式。

参数列表

• h Number
• s Number
• v Number

示例

var color = cc.Color.YELLOW;
color.fromHSV(0, 0, 1); // Color {r: 255, g: 255, b: 255, a: 255};

toHSV

转换为 HSV（色彩模型）格式。

示例

var color = cc.Color.YELLOW;
color.toHSV(); // Object {h: 0.1533864541832669, s: 0.9843137254901961, v: 1};

set

设置颜色

参数列表

• color Color

multiply

将当前颜色乘以与指定颜色

参数列表

• other Color