Color Class

Extends ValueType

Module: cc Parent Module: cc

Representation of RGBA colors.

Each color component is a floating point value with a range from 0 to 255.

You can also use the convenience method cc.color to create a new Color.

Index

Properties
  • WHITE Color Solid white, RGBA is [255, 255, 255, 255].
  • BLACK Color Solid black, RGBA is [0, 0, 0, 255].
  • TRANSPARENT Color Transparent, RGBA is [0, 0, 0, 0].
  • GRAY Color Grey, RGBA is [127.5, 127.5, 127.5].
  • RED Color Solid red, RGBA is [255, 0, 0].
  • GREEN Color Solid green, RGBA is [0, 255, 0].
  • BLUE Color Solid blue, RGBA is [0, 0, 255].
  • YELLOW Color Yellow, RGBA is [255, 235, 4].
  • ORANGE Color Orange, RGBA is [255, 127, 0].
  • CYAN Color Cyan, RGBA is [0, 255, 255].
  • MAGENTA Color Magenta, RGBA is [255, 0, 255].
Methods
  • constructor
  • clone Clone a new color from the current color.
  • equals TODO
  • lerp TODO
  • toString TODO
  • getR Gets red channel value
  • setR Sets red value and return the current color object
  • getG Gets green channel value
  • setG Sets green value and return the current color object
  • getB Gets blue channel value
  • setB Sets blue value and return the current color object
  • getA Gets alpha channel value
  • setA Sets alpha value and return the current color object
  • toCSS Convert color to css format.
  • clamp Clamp this color to make all components between 0 to 255。
  • fromHEX Read hex string and store color data into the current color object, the hex string must be formated as rgba or rgb.
  • toHEX TODO
  • toRGBValue Convert to 24bit rgb value.
  • fromHSV TODO
  • toHSV TODO
  • rgb2hsv TODO
  • hsv2rgb TODO

Details

Properties

WHITE

Solid white, RGBA is [255, 255, 255, 255].

meta description
Type Color
Defined in https:/github.com/cocos-creator/engine/blob/master/cocos2d/core/value-types/CCColor.js:77
BLACK

Solid black, RGBA is [0, 0, 0, 255].

meta description
Type Color
Defined in https:/github.com/cocos-creator/engine/blob/master/cocos2d/core/value-types/CCColor.js:85
TRANSPARENT

Transparent, RGBA is [0, 0, 0, 0].

meta description
Type Color
Defined in https:/github.com/cocos-creator/engine/blob/master/cocos2d/core/value-types/CCColor.js:93
GRAY

Grey, RGBA is [127.5, 127.5, 127.5].

meta description
Type Color
Defined in https:/github.com/cocos-creator/engine/blob/master/cocos2d/core/value-types/CCColor.js:101
RED

Solid red, RGBA is [255, 0, 0].

meta description
Type Color
Defined in https:/github.com/cocos-creator/engine/blob/master/cocos2d/core/value-types/CCColor.js:109
GREEN

Solid green, RGBA is [0, 255, 0].

meta description
Type Color
Defined in https:/github.com/cocos-creator/engine/blob/master/cocos2d/core/value-types/CCColor.js:117
BLUE

Solid blue, RGBA is [0, 0, 255].

meta description
Type Color
Defined in https:/github.com/cocos-creator/engine/blob/master/cocos2d/core/value-types/CCColor.js:125
YELLOW

Yellow, RGBA is [255, 235, 4].

meta description
Type Color
Defined in https:/github.com/cocos-creator/engine/blob/master/cocos2d/core/value-types/CCColor.js:133
ORANGE

Orange, RGBA is [255, 127, 0].

meta description
Type Color
Defined in https:/github.com/cocos-creator/engine/blob/master/cocos2d/core/value-types/CCColor.js:141
CYAN

Cyan, RGBA is [0, 255, 255].

meta description
Type Color
Defined in https:/github.com/cocos-creator/engine/blob/master/cocos2d/core/value-types/CCColor.js:149
MAGENTA

Magenta, RGBA is [255, 0, 255].

meta description
Type Color
Defined in https:/github.com/cocos-creator/engine/blob/master/cocos2d/core/value-types/CCColor.js:157

Methods

constructor
meta description
Defined in https:/github.com/cocos-creator/engine/blob/master/cocos2d/core/value-types/CCColor.js:52
Parameters
  • 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

Clone a new color from the current color.

meta description
Returns Color
Defined in https:/github.com/cocos-creator/engine/blob/master/cocos2d/core/value-types/CCColor.js:176
Examples
var color = new cc.Color();
var newColor = color.clone();// Color {r: 0, g: 0, b: 0, a: 255}
equals

TODO

meta description
Returns Boolean
Defined in https:/github.com/cocos-creator/engine/blob/master/cocos2d/core/value-types/CCColor.js:191
Parameters
Examples
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

TODO

meta description
Returns Color
Defined in https:/github.com/cocos-creator/engine/blob/master/cocos2d/core/value-types/CCColor.js:208
Parameters
  • to Color
  • ratio number the interpolation coefficient.
  • out Color optional, the receiving vector.
Examples
// 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

TODO

meta description
Returns String
Defined in https:/github.com/cocos-creator/engine/blob/master/cocos2d/core/value-types/CCColor.js:231
Examples
var color = cc.Color.WHITE;
color.toString(); // "rgba(255, 255, 255, 255)"
getR

