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]。

meta description
类型 Color
定义于 cocos2d/core/value-types/color.ts:57
BLACK

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

meta description
类型 Color
定义于 cocos2d/core/value-types/color.ts:67
TRANSPARENT

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

meta description
类型 Color
定义于 cocos2d/core/value-types/color.ts:77
GRAY

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

meta description
类型 Color
定义于 cocos2d/core/value-types/color.ts:87
RED

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

meta description
类型 Color
定义于 cocos2d/core/value-types/color.ts:97
GREEN

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

meta description
类型 Color
定义于 cocos2d/core/value-types/color.ts:106
BLUE

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

meta description
类型 Color
定义于 cocos2d/core/value-types/color.ts:115
YELLOW

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

meta description
类型 Color
定义于 cocos2d/core/value-types/color.ts:124
ORANGE

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

meta description
类型 Color
定义于 cocos2d/core/value-types/color.ts:133
CYAN

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

meta description
类型 Color
定义于 cocos2d/core/value-types/color.ts:142
MAGENTA

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

meta description
类型 Color
定义于 cocos2d/core/value-types/color.ts:151
r

获取或者设置红色通道

meta description
类型 number
定义于 cocos2d/core/value-types/color.ts:444
g

获取或者设置绿色通道

meta description
类型 number
定义于 cocos2d/core/value-types/color.ts:456
b

获取或者设置蓝色通道

meta description
类型 number
定义于 cocos2d/core/value-types/color.ts:468
a

获取或者设置透明通道

meta description
类型 number
定义于 cocos2d/core/value-types/color.ts:480

方法

copy

Copy content of a color into another.

meta description
定义于 cocos2d/core/value-types/color.ts:161
clone

Clone a new color.

meta description
定义于 cocos2d/core/value-types/color.ts:176
set

Set the components of a color to the given values.

meta description
定义于 cocos2d/core/value-types/color.ts:187
fromHex

Converts the hexadecimal formal color into rgb formal.

meta description
定义于 cocos2d/core/value-types/color.ts:202
add

Add components of two colors, respectively.

meta description
定义于 cocos2d/core/value-types/color.ts:222
subtract

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

meta description
定义于 cocos2d/core/value-types/color.ts:237
multiply

Multiply components of two colors, respectively.

meta description
定义于 cocos2d/core/value-types/color.ts:252
divide

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

meta description
定义于 cocos2d/core/value-types/color.ts:267
scale

Scales a color by a number.

meta description
定义于 cocos2d/core/value-types/color.ts:282
lerp

Performs a linear interpolation between two colors.

meta description
定义于 cocos2d/core/value-types/color.ts:297
toArray

颜色转数组

meta description
定义于 cocos2d/core/value-types/color.ts:316
参数列表
  • ofs Unknown 数组起始偏移量
fromArray

数组转颜色

meta description
定义于 cocos2d/core/value-types/color.ts:334
参数列表
  • ofs Unknown 数组起始偏移量
constructor
meta description
定义于 cocos2d/core/value-types/color.ts:353
参数列表
  • 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

克隆当前颜色。

meta description
返回 Color
定义于 cocos2d/core/value-types/color.ts:372
示例
var color = new cc.Color();
var newColor = color.clone();// Color {r: 0, g: 0, b: 0, a: 255}
equals

判断两个颜色是否相等。

meta description
返回 Boolean
定义于 cocos2d/core/value-types/color.ts:387
参数列表
示例
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

线性插值

meta description
返回 Color
定义于 cocos2d/core/value-types/color.ts:404
参数列表
  • 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

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

meta description
返回 String
定义于 cocos2d/core/value-types/color.ts:427
示例
var color = cc.Color.WHITE;
color.toString(); // "rgba(255, 255, 255, 255)"
getR

获取当前颜色的红色值。

meta description
返回 Number
定义于 cocos2d/core/value-types/color.ts:492
setR

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

meta description
返回 Color
定义于 cocos2d/core/value-types/color.ts:501
参数列表
  • red Number the new Red component.
示例
var color = new cc.Color();
color.setR(255); // Color {r: 255, g: 0, b: 0, a: 255}
getG

获取当前颜色的绿色值。

meta description
返回 Number
定义于 cocos2d/core/value-types/color.ts:516
setG

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

meta description
返回 Color
定义于 cocos2d/core/value-types/color.ts:525
参数列表
  • green Number the new Green component.
示例
var color = new cc.Color();
color.setG(255); // Color {r: 0, g: 255, b: 0, a: 255}
getB

获取当前颜色的蓝色值。

meta description
返回 Number
定义于 cocos2d/core/value-types/color.ts:540
setB

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

meta description
返回 Color
定义于 cocos2d/core/value-types/color.ts:549
参数列表
  • blue Number the new Blue component.
示例
var color = new cc.Color();
color.setB(255); // Color {r: 0, g: 0, b: 255, a: 255}
getA

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

meta description
返回 Number
定义于 cocos2d/core/value-types/color.ts:564
setA

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

meta description
返回 Color
定义于 cocos2d/core/value-types/color.ts:573
参数列表
  • 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 格式。

meta description
返回 String
定义于 cocos2d/core/value-types/color.ts:589
参数列表
  • 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 进制颜色。

meta description
返回 Color
定义于 cocos2d/core/value-types/color.ts:624
参数列表
示例
var color = cc.Color.BLACK;
color.fromHEX("#FFFF33"); // Color {r: 255, g: 255, b: 51, a: 255};
toHEX

转换为 16 进制。

meta description
返回 String
定义于 cocos2d/core/value-types/color.ts:645
参数列表
  • fmt String "#rgb", "#rrggbb" or "#rrggbbaa".
示例
var color = cc.Color.BLACK;
color.toHEX("#rgb");     // "000";
color.toHEX("#rrggbb");  // "000000";
toRGBValue

转换为 24bit 的 RGB 值。

meta description
返回 Number
定义于 cocos2d/core/value-types/color.ts:685
示例
var color = cc.Color.YELLOW;
color.toRGBValue(); // 16771844;
fromHSV

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

meta description
返回 Color
定义于 cocos2d/core/value-types/color.ts:698
参数列表
示例
var color = cc.Color.YELLOW;
color.fromHSV(0, 0, 1); // Color {r: 255, g: 255, b: 255, a: 255};
toHSV

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

meta description
返回 Object
定义于 cocos2d/core/value-types/color.ts:776
示例
var color = cc.Color.YELLOW;
color.toHSV(); // Object {h: 0.1533864541832669, s: 0.9843137254901961, v: 1};
set

设置颜色

meta description
定义于 cocos2d/core/value-types/color.ts:807
参数列表
multiply

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

meta description
返回 Color
定义于 cocos2d/core/value-types/color.ts:832
参数列表

条与 "" 相匹配的结果

    没有与 "" 匹配的结果