color-space

Math and data behind color spaces and color conversions. Converter & tests.

Use

$ npm install color-space

To include all spaces:

var spaces = require('color-space');

//convert lab to lch
spaces.lab.lch([80,50,60]);

To include one target space:

var rgb = require('color-space/rgb');
var hsl = require('color-space/hsl');

//convert rgb to lch
hsl.lch([200,230,100]);

Use browserify to use in a browser.

API

Convert from one space to another:

var fromSpace = 'rgb', toSpace = 'hsl';

spaces[fromSpace][toSpace](array);

Get space data:

space.name //space name
space.min //channel minimums
space.max //channel maximums
space.channel //channel names
space.alias //alias space names, if any
space.illuminant //space-specific properties

Available spaces:

• rgb
• hsl
• hsv (hsb)
• hwb
• cmyk
• xyz (ciexyz)
• lab (cielab)
• luv (cieluv)
• lch (cielch)

To see details console.log(space).

Contribute

Please fork, add space/convertions. If you add a space, make sure you have implemented at least to/from XYZ or to/from RGB conversions. Don’t forget to add a test-case.

This is meant to be a basic library that can be used by other libraries to wrap color calculations in some cool way.