Creates a new Color Class, which is an array with some color specific methods.

var myColor = new Color(color[, type]);

1. color - (mixed) A string or an array representation of a color.
2. type - (string, optional) A string representing the type of the color to create.

There are three typical representations of color: String, RGB, and HSB. For String representation see Element:setStyle for more information.

'#fff'

[255, 255, 255]
//Or:
[255, 255, 255, 1] //(For transparency.)

• (array) A new Color instance.

var black = new Color('#000');
var purple = new Color([255,0,255]);

• For HSB colors, you need to specify the second argument.

Mixes two or more colors with the Color.

var myMix = myColor.mix(color[, color2[, color3[, ...][, alpha]);

1. color - (mixed) A single or many colors, in hex or rgb representation, to mix with this Color.
2. alpha - (number, optional) If the last argument is a number, it will be treated as the amount of the color to mix.

• (array) A new Color instance.

// mix black with white and purple, each time at 10% of the new color
var darkpurple = new Color('#000').mix('#fff', [255, 0, 255], 10);

$('myDiv').setStyle('background-color', darkpurple);

Inverts the Color.

var myInvert = myColor.invert();

• (array) A new Color instance.

var white = new Color('#fff');
var black = white.invert();

Modifies the hue of the Color, and returns a new one.

var hue = myColor.setHue(value);

1. value - (number) The hue to set.

• (arrays) A new Color instance.

var myColor = new Color('#f00');
var myElement = $('myElement');

(function(){
    myElement.setStyle('color', myColor.setHue(myColor.hsb[0]++)));
}).periodical(250);

Changes the saturation of the Color, and returns a new one.

var saturate = myColor.setSaturation(percent);

1. percent - (number) The percentage of the saturation to set.

• (array) A new Color instance.

var myColor = new Color('#f00');
$('myElement').addEvent('mouseenter', function(){
    this.setStyle('background-color', myColor.setSaturation(myColor.hsb[1]++));
});

Changes the brightness of the Color, and returns a new one.

var brighten = myColor.setBrightness(percent);

1. percent - (number) The percentage of the brightness to set.

• (array) A new Color instance.

var myColor = new Color('#000');
$('myElement').addEvent('mouseenter', function(){
    this.setStyle('background-color', myColor.setBrightness(myColor.hsb[2]++));
});

Shortcut to create a new color, based on red, green, blue values.

var myColor = $RGB(r, g, b);

1. r - (number) A red value from 0 to 255.
2. g - (number) A green value from 0 to 255.
3. b - (number) A blue value from 0 to 255.

• (array) A new Color instance.

var myColor = $RGB($random(0,255), $random(0,255), $random(0,255));

Shortcut to create a new color, based on: hue, saturation, brightness values.

var myColor = $HSB(h, s, b);

1. h - (number) A hue value from 0 to 359.
2. s - (number) A saturation value from 0 to 100.
3. b - (number) A brightness value from 0 to 100.

• (array) A new Color instance.

var myColor = $HSB(50, 50, 100);

Contains Array prototypes.

• MDC Array

Converts a RGB array to an HSB array.

var myHSB = myRGBArray.rgbToHsb();

• (array) An array with HSB values.

var myHSB = [255, 0, 0].rgbToHsb(); //Returns [0, 100, 100].

Converts an HSB array to a RGB array.

var myHSB = myRGBArray.hsbToRgb();

• (array) An array with RGB values.

var myRGB = [0, 100, 100].hsbToRgb(); //myRGB = [255, 0, 0]