Class: Color

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.

Color:

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

Примеры:

String Representation:

'#fff'

RGB and HSB Representation:

[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]);

Notes:

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

Color Method: mix

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);

Color Method: invert

Inverts the Color.

Синтаксис:

var myInvert = myColor.invert();

Возвращает:

• (array) A new Color instance.

Примеры:

var white = new Color('#fff');

var black = white.invert();

Color Method: setHue

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);

Color Method: setSaturation

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]++));

});

Color Method: setBrightness

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]++));

});

Функция: $RGB

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));

Функция: $HSB

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);

Native: Array

Contains Array prototypes.

Смотрите также:

• MDC Array

Array Method: rgbToHsb

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].

Array Method: hsbToRgb

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]