coolor

Crates.iocoolor
lib.rscoolor
version1.0.0
sourcesrc
created_at2021-11-10 19:12:21.760404
updated_at2024-08-12 08:47:00.61327
descriptionconversion between color formats
homepage
repositoryhttps://github.com/Canop/coolor
max_upload_size
id479867
size216,091
Denys Séguret (Canop)

documentation

README

MIT Latest Version docs Chat on Miaou

Definition of ANSI, RGB and HSL color types and all the conversions between them.

There are many other color conversion crates. This one is no-std and pure-rust and may be useful when you're interested into

  • variations of an ANSI color for your TUI application, for example fading, lightening, darkening, with compatibility with terminals that don't support RGB.
  • translations of color schemes
  • automatic downgrading of RGB color schemes for non RGB terminals
  • automated building of harmonious color schemes with guarantees of contrast
  • etc.

Coolor is used in SafeCloset to dynamically fade the background behind a dialog:

img

Be warned that the ANSI range is intrinsically limited to 240 colors and that not all intuitive operations will give good results.

Coolor doesn't contain functions to print on the terminal, but the colors can be used in other crates. There's an optional feature for conversion from and into Crossterm colors. You'll see it used in the included examples.

Included Examples

ansi-variations

Luminosity and saturation variations of all 240 ANSI colors, with all variants still ANSI colors.

ansi-variations

ansi-mix

Several ways to mix colors

ansi-mix

rgb-to-ansi

Finding the nearest ANSI color from a RGB one

rgb-to-ansi

Commit count: 22

cargo fmt