culori

What is culori?

The 'culori' npm package is a comprehensive color library for JavaScript that provides a wide range of functionalities for color manipulation, conversion, and analysis. It supports various color spaces and formats, making it a versatile tool for developers working with colors in web development, data visualization, and other applications.

What are culori's main functionalities?

Color Conversion

This feature allows you to convert colors between different color spaces. In the example, an RGB color is converted to the LAB color space.

const culori = require('culori');
const rgbColor = culori.rgb('#ff0000');
const labColor = culori.lab(rgbColor);
console.log(labColor);

Color Manipulation

This feature provides functions to manipulate colors, such as lightening or darkening them. The example demonstrates how to lighten an HSL color.

const culori = require('culori');
const color = culori.hsl({ h: 0, s: 1, l: 0.5 });
const lighterColor = culori.lighten(color, 0.2);
console.log(lighterColor);

Color Parsing

This feature allows you to parse color strings into color objects. The example shows how to parse a hex color string into an RGB color object.

const culori = require('culori');
const color = culori.parse('#ff0000');
console.log(color);

Color Interpolation

This feature enables color interpolation between two or more colors. The example demonstrates how to find a color that is halfway between red and blue.

const culori = require('culori');
const interpolate = culori.interpolate(['#ff0000', '#0000ff']);
const midColor = interpolate(0.5);
console.log(midColor);

Color Difference

This feature allows you to calculate the difference between two colors. The example shows how to compute the Euclidean difference between red and green colors.

const culori = require('culori');
const color1 = culori.rgb('#ff0000');
const color2 = culori.rgb('#00ff00');
const difference = culori.differenceEuclidean(color1, color2);
console.log(difference);

Other packages similar to culori

chroma-js

Chroma.js is another popular color library for JavaScript that provides similar functionalities for color manipulation, conversion, and analysis. It supports various color spaces and offers a rich set of features for working with colors. Compared to 'culori', Chroma.js has a more extensive API for color scales and palettes, making it particularly useful for data visualization.

color

The 'color' npm package is a versatile library for color conversion and manipulation. It supports a wide range of color spaces and provides methods for color transformations. While 'culori' focuses on a broader set of color spaces and more advanced color science features, 'color' is simpler and easier to use for basic color operations.

tinycolor2

TinyColor2 is a lightweight color manipulation library that offers basic functionalities for color conversion, manipulation, and analysis. It is designed to be small and fast, making it suitable for performance-sensitive applications. Compared to 'culori', TinyColor2 has a more limited feature set but is easier to integrate into projects where minimal overhead is desired.

README

Culori is a comprehensive color library for JavaScript that works across many color spaces to offer conversion, interpolation, color difference formulas, blending functions, and more. It provides up-to-date support for the color spaces defined in CSS Color Module Level 4 specification.

npm install culori

The full documentation is published on culorijs.org. Some quick entry points:

• Getting started
• API References
• Supported color spaces

Contributing

Contributions of any kind (feedback, ideas, bug fixes) are welcome. Please open a GitHub issue before starting work on anything that's not straightforward.