Color lib for JS (supports rgba, hsva, hsla via a simple API) (MIT)
JavaScript
Latest commit 4608afc Jul 7, 2012 @bebraw Bump version
Permalink
Failed to load latest commit information.
css
lib
src
tests Make setters more robust Jul 7, 2012
LICENSE
README.md Add licensing info Aug 23, 2011
main.js
package.json
runtests.html

README.md

colorjs

colorjs provides simple API that may be used to create colors (RGBA, HSVA, HSLA) and perform various color related operations (conversions and such).

Examples

Making red (#FF0000)

color.rgba('red');
color.rgba('#FF0000');
color.rgba('FF0000');

color.hsva('red');
color.hsva('#FF0000');
color.hsva('FF0000');

color.hsla('red');
color.hsla('#FF0000');
color.hsla('FF0000');

color.rgba({r: 1});
color.hsva({s: 1, v: 1});

color.rgba().r(1);
color.hsva().s(1).v(1);

Getter/setter notation

var c = color.rgba('red');

c.r(0.5);

c.r(); // should return 0.5

toArray

var c = color.rgba('red');

c.toArray(); // [1, 0, 0, 1]

toHex

var c = color.rgba('red');

c.toHex(); // 'ff0000'

toCSS

var c = color.rgba('red');
c.toCSS(); // 'rgb(255,0,0)'

c.a(0.5);
c.toCSS(); // 'rgba(255,0,0,0.5)'

Chaining

var c = color.rgba('red');

c.r(0.5).b(0.5); // chains

c.toArray(); // [0.5, 0.5, 0, 1]

Bounds

var c = color.hsva({h: 10, s: -10, v: 5, a: -2});

c.toArray(); // [1, 0, 1, 0]

Type conversions

var c1 = color.rgba('red');
var c2 = color.hsva(c1);

c2.toArray(); // [0, 1, 1, 1]

Other libraries

See https://github.com/bebraw/jswiki/wiki/Color-libraries .

License

colorjs is available under MIT license. See LICENSE for more details.