/colorjs

Color lib for JS (supports rgba, hsva, hsla via a simple API) (MIT)

Primary LanguageJavaScriptMIT LicenseMIT

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.