Package Exports
- color-convert
- color-convert/conversions
- color-convert/package.json
This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (color-convert) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.
Readme
color-convert
Color-convert is a color conversion library for JavaScript and node. It converts all ways between rgb, hsl, hsv, cmyk, and CSS keywords:
var converter = require("color-convert")();
converter.rgb(140, 200, 100).hsl() // [96, 48, 59]
converter.keyword("blue").rgb() // [0, 0, 255]
```
# Install
### node
For [node](http://nodejs.org) with [npm](http://npmjs.org):
npm install color-convert
### browser
Download the latest [color-convert.js](http://github.com/harthur/color-convert/downloads). All the methods are on the `colorConvert` object.
# API
Color-convert exports a converter object with getter/setter methods for each color space. It caches conversions:
```javascript
var converter = require("color-convert")();
converter.rgb(140, 200, 100).hsl() // [96, 48, 59]
converter.rgb([140, 200, 100]) // args can be an arrayPlain functions
Get direct conversion functions with no fancy objects:
require("convert").rgb2hsl([140, 200, 100]); // [96, 48, 59]Unrounded
To get the unrounded conversion, append Raw to the function name:
convert.rgb2hslRaw([140, 200, 100]); // [95.99999999999999, 47.619047619047606, 58.82352941176471]Hash
There's also a hash of the conversion functions keyed first by the "from" color space, then by the "to" color space:
convert["hsl"]["hsv"]([160, 0, 20]) == convert.hsl2hsv([160, 0, 20])Other spaces
There are some conversions from rgb (sRGB) to XYZ and LAB too, available as rgb2xyz(), rgb2lab(), xyz2rgb(), and xyz2lab().
Contribute
Please fork, add conversions, figure out color profile stuff for XYZ, LAB, etc. This is meant to be a basic library that can be used by other libraries to wrap color calculations in some cool way.