Gets red channel value

meta description
Returns Number
Defined in https:/github.com/cocos-creator/engine/blob/master/cocos2d/core/value-types/CCColor.js:248
setR

Sets red value and return the current color object

meta description
Returns Color
Defined in https:/github.com/cocos-creator/engine/blob/master/cocos2d/core/value-types/CCColor.js:257
Parameters
  • red Number the new Red component.
Examples
var color = new cc.Color();
color.setR(255); // Color {r: 255, g: 0, b: 0, a: 255}
getG

Gets green channel value

meta description
Returns Number
Defined in https:/github.com/cocos-creator/engine/blob/master/cocos2d/core/value-types/CCColor.js:271
setG

Sets green value and return the current color object

meta description
Returns Color
Defined in https:/github.com/cocos-creator/engine/blob/master/cocos2d/core/value-types/CCColor.js:280
Parameters
  • green Number the new Green component.
Examples
var color = new cc.Color();
color.setG(255); // Color {r: 0, g: 255, b: 0, a: 255}
getB

Gets blue channel value

meta description
Returns Number
Defined in https:/github.com/cocos-creator/engine/blob/master/cocos2d/core/value-types/CCColor.js:294
setB

Sets blue value and return the current color object

meta description
Returns Color
Defined in https:/github.com/cocos-creator/engine/blob/master/cocos2d/core/value-types/CCColor.js:303
Parameters
  • blue Number the new Blue component.
Examples
var color = new cc.Color();
color.setB(255); // Color {r: 0, g: 0, b: 255, a: 255}
getA

Gets alpha channel value

meta description
Returns Number
Defined in https:/github.com/cocos-creator/engine/blob/master/cocos2d/core/value-types/CCColor.js:317
setA

Sets alpha value and return the current color object

meta description
Returns Color
Defined in https:/github.com/cocos-creator/engine/blob/master/cocos2d/core/value-types/CCColor.js:326
Parameters
  • alpha Number the new Alpha component.
Examples
var color = new cc.Color();
color.setA(0); // Color {r: 0, g: 0, b: 0, a: 0}
toCSS

Convert color to css format.

meta description
Returns String
Defined in https:/github.com/cocos-creator/engine/blob/master/cocos2d/core/value-types/CCColor.js:346
Parameters
  • opt String "rgba", "rgb", "#rgb" or "#rrggbb".
Examples
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

Clamp this color to make all components between 0 to 255。

meta description
Defined in https:/github.com/cocos-creator/engine/blob/master/cocos2d/core/value-types/CCColor.js:375
Examples
var color = new cc.Color(1000, 0, 0, 255);
color.clamp();
cc.log(color); // (255, 0, 0, 255)
fromHEX

Read hex string and store color data into the current color object, the hex string must be formated as rgba or rgb.

meta description
Returns Color
Defined in https:/github.com/cocos-creator/engine/blob/master/cocos2d/core/value-types/CCColor.js:389
Parameters
Examples
var color = cc.Color.BLACK;
color.fromHEX("#FFFF33"); // Color {r: 255, g: 255, b: 51, a: 255};
toHEX

TODO

meta description
Returns String
Defined in https:/github.com/cocos-creator/engine/blob/master/cocos2d/core/value-types/CCColor.js:409
Parameters
  • fmt String "#rgb" or "#rrggbb".
Examples
var color = cc.Color.BLACK;
color.toHEX("#rgb");     // "000";
color.toHEX("#rrggbb");  // "000000";
toRGBValue

Convert to 24bit rgb value.

meta description
Returns Number
Defined in https:/github.com/cocos-creator/engine/blob/master/cocos2d/core/value-types/CCColor.js:444
Examples
var color = cc.Color.YELLOW;
color.toRGBValue(); // 16771844;
fromHSV

TODO

meta description
Returns Color
Defined in https:/github.com/cocos-creator/engine/blob/master/cocos2d/core/value-types/CCColor.js:457
Parameters
Examples
var color = cc.Color.YELLOW;
color.fromHSV(0, 0, 1); // Color {r: 255, g: 255, b: 255, a: 255};
toHSV

TODO

meta description
Returns Object
Defined in https:/github.com/cocos-creator/engine/blob/master/cocos2d/core/value-types/CCColor.js:476
Examples
var color = cc.Color.YELLOW;
color.toHSV(); // Object {h: 0.1533864541832669, s: 0.9843137254901961, v: 1};
rgb2hsv

TODO

meta description
Returns Object
Defined in https:/github.com/cocos-creator/engine/blob/master/cocos2d/core/value-types/CCColor.js:504
Parameters
  • r Number red, must be [0, 255].
  • g Number red, must be [0, 255].
  • b Number red, must be [0, 255].
Examples
cc.Color.rgb2hsv(255, 255, 255); // Object {h: 0, s: 0, v: 1};
hsv2rgb

TODO

meta description
Returns Object
Defined in https:/github.com/cocos-creator/engine/blob/master/cocos2d/core/value-types/CCColor.js:538
Parameters
Examples
cc.Color.hsv2rgb(0, 0, 1); // Object {r: 255, g: 255, b: 255};

results matching ""

    No results matching ""