Skip to content

Latest commit

 

History

History
51 lines (32 loc) · 3.34 KB

README.md

File metadata and controls

51 lines (32 loc) · 3.34 KB
Raw

ocaml-hsluv

HSLuv human-friendly color space implementation in OCaml.

See https://www.hsluv.org/.

Description

This OCaml package implements the HSLuv color space model, providing a perceptually uniform alternative to traditional HSL. It includes functions for converting between HSLuv/HPLuv and other color spaces like RGB, XYZ, and Luv.

The HSLuv color space is particularly beneficial in scenarios where perceptual uniformity and intuitive color manipulation are crucial:

  1. Design and Visualization: Ideal for creating balanced and harmonious color palettes with consistent hues.

  2. Data Representation: Useful in data visualization for accurate and non-misleading representations, such as in heatmaps and graphs.

  3. Accessibility in User Interfaces: Helps in maintaining consistent contrast, crucial for users with visual impairments.

  4. Digital Art and Image Processing: Offers fine-tuning of colors for subtle and precise adjustments.

In summary, HSLuv's appeal lies in its ability to provide visually consistent and natural-looking colors, making it suitable for design, data visualization, and artistic applications.

Implementation Notes

This started as a port of the Go implementation of hsluv.org.

The following color conversions are provided:

From/To HSLuv HPLuv RGB XYZ LUV LCH HEX
HSLuv - - hsluv_to_rgb - - conv_hsluv_lch hsluv_to_hex
HPLuv - - hpluv_to_rgb - - conv_hpluv_lch hpluv_to_hex
RGB hsluv_from_rgb hpluv_from_rgb - conv_rgb_xyz - conv_rgb_lch conv_rgb_hex
XYZ - - conv_xyz_rgb - conv_xyz_luv - -
LUV - - - conv_luv_xyz - conv_luv_lch -
LCH conv_lch_hsluv conv_lch_hpluv conv_lch_rgb - conv_luv_lch - -
HEX hsluv_from_hex hpluv_from_hex conv_hex_rgb - - - -

In addition to the HSLuv and HPLuv conversion functions, this package also exposes

  • color conversion functions between the various color spaces used to enable the HSLuv and HPluv conversions
  • pretty printers pp_hsluv, pp_hpluv, etc.
  • a library hsluv.float_conv for conversions between float triples and the provided color types

Tests

The implementation is tested against the hsluv snapshot (revision 4). Tests for all conversion functions are included and can be run with

opam exec -- dune test