Color
类型
继承于 ValueType
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]。
方法
constructor
clone
克隆当前颜色。equals
判断两个颜色是否相等。lerp
线性插值toString
转换为方便阅读的字符串。getR
获取当前颜色的红色值。setR
设置当前的红色值,并返回当前对象。getG
获取当前颜色的绿色值。setG
设置当前的绿色值,并返回当前对象。getB
获取当前颜色的蓝色值。setB
设置当前的蓝色值,并返回当前对象。getA
获取当前颜色的透明度值。setA
设置当前的透明度,并返回当前对象。toCSS
转换为 CSS 格式。clamp
限制颜色数值,在 0 到 255 之间。fromHEX
读取 16 进制颜色。toHEX
转换为 16 进制。toRGBValue
转换为 24bit 的 RGB 值。fromHSV
读取 HSV(色彩模型)格式。toHSV
转换为 HSV(色彩模型)格式。rgb2hsv
RGB 转换为 HSV。hsv2rgb
HSV 转换为 RGB。
Details
属性(properties)
WHITE
纯白色,RGBA 是 [255, 255, 255, 255]。
meta | description |
---|---|
类型 | Color |
定义于 | https:/github.com/cocos-creator/engine/blob/master/cocos2d/core/value-types/CCColor.js:77 |
BLACK
纯黑色,RGBA 是 [0, 0, 0, 255]。
meta | description |
---|---|
类型 | Color |
定义于 | https:/github.com/cocos-creator/engine/blob/master/cocos2d/core/value-types/CCColor.js:85 |
TRANSPARENT
透明,RGBA 是 [0, 0, 0, 0]。
meta | description |
---|---|
类型 | Color |
定义于 | https:/github.com/cocos-creator/engine/blob/master/cocos2d/core/value-types/CCColor.js:93 |
GRAY
灰色,RGBA 是 [127.5, 127.5, 127.5]。
meta | description |
---|---|
类型 | Color |
定义于 | https:/github.com/cocos-creator/engine/blob/master/cocos2d/core/value-types/CCColor.js:101 |
RED
纯红色,RGBA 是 [255, 0, 0]。
meta | description |
---|---|
类型 | Color |
定义于 | https:/github.com/cocos-creator/engine/blob/master/cocos2d/core/value-types/CCColor.js:109 |
GREEN
纯绿色,RGBA 是 [0, 255, 0]。
meta | description |
---|---|
类型 | Color |
定义于 | https:/github.com/cocos-creator/engine/blob/master/cocos2d/core/value-types/CCColor.js:117 |
BLUE
纯蓝色,RGBA 是 [0, 0, 255]。
meta | description |
---|---|
类型 | Color |
定义于 | https:/github.com/cocos-creator/engine/blob/master/cocos2d/core/value-types/CCColor.js:125 |
YELLOW
黄色,RGBA 是 [255, 235, 4]。
meta | description |
---|---|
类型 | Color |
定义于 | https:/github.com/cocos-creator/engine/blob/master/cocos2d/core/value-types/CCColor.js:133 |
ORANGE
橙色,RGBA 是 [255, 127, 0]。
meta | description |
---|---|
类型 | Color |
定义于 | https:/github.com/cocos-creator/engine/blob/master/cocos2d/core/value-types/CCColor.js:141 |
CYAN
青色,RGBA 是 [0, 255, 255]。
meta | description |
---|---|
类型 | Color |
定义于 | https:/github.com/cocos-creator/engine/blob/master/cocos2d/core/value-types/CCColor.js:149 |
MAGENTA
洋红色(品红色),RGBA 是 [255, 0, 255]。
meta | description |
---|---|
类型 | Color |
定义于 | https:/github.com/cocos-creator/engine/blob/master/cocos2d/core/value-types/CCColor.js:157 |
方法
constructor
meta | description |
---|---|
定义于 | https:/github.com/cocos-creator/engine/blob/master/cocos2d/core/value-types/CCColor.js:52 |
参数列表
- 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 |
定义于 | https:/github.com/cocos-creator/engine/blob/master/cocos2d/core/value-types/CCColor.js:176 |
示例
var color = new cc.Color();
var newColor = color.clone();// Color {r: 0, g: 0, b: 0, a: 255}
equals
判断两个颜色是否相等。
meta | description |
---|---|
返回 | Boolean |
定义于 | https:/github.com/cocos-creator/engine/blob/master/cocos2d/core/value-types/CCColor.js:191 |
参数列表
- 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
线性插值
meta | description |
---|---|
返回 | Color |
定义于 | https:/github.com/cocos-creator/engine/blob/master/cocos2d/core/value-types/CCColor.js:208 |
参数列表
示例
// 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 |
定义于 | https:/github.com/cocos-creator/engine/blob/master/cocos2d/core/value-types/CCColor.js:231 |
示例
var color = cc.Color.WHITE;
color.toString(); // "rgba(255, 255, 255, 255)"
getR
获取当前颜色的红色值。
meta | description |
---|---|
返回 | Number |
定义于 | https:/github.com/cocos-creator/engine/blob/master/cocos2d/core/value-types/CCColor.js:248 |
setR
设置当前的红色值,并返回当前对象。
meta | description |
---|---|
返回 | Color |
定义于 | https:/github.com/cocos-creator/engine/blob/master/cocos2d/core/value-types/CCColor.js:257 |
参数列表
- 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 |
定义于 | https:/github.com/cocos-creator/engine/blob/master/cocos2d/core/value-types/CCColor.js:271 |
setG
设置当前的绿色值,并返回当前对象。
meta | description |
---|---|
返回 | Color |
定义于 | https:/github.com/cocos-creator/engine/blob/master/cocos2d/core/value-types/CCColor.js:280 |
参数列表
- 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 |
定义于 | https:/github.com/cocos-creator/engine/blob/master/cocos2d/core/value-types/CCColor.js:294 |
setB
设置当前的蓝色值,并返回当前对象。
meta | description |
---|---|
返回 | Color |
定义于 | https:/github.com/cocos-creator/engine/blob/master/cocos2d/core/value-types/CCColor.js:303 |
参数列表
- 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 |
定义于 | https:/github.com/cocos-creator/engine/blob/master/cocos2d/core/value-types/CCColor.js:317 |
setA
设置当前的透明度,并返回当前对象。
meta | description |
---|---|
返回 | Color |
定义于 | https:/github.com/cocos-creator/engine/blob/master/cocos2d/core/value-types/CCColor.js:326 |
参数列表
- 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 |
定义于 | https:/github.com/cocos-creator/engine/blob/master/cocos2d/core/value-types/CCColor.js:346 |
参数列表
- opt String "rgba", "rgb", "#rgb" or "#rrggbb".
示例
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 之间。
meta | description |
---|---|
定义于 | https:/github.com/cocos-creator/engine/blob/master/cocos2d/core/value-types/CCColor.js:375 |
示例
var color = new cc.Color(1000, 0, 0, 255);
color.clamp();
cc.log(color); // (255, 0, 0, 255)
fromHEX
读取 16 进制颜色。
meta | description |
---|---|
返回 | Color |
定义于 | https:/github.com/cocos-creator/engine/blob/master/cocos2d/core/value-types/CCColor.js:389 |
参数列表
- hexString String
示例
var color = cc.Color.BLACK;
color.fromHEX("#FFFF33"); // Color {r: 255, g: 255, b: 51, a: 255};
toHEX
转换为 16 进制。
meta | description |
---|---|
返回 | String |
定义于 | https:/github.com/cocos-creator/engine/blob/master/cocos2d/core/value-types/CCColor.js:409 |
参数列表
- fmt String "#rgb" or "#rrggbb".
示例
var color = cc.Color.BLACK;
color.toHEX("#rgb"); // "000";
color.toHEX("#rrggbb"); // "000000";
toRGBValue
转换为 24bit 的 RGB 值。
meta | description |
---|---|
返回 | Number |
定义于 | https:/github.com/cocos-creator/engine/blob/master/cocos2d/core/value-types/CCColor.js:444 |
示例
var color = cc.Color.YELLOW;
color.toRGBValue(); // 16771844;
fromHSV
读取 HSV(色彩模型)格式。
meta | description |
---|---|
返回 | Color |
定义于 | https:/github.com/cocos-creator/engine/blob/master/cocos2d/core/value-types/CCColor.js:457 |
参数列表
示例
var color = cc.Color.YELLOW;
color.fromHSV(0, 0, 1); // Color {r: 255, g: 255, b: 255, a: 255};
toHSV
转换为 HSV(色彩模型)格式。
meta | description |
---|---|
返回 | Object |
定义于 | https:/github.com/cocos-creator/engine/blob/master/cocos2d/core/value-types/CCColor.js:476 |
示例
var color = cc.Color.YELLOW;
color.toHSV(); // Object {h: 0.1533864541832669, s: 0.9843137254901961, v: 1};
rgb2hsv
RGB 转换为 HSV。
meta | description |
---|---|
返回 | Object |
定义于 | https:/github.com/cocos-creator/engine/blob/master/cocos2d/core/value-types/CCColor.js:504 |
参数列表
示例
cc.Color.rgb2hsv(255, 255, 255); // Object {h: 0, s: 0, v: 1};
hsv2rgb
HSV 转换为 RGB。
meta | description |
---|---|
返回 | Object |
定义于 | https:/github.com/cocos-creator/engine/blob/master/cocos2d/core/value-types/CCColor.js:538 |
参数列表
示例
cc.Color.hsv2rgb(0, 0, 1); // Object {r: 255, g: 255, b: 255};