Class: Colабо

Створює новий клас Colабо, який є масивом з специфічними методами Colабо.

Синтаксис:

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

Аргументи:

1. colабо - (mixed) Рядок або представлення масиву colабо.
2. type - (string, необов'язково) Рядок, що представляє тип colабо для створення.

Colабо:

Існує три типові представлення colабо: String, RGB та HSB. Для представлення String див. Element:setStyle для отримання додаткової інформації.

Приклади:

Рядкове представлення:

'#fff'

Представлення RGB та HSB:

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

Повертає:

• (array) Новий екземпляр Colабо.

Приклади:

var black = new Color('#000');

var purple = new Color([255,0,255]);

Примітки:

• Для HSB colабо необхідно вказати другий аргумент.

Метод Colабо: mix

Змішує два або більше colабо з Colабо.

Синтаксис:

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

Аргументи:

1. colабо - (mixed) Один або кілька colабо, у hex або rgb представленні, для змішування з цим Colабо.
2. alpha - (number, необов'язково) Якщо останній аргумент є числом, він буде розглядатися як кількість colабо для змішування.

Повертає:

• (array) Новий екземпляр Colабо.

Приклади:

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

Метод Colабо: invert

Інвертує Colабо.

Синтаксис:

var myInvert = myColor.invert();

Повертає:

• (array) Новий екземпляр Colабо.

Приклади:

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

var black = white.invert();

Метод Colабо: setHue

Змінює відтінок Colабо та повертає новий.

Синтаксис:

var hue = myColor.setHue(value);

Аргументи:

1. value - (number) Відтінок для встановлення.

Повертає:

• (array) Новий екземпляр Colабо.

Приклад:

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

var myElement = $('myElement');
 
(function(){
    myElement.setStyle('color', myColor.setHue(myColor.hsb[0]++)));

}).periodical(250);

Метод Colабо: setSaturation

Змінює насиченість Colабо та повертає новий.

Синтаксис:

var saturate = myColor.setSaturation(percent);

Аргументи:

1. percent - (number) Відсоток насиченості для встановлення.

Повертає:

• (array) Новий екземпляр Colабо.

Приклади:

var myColor = new Color('#f00');
$('myElement').addEvent('mouseenter', function(){

    this.setStyle('background-color', myColor.setSaturation(myColor.hsb[1]++));

});

Метод Colабо: setBrightness

Змінює яскравість Colабо та повертає новий.

Синтаксис:

var brighten = myColor.setBrightness(percent);

Аргументи:

1. percent - (number) Відсоток яскравості для встановлення.

Повертає:

• (array) Новий екземпляр Colабо.

Приклади:

var myColor = new Color('#000');
$('myElement').addEvent('mouseenter', function(){

    this.setStyle('background-color', myColor.setBrightness(myColor.hsb[2]++));

});

Функція: $RGB

Скорочення для створення нового colабо на основі значень red, green, blue.

Синтаксис:

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

Аргументи:

1. r - (number) Значення red від 0 до 255.
2. g - (number) Значення green від 0 до 255.
3. b - (number) Значення blue від 0 до 255.

Повертає:

• (array) Новий екземпляр Colабо.

Приклади:

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

Функція: $HSB

Скорочення для створення нового colабо на основі: hue, saturation, brightness значень.

Синтаксис:

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

Аргументи:

1. h - (number) Значення hue від 0 до 359.
2. s - (number) Значення saturation від 0 до 100.
3. b - (number) Значення brightness від 0 до 100.

Повертає:

• (array) Новий екземпляр Colабо.

Приклади:

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

Нативний: Array

Містить прототипи Array.

Див. також:

• MDC Array

Метод Array: rgbToHsb

Конвертує RGB масив у HSB масив.

Синтаксис:

var myHSB = myRGBArray.rgbToHsb();

Повертає:

• (array) Масив зі значеннями HSB.

Приклад:

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

Метод Array: hsbToRgb

Конвертує HSB масив у RGB масив.

Синтаксис:

var myHSB = myRGBArray.hsbToRgb();

Повертає:

• (array) Масив зі значеннями RGB.

Приклади:

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