Cocos Creator API

1.2.0

Cocos Creator is a highly customizable game development tool that utilizes the power of cocos2d-x.

Color

继承于 ValueType
模块: cc

cc.Color 用于表示颜色。

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

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

属性(properties)

WHITE Color static

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

BLACK Color static

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

TRANSPARENT Color static

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

GRAY Color static

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

RED Color static

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

GREEN Color static

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

BLUE Color static

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

YELLOW Color static

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

ORANGE Color static

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

CYAN Color static

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

MAGENTA Color static

洋红色(品红色),RGBA 是 [255, 0, 255]。

There are no properties that match your current filter settings. You can change your filter settings in the index section on this page. index

方法

Color
(
  • [r =0]
  • [g =0]
  • [b =0]
  • [a =255]
)
Color

名称 类型 描述
r optional Number 0

red component of the color, default value is 0.

g optional Number 0

green component of the color, defualt value is 0.

b optional Number 0

blue component of the color, default value is 0.

a optional Number 255

alpha component of the color, default value is 255.

返回:

类型: Color

clone ( ) Color

克隆当前颜色。

返回:

类型: Color

Newly created color.

示例:

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

equals
(
  • other
)
Boolean

判断两个颜色是否相等。

名称 类型 描述
other Color
  • r Number optional , default: 0

    red component of the color, default value is 0.

  • g Number optional , default: 0

    green component of the color, defualt value is 0.

  • b Number optional , default: 0

    blue component of the color, default value is 0.

  • a Number optional , default: 255

    alpha component of the color, default value is 255.

返回:

类型: Boolean

示例:

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
  • ratio
  • [out ]
)
Color

线性插值

名称 类型 描述
to Color
  • r Number optional , default: 0

    red component of the color, default value is 0.

  • g Number optional , default: 0

    green component of the color, defualt value is 0.

  • b Number optional , default: 0

    blue component of the color, default value is 0.

  • a Number optional , default: 255

    alpha component of the color, default value is 255.

ratio number

the interpolation coefficient.

out optional Color

optional, the receiving vector.

  • r Number optional , default: 0

    red component of the color, default value is 0.

  • g Number optional , default: 0

    green component of the color, defualt value is 0.

  • b Number optional , default: 0

    blue component of the color, default value is 0.

  • a Number optional , default: 255

    alpha component of the color, default value is 255.

返回:

类型: Color

示例:

// 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 ( ) String

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

返回:

类型: String

示例:

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

setR
(
  • red
)
Color

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

名称 类型 描述
red Number

the new Red component.

返回:

类型: Color

this color.

示例:

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

setG
(
  • green
)
Color

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

名称 类型 描述
green Number

the new Green component.

返回:

类型: Color

this color.

示例:

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

setB
(
  • blue
)
Color

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

名称 类型 描述
blue Number

the new Blue component.

返回:

类型: Color

this color.

示例:

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

setA
(
  • alpha
)
Color

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

名称 类型 描述
alpha Number

the new Alpha component.

返回:

类型: Color

this color.

示例:

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

toCSS
(
  • opt
)
String

转换为 CSS 格式。

名称 类型 描述
opt String

"rgba", "rgb", "#rgb" or "#rrggbb".

返回:

类型: String

示例:

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

clamp ( )

限制颜色数值,在 0 到 255 之间。

示例:

var color = new cc.Color(1000, 0, 0, 255);
color.clamp();
cc.log(color); // (255, 0, 0, 255)

fromHEX
(
  • hexString
)
Color

读取 16 进制。

名称 类型 描述
hexString String

返回:

类型: Color

示例:

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

toHEX
(
  • fmt
)
String

转换为 16 进制。

名称 类型 描述
fmt String

"#rgb" or "#rrggbb".

返回:

类型: String

示例:

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

toRGBValue ( ) Number

转换为 24bit 的 RGB 值。

返回:

类型: Number

示例:

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

fromHSV
(
  • h
  • s
  • v
)
Color

读取 HSV(色彩模型)格式。

名称 类型 描述
h Number
s Number
v Number

返回:

类型: Color

示例:

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

toHSV ( ) Object

转换为 HSV(色彩模型)格式。

返回:

类型: Object

{h: number, s: number, v: number}.

示例:

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

rgb2hsv
(
  • r
  • g
  • b
)
Object static

RGB 转换为 HSV。

名称 类型 描述
r Number

red, must be [0, 255].

g Number

red, must be [0, 255].

b Number

red, must be [0, 255].

返回:

类型: Object

{h: number, s: number, v: number}.

示例:

cc.Color.rgb2hsv(255, 255, 255); // Object {h: 0, s: 0, v: 1};

hsv2rgb
(
  • h
  • s
  • v
)
Object static

HSV 转换为 RGB。

名称 类型 描述
h Number
s Number
v Number

返回:

类型: Object

{r: number, g: number, b: number}}, rgb will be in [0, 255].

示例:

cc.Color.hsv2rgb(0, 0, 1); // Object {r: 255, g: 255, b: 255};

There are no methods that match your current filter settings. You can change your filter settings in the index section on this page. index