color-space

What is color-space?

The color-space npm package provides a comprehensive set of tools for color space conversion and manipulation. It supports a wide range of color spaces and allows for easy conversion between them.

What are color-space's main functionalities?

RGB to HSL Conversion

This feature allows you to convert colors from the RGB color space to the HSL color space. The code sample demonstrates converting a red color in RGB to its HSL representation.

const colorSpace = require('color-space');
const rgb = [255, 0, 0];
const hsl = colorSpace.rgb.hsl(rgb);
console.log(hsl); // [0, 100, 50]

HSL to RGB Conversion

This feature allows you to convert colors from the HSL color space to the RGB color space. The code sample demonstrates converting a red color in HSL to its RGB representation.

const colorSpace = require('color-space');
const hsl = [0, 100, 50];
const rgb = colorSpace.hsl.rgb(hsl);
console.log(rgb); // [255, 0, 0]

CMYK to RGB Conversion

This feature allows you to convert colors from the CMYK color space to the RGB color space. The code sample demonstrates converting a red color in CMYK to its RGB representation.

const colorSpace = require('color-space');
const cmyk = [0, 1, 1, 0];
const rgb = colorSpace.cmyk.rgb(cmyk);
console.log(rgb); // [255, 0, 0]

XYZ to LAB Conversion

This feature allows you to convert colors from the XYZ color space to the LAB color space. The code sample demonstrates converting a color in XYZ to its LAB representation.

const colorSpace = require('color-space');
const xyz = [41.24, 21.26, 1.93];
const lab = colorSpace.xyz.lab(xyz);
console.log(lab); // [53.23288178584245, 80.10930952982204, 67.22006831026425]

Other packages similar to color-space

color-convert

The color-convert package provides similar functionality for converting between different color spaces. It supports a wide range of color spaces and offers a simple API for conversions. Compared to color-space, color-convert is more focused on providing a straightforward conversion API without additional manipulation features.

chroma-js

Chroma.js is a powerful library for color manipulation and conversion. It supports a wide range of color spaces and provides additional features for color interpolation, blending, and more. Compared to color-space, Chroma.js offers more advanced color manipulation capabilities and a more user-friendly API.

tinycolor2

TinyColor is a small, fast library for color manipulation and conversion. It supports a variety of color spaces and provides a simple API for common color operations. Compared to color-space, TinyColor is more lightweight and focused on providing essential color manipulation features.

README

Color-space

Conversions and data for color spaces. Demo.

Usage

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

//convert lab to lch
var result = space.lab.lch([80,50,60]);

You can require a separate space to reduce size significantly:

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

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

API

<fromSpace>.<toSpace>(array);
<space>.name //space name
<space>.min //channel minimums
<space>.max //channel maximums
<space>.channel //channel names
<space>.alias //alias space names

Spaces

• RGB — additive color model based on red, green and blue primary colors.
• HSL — cylindrical-coordinates representation of RGB.
• HSV, HSB
• HWB
• HSI — used for computer vision due to better separation of shapes in an image, comparing to HSL/HSB.
• CMYK
• CMY
• XYZ
• XYY (YXY)
• LAB
• LCH_ab
• LUV
• LCH_uv
• H_uSL
• H_uSL_p
• LAB_Hunter
• YUV
• YIQ
• YC_gC_o
• YD_bD_r
• YP_bP_r
• YC_bC_r
• Y_cC_bcC_rc
• JPEG
• XvYCC
• UCS
• UVW
• Munsell
• NCS
• PMS
• RAL
• TSL
• RG
• RGK
• Coloroid — color space for architects and visual constructors, Hungarian Standard MSZ 7300 since 2000.
• OSA-UCS — accurately reprsenting uniform color differences, developed by the Optical Society of America’s Committee on Uniform Color Scales.
• HKS
• LMS — represents sensitivity of the human eye to Long, Medium and Short wavelengths.
• Cubehelix — colormaps for data visualization.
• Gray
• CIECAM02
• US Federal Standard 595
• Toyo
• PhotoYCC
• HCG
• HCL
• HSP
• HCY
• YES — computationally effective color space for face recognition.
• British Standard Colour
• RG chromacity
• CIE DSH
• HSM

Contribute

Please fork, add color space with basic conversions to/from XYZ or RGB and tests. The goal of project is to provide the most complete set of color spaces with maximally minimal uniform API.

Credits

Thanks to all the color scientists, who devoted their lives to color research and delivered their knowledge to us, for now we can trust them and use their formulas and their code.

Backers

Support us with a monthly donation and help us continue our activities. [Become a backer]

Sponsors

Become a sponsor and get your logo on our README on Github with a link to your site. [Become a sponsor]

Related

• colormap — collection of colormaps to map colors of images/data. A replacement for visualising spaces like cubehelix.
• color-spectrum — convert spectrum to a color.
• color-interpolate — interpolate between color values.
• color-tool — color picker based on color-space.

Similar projects

• color-convert
• chromatist
• spectra
• colorspaces.js