2 * jQuery Color Utilities
3 * Written by Krinkle in 2011
4 * Released under the MIT and GPL licenses.
5 * Mostly based on other plugins and functions (taken through JSLint and optimized a little).
6 * Sources cited locally.
11 // Color Conversion function from highlightFade
12 // By Blair Mitchelmore
13 // http://jquery.offput.ca/highlightFade/
14 // Parse strings looking for color tuples [255,255,255]
15 getRGB : function( color
) {
18 // Check if we're already dealing with an array of colors
19 if ( color
&& color
.constructor == Array
&& color
.length
== 3 ){
23 // Look for rgb(num,num,num)
24 if (result
= /rgb\(\s*([0-9]{1,3})\s*,\s*([0-9]{1,3})\s*,\s*([0-9]{1,3})\s*\)/.exec(color
)) {
25 return [parseInt(result
[1],10), parseInt(result
[2],10), parseInt(result
[3],10)];
28 // Look for rgb(num%,num%,num%)
29 if (result
= /rgb\(\s*([0-9]+(?:\.[0-9]+)?)\%\s*,\s*([0-9]+(?:\.[0-9]+)?)\%\s*,\s*([0-9]+(?:\.[0-9]+)?)\%\s*\)/.exec(color
)) {
30 return [parseFloat(result
[1],10)*2.55, parseFloat(result
[2],10)*2.55, parseFloat(result
[3])*2.55];
34 if (result
= /#([a-fA-F0-9]{2})([a-fA-F0-9]{2})([a-fA-F0-9]{2})/.exec(color
)) {
35 return [parseInt(result
[1],16), parseInt(result
[2],16), parseInt(result
[3],16)];
39 if (result
= /#([a-fA-F0-9])([a-fA-F0-9])([a-fA-F0-9])/.exec(color
)) {
40 return [parseInt(result
[1]+result
[1],16), parseInt(result
[2]+result
[2],16), parseInt(result
[3]+result
[3],16)];
43 // Look for rgba(0, 0, 0, 0) == transparent in Safari 3
44 if (result
= /rgba\(0, 0, 0, 0\)/.exec(color
)) {
45 return $.colorUtil
.colors
.transparent
;
48 // Otherwise, we're most likely dealing with a named color
49 return $.colorUtil
.colors
[$.trim(color
).toLowerCase()];
52 // Some named colors to work with
53 // From Interface by Stefan Petre
54 // http://interface.eyecon.ro/
65 darkgrey
:[169,169,169],
67 darkkhaki
:[189,183,107],
68 darkmagenta
:[139,0,139],
69 darkolivegreen
:[85,107,47],
70 darkorange
:[255,140,0],
71 darkorchid
:[153,50,204],
73 darksalmon
:[233,150,122],
74 darkviolet
:[148,0,211],
80 lightblue
:[173,216,230],
81 lightcyan
:[224,255,255],
82 lightgreen
:[144,238,144],
83 lightgrey
:[211,211,211],
84 lightpink
:[255,182,193],
85 lightyellow
:[255,255,224],
99 transparent
: [255,255,255]
102 * http://mjijackson.com/2008/02/rgb-to-hsl-and-rgb-to-hsv-color-model-conversion-algorithms-in-javascript
103 * Converts an RGB color value to HSL. Conversion formula
104 * adapted from http://en.wikipedia.org/wiki/HSL_color_space.
105 * Assumes r, g, and b are contained in the set [0, 255] and
106 * returns h, s, and l in the set [0, 1].
108 * @param Number R The red color value
109 * @param Number G The green color value
110 * @param Number B The blue color value
111 * @return Array The HSL representation
113 rgbToHsl: function( R
, G
, B
) {
117 var max
= Math
.max(r
, g
, b
), min
= Math
.min(r
, g
, b
);
118 var h
, s
, l
= (max
+ min
) / 2;
121 h
= s
= 0; // achromatic
124 s
= l
> 0.5 ? d
/ (2 - max
- min
) : d
/ (max
+ min
);
126 case r
: h
= (g
- b
) / d
+ (g
< b
? 6 : 0); break;
127 case g
: h
= (b
- r
) / d
+ 2; break;
128 case b
: h
= (r
- g
) / d
+ 4; break;
136 * http://mjijackson.com/2008/02/rgb-to-hsl-and-rgb-to-hsv-color-model-conversion-algorithms-in-javascript
137 * Converts an HSL color value to RGB. Conversion formula
138 * adapted from http://en.wikipedia.org/wiki/HSL_color_space.
139 * Assumes h, s, and l are contained in the set [0, 1] and
140 * returns r, g, and b in the set [0, 255].
142 * @param Number h The hue
143 * @param Number s The saturation
144 * @param Number l The lightness
145 * @return Array The RGB representation
147 hslToRgb: function( h
, s
, l
) {
151 r
= g
= b
= l
; // achromatic
153 var hue2rgb = function(p
, q
, t
){
156 if(t
< 1/6){ return p
+ (q
- p
) * 6 * t
; }
157 if(t
< 1/2){ return q
; }
158 if(t
< 2/3){ return p + (q - p) * (2/3 - t
) * 6; }
162 var q
= l
< 0.5 ? l
* (1 + s
) : l
+ s
- l
* s
;
164 r
= hue2rgb(p
, q
, h
+ 1/3);
165 g
= hue2rgb(p
, q
, h
);
166 b
= hue2rgb(p
, q
, h
- 1/3);
169 return [r
* 255, g
* 255, b
* 255];
172 * Get's a brighter or darker rgb() value string.
176 * @example getCSSColorMod( 'red', +0.1 )
177 * @example getCSSColorMod( 'rgb(200,50,50)', -0.2 )
179 * @param Mixed currentColor current value in css
180 * @param Number mod wanted brightness modification between -1 and 1
181 * @return String 'rgb(r,g,b)'
183 getColorBrightness: function( currentColor
, mod
) {
184 var rgbArr
= $.colorUtil
.getRGB( currentColor
),
185 hslArr
= $.colorUtil
.rgbToHsl(rgbArr
[0], rgbArr
[1], rgbArr
[2] );
186 rgbArr
= $.colorUtil
.hslToRgb(hslArr
[0], hslArr
[1], hslArr
[2]+mod
);
188 [parseInt( rgbArr
[0], 10), parseInt( rgbArr
[1], 10 ), parseInt( rgbArr
[2], 10 )].join( ',' ) +