Color Art
A rust crate for working with colors and color spaces.
Documentation
See Color Art.
Usage
Add Dependency
[dependencies]
color-art = "0.2"
Color generator
You can use the from_str method to construct a color from a string.
Currently supported color formats:
- RGB
- RGBA
- HEX
- HSL
- HSV
- HWB
- CMYK
- Named color from w3cx11
For example:
use color_art::Color;
use std::str::FromStr;
let color = Color::from_str("rgb(255, 255, 0)").unwrap();
let color = Color::from_str("rgba(255, 255, 0, 0.5)").unwrap();
let color = Color::from_str("#ffff00").unwrap();
let color = Color::from_str("hsl(60, 100%, 50%)").unwrap();
let color = Color::from_str("hsv(60, 100%, 100%)").unwrap();
let color = Color::from_str("hwb(60, 0%, 0%)").unwrap();
let color = Color::from_str("cmyk(0%, 0%, 100%, 0%)").unwrap();
let color = Color::from_str("yellow").unwrap();
Other color generator methods:
- random - Generate a random color.
- mix - Mix two colors.
- blend - Blend two colors with a blending mode.
- average - Average a list of colors.
Color conversion
Stringify a color
Stringify a color to a string. You can use the hex, rgb, rgba, hsl, hsv, hwb, name method to stringify a color to a string. For example:
use color_art::Color;
use std::str::FromStr;
let color = Color::from_str("#ffff00").unwrap();
color.hex(); // "#ffff00"
color.rgb(); // "rgb(255, 255, 0)"
color.rgba(); // "rgba(255, 255, 0, 1)"
color.hsl(); // "hsl(60, 100%, 50%)"
color.hsv(); // "hsv(60, 100%, 100%)"
color.hwb(); // "hwb(60, 0%, 0%)"
color.cmyk(); // "cmyk(0%, 0%, 100%, 0%)"
color.name(); // "yellow"
Color Channel
You can use the red, green, blue, alpha, hue, saturation, lightness, hsv_hue, hsv_saturation, hsv_value, luma, luminance method to extract the color channel.
use color_art::Color;
use std::str::FromStr;
let color = Color::from_str("#abcdef").unwrap();
color.red(); // 171
color.green(); // 205
color.blue(); // 239
color.alpha(); // 1.0
color.hue(); // 210.0
color.saturation(); // 0.68
color.lightness(); // 0.8
color.hsv_hue(); // 210.0
color.hsv_saturation(); // 0.28
color.hsv_value(); // 0.94
color.luma(); // 0.59
color.luminance(); // 0.79
Color Operation
- darken - Darken a color.
- lighten - Lighten a color.
- saturate - Saturate a color.
- desaturate - Desaturate a color.
- greyscale - Greyscale a color.
- fade - Fade a color.
- fade in - Fade in a color.
- fade out - Fade out a color.
- spin - Spin a color.
- mix - Mix with another color.
- tint - Tint a color.
- shade - Shade a color.
More details, please refer to Color Operation.
Made with
30 Dec 29, 2022
50 Apr 26, 2023
169 Dec 25, 2022
1 Apr 6, 2022
4 Apr 18, 2023
168 Apr 25, 2023
8 Dec 15, 2022
15 Nov 1, 2022
1 Nov 8, 2021
6 Jan 31, 2023
24 Dec 29, 2022
13 Nov 2, 2022
5 Jul 28, 2022
15 Oct 27, 2021
6 Aug 16, 2023
12 Jun 16, 2023
13 Dec 7, 2022
1.2k Dec 19, 2022