1 |
|
---|
2 | /*!
|
---|
3 | * Stylus - RGBA
|
---|
4 | * Copyright (c) Automattic <developer.wordpress.com>
|
---|
5 | * MIT Licensed
|
---|
6 | */
|
---|
7 |
|
---|
8 | /**
|
---|
9 | * Module dependencies.
|
---|
10 | */
|
---|
11 |
|
---|
12 | var Node = require('./node')
|
---|
13 | , HSLA = require('./hsla')
|
---|
14 | , functions = require('../functions')
|
---|
15 | , adjust = functions.adjust
|
---|
16 | , nodes = require('./');
|
---|
17 |
|
---|
18 | /**
|
---|
19 | * Initialize a new `RGBA` with the given r,g,b,a component values.
|
---|
20 | *
|
---|
21 | * @param {Number} r
|
---|
22 | * @param {Number} g
|
---|
23 | * @param {Number} b
|
---|
24 | * @param {Number} a
|
---|
25 | * @api public
|
---|
26 | */
|
---|
27 |
|
---|
28 | var RGBA = exports = module.exports = function RGBA(r,g,b,a){
|
---|
29 | Node.call(this);
|
---|
30 | this.r = clamp(r);
|
---|
31 | this.g = clamp(g);
|
---|
32 | this.b = clamp(b);
|
---|
33 | this.a = clampAlpha(a);
|
---|
34 | this.name = '';
|
---|
35 | this.rgba = this;
|
---|
36 | };
|
---|
37 |
|
---|
38 | /**
|
---|
39 | * Inherit from `Node.prototype`.
|
---|
40 | */
|
---|
41 |
|
---|
42 | RGBA.prototype.__proto__ = Node.prototype;
|
---|
43 |
|
---|
44 | /**
|
---|
45 | * Return an `RGBA` without clamping values.
|
---|
46 | *
|
---|
47 | * @param {Number} r
|
---|
48 | * @param {Number} g
|
---|
49 | * @param {Number} b
|
---|
50 | * @param {Number} a
|
---|
51 | * @return {RGBA}
|
---|
52 | * @api public
|
---|
53 | */
|
---|
54 |
|
---|
55 | RGBA.withoutClamping = function(r,g,b,a){
|
---|
56 | var rgba = new RGBA(0,0,0,0);
|
---|
57 | rgba.r = r;
|
---|
58 | rgba.g = g;
|
---|
59 | rgba.b = b;
|
---|
60 | rgba.a = a;
|
---|
61 | return rgba;
|
---|
62 | };
|
---|
63 |
|
---|
64 | /**
|
---|
65 | * Return a clone of this node.
|
---|
66 | *
|
---|
67 | * @return {Node}
|
---|
68 | * @api public
|
---|
69 | */
|
---|
70 |
|
---|
71 | RGBA.prototype.clone = function(){
|
---|
72 | var clone = new RGBA(
|
---|
73 | this.r
|
---|
74 | , this.g
|
---|
75 | , this.b
|
---|
76 | , this.a);
|
---|
77 | clone.raw = this.raw;
|
---|
78 | clone.name = this.name;
|
---|
79 | clone.lineno = this.lineno;
|
---|
80 | clone.column = this.column;
|
---|
81 | clone.filename = this.filename;
|
---|
82 | return clone;
|
---|
83 | };
|
---|
84 |
|
---|
85 | /**
|
---|
86 | * Return a JSON representation of this node.
|
---|
87 | *
|
---|
88 | * @return {Object}
|
---|
89 | * @api public
|
---|
90 | */
|
---|
91 |
|
---|
92 | RGBA.prototype.toJSON = function(){
|
---|
93 | return {
|
---|
94 | __type: 'RGBA',
|
---|
95 | r: this.r,
|
---|
96 | g: this.g,
|
---|
97 | b: this.b,
|
---|
98 | a: this.a,
|
---|
99 | raw: this.raw,
|
---|
100 | name: this.name,
|
---|
101 | lineno: this.lineno,
|
---|
102 | column: this.column,
|
---|
103 | filename: this.filename
|
---|
104 | };
|
---|
105 | };
|
---|
106 |
|
---|
107 | /**
|
---|
108 | * Return true.
|
---|
109 | *
|
---|
110 | * @return {Boolean}
|
---|
111 | * @api public
|
---|
112 | */
|
---|
113 |
|
---|
114 | RGBA.prototype.toBoolean = function(){
|
---|
115 | return nodes.true;
|
---|
116 | };
|
---|
117 |
|
---|
118 | /**
|
---|
119 | * Return `HSLA` representation.
|
---|
120 | *
|
---|
121 | * @return {HSLA}
|
---|
122 | * @api public
|
---|
123 | */
|
---|
124 |
|
---|
125 | RGBA.prototype.__defineGetter__('hsla', function(){
|
---|
126 | return HSLA.fromRGBA(this);
|
---|
127 | });
|
---|
128 |
|
---|
129 | /**
|
---|
130 | * Return hash.
|
---|
131 | *
|
---|
132 | * @return {String}
|
---|
133 | * @api public
|
---|
134 | */
|
---|
135 |
|
---|
136 | RGBA.prototype.__defineGetter__('hash', function(){
|
---|
137 | return this.toString();
|
---|
138 | });
|
---|
139 |
|
---|
140 | /**
|
---|
141 | * Add r,g,b,a to the current component values.
|
---|
142 | *
|
---|
143 | * @param {Number} r
|
---|
144 | * @param {Number} g
|
---|
145 | * @param {Number} b
|
---|
146 | * @param {Number} a
|
---|
147 | * @return {RGBA} new node
|
---|
148 | * @api public
|
---|
149 | */
|
---|
150 |
|
---|
151 | RGBA.prototype.add = function(r,g,b,a){
|
---|
152 | return new RGBA(
|
---|
153 | this.r + r
|
---|
154 | , this.g + g
|
---|
155 | , this.b + b
|
---|
156 | , this.a + a);
|
---|
157 | };
|
---|
158 |
|
---|
159 | /**
|
---|
160 | * Subtract r,g,b,a from the current component values.
|
---|
161 | *
|
---|
162 | * @param {Number} r
|
---|
163 | * @param {Number} g
|
---|
164 | * @param {Number} b
|
---|
165 | * @param {Number} a
|
---|
166 | * @return {RGBA} new node
|
---|
167 | * @api public
|
---|
168 | */
|
---|
169 |
|
---|
170 | RGBA.prototype.sub = function(r,g,b,a){
|
---|
171 | return new RGBA(
|
---|
172 | this.r - r
|
---|
173 | , this.g - g
|
---|
174 | , this.b - b
|
---|
175 | , a == 1 ? this.a : this.a - a);
|
---|
176 | };
|
---|
177 |
|
---|
178 | /**
|
---|
179 | * Multiply rgb components by `n`.
|
---|
180 | *
|
---|
181 | * @param {String} n
|
---|
182 | * @return {RGBA} new node
|
---|
183 | * @api public
|
---|
184 | */
|
---|
185 |
|
---|
186 | RGBA.prototype.multiply = function(n){
|
---|
187 | return new RGBA(
|
---|
188 | this.r * n
|
---|
189 | , this.g * n
|
---|
190 | , this.b * n
|
---|
191 | , this.a);
|
---|
192 | };
|
---|
193 |
|
---|
194 | /**
|
---|
195 | * Divide rgb components by `n`.
|
---|
196 | *
|
---|
197 | * @param {String} n
|
---|
198 | * @return {RGBA} new node
|
---|
199 | * @api public
|
---|
200 | */
|
---|
201 |
|
---|
202 | RGBA.prototype.divide = function(n){
|
---|
203 | return new RGBA(
|
---|
204 | this.r / n
|
---|
205 | , this.g / n
|
---|
206 | , this.b / n
|
---|
207 | , this.a);
|
---|
208 | };
|
---|
209 |
|
---|
210 | /**
|
---|
211 | * Operate on `right` with the given `op`.
|
---|
212 | *
|
---|
213 | * @param {String} op
|
---|
214 | * @param {Node} right
|
---|
215 | * @return {Node}
|
---|
216 | * @api public
|
---|
217 | */
|
---|
218 |
|
---|
219 | RGBA.prototype.operate = function(op, right){
|
---|
220 | if ('in' != op) right = right.first
|
---|
221 |
|
---|
222 | switch (op) {
|
---|
223 | case 'is a':
|
---|
224 | if ('string' == right.nodeName && 'color' == right.string) {
|
---|
225 | return nodes.true;
|
---|
226 | }
|
---|
227 | break;
|
---|
228 | case '+':
|
---|
229 | switch (right.nodeName) {
|
---|
230 | case 'unit':
|
---|
231 | var n = right.val;
|
---|
232 | switch (right.type) {
|
---|
233 | case '%': return adjust(this, new nodes.String('lightness'), right);
|
---|
234 | case 'deg': return this.hsla.adjustHue(n).rgba;
|
---|
235 | default: return this.add(n,n,n,0);
|
---|
236 | }
|
---|
237 | case 'rgba':
|
---|
238 | return this.add(right.r, right.g, right.b, right.a);
|
---|
239 | case 'hsla':
|
---|
240 | return this.hsla.add(right.h, right.s, right.l);
|
---|
241 | }
|
---|
242 | break;
|
---|
243 | case '-':
|
---|
244 | switch (right.nodeName) {
|
---|
245 | case 'unit':
|
---|
246 | var n = right.val;
|
---|
247 | switch (right.type) {
|
---|
248 | case '%': return adjust(this, new nodes.String('lightness'), new nodes.Unit(-n, '%'));
|
---|
249 | case 'deg': return this.hsla.adjustHue(-n).rgba;
|
---|
250 | default: return this.sub(n,n,n,0);
|
---|
251 | }
|
---|
252 | case 'rgba':
|
---|
253 | return this.sub(right.r, right.g, right.b, right.a);
|
---|
254 | case 'hsla':
|
---|
255 | return this.hsla.sub(right.h, right.s, right.l);
|
---|
256 | }
|
---|
257 | break;
|
---|
258 | case '*':
|
---|
259 | switch (right.nodeName) {
|
---|
260 | case 'unit':
|
---|
261 | return this.multiply(right.val);
|
---|
262 | }
|
---|
263 | break;
|
---|
264 | case '/':
|
---|
265 | switch (right.nodeName) {
|
---|
266 | case 'unit':
|
---|
267 | return this.divide(right.val);
|
---|
268 | }
|
---|
269 | break;
|
---|
270 | }
|
---|
271 | return Node.prototype.operate.call(this, op, right);
|
---|
272 | };
|
---|
273 |
|
---|
274 | /**
|
---|
275 | * Return #nnnnnn, #nnn, or rgba(n,n,n,n) string representation of the color.
|
---|
276 | *
|
---|
277 | * @return {String}
|
---|
278 | * @api public
|
---|
279 | */
|
---|
280 |
|
---|
281 | RGBA.prototype.toString = function(){
|
---|
282 | function pad(n) {
|
---|
283 | return n < 16
|
---|
284 | ? '0' + n.toString(16)
|
---|
285 | : n.toString(16);
|
---|
286 | }
|
---|
287 |
|
---|
288 | // special case for transparent named color
|
---|
289 | if ('transparent' == this.name)
|
---|
290 | return this.name;
|
---|
291 |
|
---|
292 | if (1 == this.a) {
|
---|
293 | var r = pad(this.r)
|
---|
294 | , g = pad(this.g)
|
---|
295 | , b = pad(this.b);
|
---|
296 |
|
---|
297 | // Compress
|
---|
298 | if (r[0] == r[1] && g[0] == g[1] && b[0] == b[1]) {
|
---|
299 | return '#' + r[0] + g[0] + b[0];
|
---|
300 | } else {
|
---|
301 | return '#' + r + g + b;
|
---|
302 | }
|
---|
303 | } else {
|
---|
304 | return 'rgba('
|
---|
305 | + this.r + ','
|
---|
306 | + this.g + ','
|
---|
307 | + this.b + ','
|
---|
308 | + (+this.a.toFixed(3)) + ')';
|
---|
309 | }
|
---|
310 | };
|
---|
311 |
|
---|
312 | /**
|
---|
313 | * Return a `RGBA` from the given `hsla`.
|
---|
314 | *
|
---|
315 | * @param {HSLA} hsla
|
---|
316 | * @return {RGBA}
|
---|
317 | * @api public
|
---|
318 | */
|
---|
319 |
|
---|
320 | exports.fromHSLA = function(hsla){
|
---|
321 | var h = hsla.h / 360
|
---|
322 | , s = hsla.s / 100
|
---|
323 | , l = hsla.l / 100
|
---|
324 | , a = hsla.a;
|
---|
325 |
|
---|
326 | var m2 = l <= .5 ? l * (s + 1) : l + s - l * s
|
---|
327 | , m1 = l * 2 - m2;
|
---|
328 |
|
---|
329 | var r = hue(h + 1/3) * 0xff
|
---|
330 | , g = hue(h) * 0xff
|
---|
331 | , b = hue(h - 1/3) * 0xff;
|
---|
332 |
|
---|
333 | function hue(h) {
|
---|
334 | if (h < 0) ++h;
|
---|
335 | if (h > 1) --h;
|
---|
336 | if (h * 6 < 1) return m1 + (m2 - m1) * h * 6;
|
---|
337 | if (h * 2 < 1) return m2;
|
---|
338 | if (h * 3 < 2) return m1 + (m2 - m1) * (2/3 - h) * 6;
|
---|
339 | return m1;
|
---|
340 | }
|
---|
341 |
|
---|
342 | return new RGBA(r,g,b,a);
|
---|
343 | };
|
---|
344 |
|
---|
345 | /**
|
---|
346 | * Clamp `n` >= 0 and <= 255.
|
---|
347 | *
|
---|
348 | * @param {Number} n
|
---|
349 | * @return {Number}
|
---|
350 | * @api private
|
---|
351 | */
|
---|
352 |
|
---|
353 | function clamp(n) {
|
---|
354 | return Math.max(0, Math.min(n.toFixed(0), 255));
|
---|
355 | }
|
---|
356 |
|
---|
357 | /**
|
---|
358 | * Clamp alpha `n` >= 0 and <= 1.
|
---|
359 | *
|
---|
360 | * @param {Number} n
|
---|
361 | * @return {Number}
|
---|
362 | * @api private
|
---|
363 | */
|
---|
364 |
|
---|
365 | function clampAlpha(n) {
|
---|
366 | return Math.max(0, Math.min(n, 1));
|
---|
367 | }
|
---|