metafoo / chroma.js

JavaScript library for all kinds of color manipulations

Chroma.js

Chroma.js is a tiny JavaScript library (8.5kB) for all kinds of color conversions and color scales.

Usage

Initiate and manipulate colors:

chroma('#D4F880').darken().hex();  // #9BC04B

Working with color scales is easy, too:

scale = chroma.scale(['white', 'red']);
scale(0.5).hex(); // #FF7F7F

Lab/Lch interpolation looks better than than RGB

chroma.scale(['white', 'red']).mode('lab');

Custom domains! Quantiles! Color Brewer!!

chroma.scale('RdYlBu').domain(myValues, 7, 'quantiles');    

And why not use logarithmic color scales once in your life?

chroma.scale(['lightyellow', 'navy']).domain([1, 100000], 7, 'log');    

Like it?

Why not dive into the API docs (quite short actually), and download chroma.min.js right away.

You can use it in node.js, too!

npm install chroma-js

Build instructions

To compile the coffee-script source files you have to run build.sh.

To run the tests simply run

vows test/*.coffee

Similar Libraries / Prior Art

• Chromatist
• GrapeFruit (Python)
• colors.py (Python)
• d3.js

Author

Chroma.js is written by Gregor Aisch.

License

Released under BSD license. Versions prior to 0.4 were released under GPL.

Known issues

• HSI color conversion is experimental and produces weird results sometimes

Further reading

• How To Avoid Equidistant HSV Colors
• Mastering Multi-hued Color Scales with Chroma.js