color.md.svn-base

mooltools源码很不错的源码

Class: Color {#Color}
=====================

颜色代码的封装类

### 语法:

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

### 参数:

1. color - (*mixed*) 一个颜色代码字符串或数组
2. type  - (*string*, 可选) 创建的目标颜色代码类型

### Color:

有三种可代表颜色代码的格式: 字符串, RGB, HSB. 

字符串颜色代码的说明请参考[Element:setStyle][].

### 示例:

##### 字符串表示:

	'#fff'

##### RGB 和 HSB 表示:

	[255, 255, 255]
	//或:
	[255, 255, 255, 1] //(带alpha值)


### 返回值:

* (*array*) Color实例

### 示例:

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

### 备注:

- 若要创建HSB颜色代码, 必须明确指定type参数



Color 方法: mix {#Color:mix}
------------------------------

将两个或多个颜色进行混色

###	语法:

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

###	参数:

1. color - (*mixed*) 要和主色混合的一个或多个颜色, 使用十六进制或rgb格式
2. alpha - (*number*, 可选) 如果最后一个参数是一个数字, 则它代表混入颜色的比例

###	返回值:

* (*array*) Color实例

###	示例:

	// 将黑色和白色及紫色混合,混入比例为10%
	var darkpurple = new Color('#000').mix('#fff', [255, 0, 255], 10);

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



Color 方法: invert {#Color:Invert}
------------------------------------

取当前颜色的反色

###	语法:

	var myInvert = myColor.invert();

###	返回值:

* (*array*) Color实例

###	示例s:

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



Color 方法: setHue {#Color:setHue}
------------------------------------

修改当前颜色的灰度,并返回一个新的Color实例

###	语法:

	var hue = myColor.setHue(value);

###	参数:

1. value - (*number*) 灰度

###	返回值:

* (arrays) Color实例

###	示例:

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

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



Color 方法: setSaturation {#Color:setSaturation}
--------------------------------------------------

修改当前颜色的饱和度,并返回一个新的Color实例

###	语法:

	var saturate = myColor.setSaturation(percent);

###	参数:

1. percent - (*number*) 饱和度

### 返回值:

* (*array*) Color实例

###	示例s:

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



Color 方法: setBrightness {#Color:setBrightness}
--------------------------------------------------

修改当前颜色的亮度,并返回一个新的Color实例

###	语法:

	var brighten = myColor.setBrightness(percent);

### 参数:

1. percent - (*number*) 亮度

###	返回值:

* (*array*) Color实例

###	示例s:

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



函数: $RGB {#RGB}
---------------------

创建Color实例的快捷函数(基于RGB值)

### 语法:

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

### 参数:

1. r - (*number*) 红色值(0~255)
2. g - (*number*) 绿色值(0~255)
3. b - (*number*) 蓝色值(0~255)

### 返回值:

* (*array*) Color实例

### 示例:

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



函数: $HSB {#HSB}
---------------------

创建Color实例的快捷函数(基于HSB值)

### 语法:

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

### 参数:

1. h - (*number*) 灰度(0~359)
2. s - (*number*) 饱和度(0~100)
3. b - (*number*) 亮度(0~100)

### 返回值:

* (*array*) Color实例

### 示例:

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



Native: Array {#Array}
======================

### 另参考:

- [MDC Array][]



Array 方法: rgbToHsb {#Array:rgbToHsb}
----------------------------------------

将RGB代码转换为HSB代码 

###	语法:

	var myHSB = myRGBArray.rgbToHsb();

###	返回值:

* (*array*) 代表HSB颜色代码的数组

###	示例:

	var myHSB = [255, 0, 0].rgbToHsb(); //返回值 [0, 100, 100].



Array 方法: hsbToRgb {#Array:hsbToRgb}
----------------------------------------

将HSB代码转换为RGB代码 

###	语法:

	var myHSB = myRGBArray.hsbToRgb();

###	返回值:

* (*array*) 代表RGB颜色代码的数组


###	示例:

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



[Element:setStyle]: /Element/Element.Style#Element:setStyles
[MDC Array]: http://developer.mozilla.org/en/docs/Core_JavaScript_1.5_Reference:Global_Objects:Array