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.
• 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 数组转颜色
• 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.

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 数组起始偏移量

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