// Examples for green
var color = new Color("green");  // named value
var color = new Color("#00FF00");  // hex value
var color = new Color("hsl(120, 100%, 50%)");  // hsl
var color = new Color("hsla(120, 100%, 50%, 0.5)"); // hsla

// Examples for green
var color = new Color([0, 255, 0]);
var color = new Color([0, 255, 0, 0.5]);
var color = new Color("rgb(0, 255, 0)");
var color = new Color("rgba(0, 255, 0, 0.5)");
var color = new Color({r: 0, g: 255, b: 0});
var color = new Color({r: 0, g: 255, b: 0, a: 0.5});

Property Overview

Property Details

a Number

The alpha value. This value can be any number between 0 and 1 and represents the opacity of the Color. 0 indicates the color is fully transparent and 1 indicates it is fully opaque.

b Number

The blue value. This value can range between 0 and 255.

g Number

The green value. This value can range between 0 and 255.

r Number

The red value. This value can range between 0 and 255.

Method Overview

Method Details

blendColors(start, end, weight, out){Color}static

Creates a Color instance by blending two colors using a weight factor. Optionally accepts a Color object to update and return instead of creating a new object.

Parameters:

start Color The start color.

end Color The end color.

weight Number The weight value is a number from 0 to 1, with 0.5 being a 50/50 blend.

out Color optional A previously allocated Color object to reuse for the result.

Returns:

Type	Description
Color	Returns a new Color object.

Example:

var startColor = new Color("#0000FF");
var endColor = new Color("#CA0013");
var blendedColor = Color.blendColors(startColor, endColor, 0.5);

clone(){Color}

Creates a deep clone of the Color instance.

Returns:

Type	Description
Color	A deep clone of the Color instance.

Example:

// Creates a deep clone of the graphic's color
var colorClone = graphic.symbol.color.clone();

fromArray(a, obj){Color}static

Creates a Color instance using a 3 or 4 element array, mapping each element in sequence to the rgb(a) values of the color. Optionally accepts a Color object to update with the color value and return instead of creating a new object.

Parameters:

a Number[] The input array.

obj Color optional A previously allocated Color object to reuse for the result.

Returns:

Type	Description
Color	Returns a new Color object.

Example:

var redColor = Color.fromArray([201, 0, 19]);

fromHex(color, obj){Color}static

Creates a Color instance from a hex string with a '#' prefix. Supports 12-bit #rgb shorthand. Optionally accepts a Color object to update with the parsed value and return instead of creating a new object.

Parameters:

color String The input color in a hex string.

obj Color optional A previously allocated Color object to reuse for the result.

Returns:

Type	Description
Color	Returns a new Color object.

Example:

var redColor = Color.fromHex("#CA0013");

fromJSON(json){Color}static

Creates a new Color instance, and initializes it with values from a JSON object.

Parameter:

json Object A JSON representation of the instance.

Returns:

Type	Description
Color	A new Color instance.

fromRgb(color, out){Color}static

Creates a Color instance from a string of the form "rgb()" or "rgba()". Optionally accepts a Color object to update with the parsed value and return instead of creating a new object.

Parameters:

color String The input color in a string of the form "rgb()" or "rgba()".

out Color optional A previously allocated Color object to reuse for the result.

Returns:

Type	Description
Color	Returns a new Color object.

Example:

var redColor = Color.fromRgb("rgb(202,0,19)");

fromString(str, obj){Color}static

Creates a Color instance by parsing a generic string. Accepts hex, rgb, and rgba style color values. Optionally accepts a Color object to update with the parsed value and return instead of creating a new object.

Parameters:

str String The input value.

obj Color optional A previously allocated Color object to reuse for the result.

Returns:

Type	Description
Color	Returns a new Color object.

Example:

var redColor = Color.fromString("blue");

setColor(color){Color}

Takes an array of rgb(a) values, named string, hex string or an hsl(a) string, an object with r, g, b, and a properties, or a Color object and sets this color instance to the input value.

Parameter:

color String|Number[]|Object The new color value. This parameter can be a string representing a named color or a hex value; an array of three or four numbers representing r, g, b, a values; or an object with r, g, b, a properties.

Returns:

Type	Description
Color	Sets the Color instance used to call this method to the new color.

toCss(includeAlpha){String}

Returns a CSS color string in rgba form representing the Color instance.

Parameter:

includeAlpha Boolean optional If true, the alpha value will be included in the result.

Returns:

Type	Description
String	A CSS color string in rgba form that represents the Color instance used to call this method.

toHex(){String}

Returns a CSS color string in hexadecimal form that represents the Color instance.

Returns:

Type	Description
String	A CSS color string in hexadecimal form that represents the Color instance used to call this method.

toJSON(){Object}

Returns a JSON object with all the values from a Color instance.

Returns:

Type	Description
Object	A JSON representation of the Color instance.

toRgb(){Number[]}

Returns a 3-component array of rgb values that represent the Color instance.

Returns:

Type	Description
Number[]	A 3-component array of rgb values.

toRgba(){Number[]}

Returns a 4-component array of rgba values that represent the Color instance.

Returns:

Type	Description
Number[]	A 4-component array of rgba values.