Color

Representation of an RGBA color.

Summary

Static Properties

BLACK	A constant color set to black [0, 0, 0, 1].[read only]
BLUE	A constant color set to blue [0, 0, 1, 1].[read only]
CYAN	A constant color set to cyan [0, 1, 1, 1].[read only]
GRAY	A constant color set to gray [0.[read only]
GREEN	A constant color set to green [0, 1, 0, 1].[read only]
MAGENTA	A constant color set to magenta [1, 0, 1, 1].[read only]
RED	A constant color set to red [1, 0, 0, 1].[read only]
WHITE	A constant color set to white [1, 1, 1, 1].[read only]
YELLOW	A constant color set to yellow [1, 1, 0, 1].[read only]

Properties

a	The alpha component of the color.
b	The blue component of the color.
g	The green component of the color.
r	The red component of the color.

Methods

clone	Returns a clone of the specified color.
copy	Copies the contents of a source color to a destination color.
equals	Reports whether two colors are equal.
fromString	Set the values of the color from a string representation '#11223344' or '#112233'.
lerp	Returns the result of a linear interpolation between two specified colors.
set	Assign values to the color components, including alpha.
toString	Converts the color to string form.

Details

Static Properties

BLACK	A constant color set to black [0, 0, 0, 1]. [read only]
BLUE	A constant color set to blue [0, 0, 1, 1]. [read only]
CYAN	A constant color set to cyan [0, 1, 1, 1]. [read only]
GRAY	A constant color set to gray [0.5, 0.5, 0.5, 1]. [read only]
GREEN	A constant color set to green [0, 1, 0, 1]. [read only]
MAGENTA	A constant color set to magenta [1, 0, 1, 1]. [read only]
RED	A constant color set to red [1, 0, 0, 1]. [read only]
WHITE	A constant color set to white [1, 1, 1, 1]. [read only]
YELLOW	A constant color set to yellow [1, 1, 0, 1]. [read only]

Constructor

Color([r], [g], [b], [a]) 

Create a new Color object.

Parameters

r	number, number[]	The value of the red component (0-1). Defaults to 0. If r is an array of length 3 or 4, the array will be used to populate all components.
g	number	The value of the green component (0-1). Defaults to 0.
b	number	The value of the blue component (0-1). Defaults to 0.
a	number	The value of the alpha component (0-1). Defaults to 1.

Properties

numbera 

The alpha component of the color.

numberb 

The blue component of the color.

numberg 

The green component of the color.

numberr 

The red component of the color.

Methods

clone() 

Returns a clone of the specified color.

Returns

this

A duplicate color object.

copy(rhs) 

Copies the contents of a source color to a destination color.

const src = new pc.Color(1, 0, 0, 1);
const dst = new pc.Color();

dst.copy(src);

console.log("The two colors are " + (dst.equals(src) ? "equal" : "different"));

Parameters

rhs

Color

A color to copy to the specified color.

Returns

Color

Self for chaining.

equals(rhs) 

Reports whether two colors are equal.

const a = new pc.Color(1, 0, 0, 1);
const b = new pc.Color(1, 1, 0, 1);
console.log("The two colors are " + (a.equals(b) ? "equal" : "different"));

Parameters

rhs

Color

The color to compare to the specified color.

Returns

boolean

True if the colors are equal and false otherwise.

fromString(hex) 

Set the values of the color from a string representation '#11223344' or '#112233'.

Parameters

hex

string

A string representation in the format '#RRGGBBAA' or '#RRGGBB'. Where RR, GG, BB, AA are red, green, blue and alpha values. This is the same format used in HTML/CSS.

Returns

Color

Self for chaining.

lerp(lhs, rhs, alpha) 

Returns the result of a linear interpolation between two specified colors.

const a = new pc.Color(0, 0, 0);
const b = new pc.Color(1, 1, 0.5);
const r = new pc.Color();

r.lerp(a, b, 0);   // r is equal to a
r.lerp(a, b, 0.5); // r is 0.5, 0.5, 0.25
r.lerp(a, b, 1);   // r is equal to b

Parameters

lhs	Color	The color to interpolate from.
rhs	Color	The color to interpolate to.
alpha	number	The value controlling the point of interpolation. Between 0 and 1, the linear interpolant will occur on a straight line between lhs and rhs. Outside of this range, the linear interpolant will occur on a ray extrapolated from this line.

Returns

Color

Self for chaining.

set(r, g, b, [a]) 

Assign values to the color components, including alpha.

Parameters

r	number	The value for red (0-1).
g	number	The value for blue (0-1).
b	number	The value for green (0-1).
a	number	The value for the alpha (0-1), defaults to 1.

Returns

Color

Self for chaining.

toString(alpha) 

Converts the color to string form. The format is '#RRGGBBAA', where RR, GG, BB, AA are the red, green, blue and alpha values. When the alpha value is not included (the default), this is the same format as used in HTML/CSS.

const c = new pc.Color(1, 1, 1);
// Outputs #ffffffff
console.log(c.toString());

Parameters

alpha

boolean

If true, the output string will include the alpha value.

Returns

string

The color in string form.