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]);

If you aware of size, you can include only needed spaces:

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

//convert rgb to hsl
rgb.hsl([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 (CIE XYZ)
• lab (CIE Lab)
• lch (CIE LCHab — cylindrical LAB)
• luv (CIE Luv)
• lchuv (CIE LCHuv)

To see details console.log(space).

Contribute

Please fork, add color spaces/convertions. If you add a new space, make sure you have implemented at least to/from XYZ or to/from RGB conversion functions. 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.