A rust crate for working with colors and color spaces.
See Color Art.
toml
[dependencies]
color-art = "0.2"
You can use the from_str method to construct a color from a string.
Currently supported color formats
rgb / rgbahexhsl / hslahsvhsihwbcmykxyzyuvYCbCrlabnamed color
For example
```rust use color_art::Color; use std::str::FromStr;
let color = Color::fromstr("rgb(255, 255, 0)").unwrap(); let color = Color::fromstr("rgba(255, 255, 0, 0.5)").unwrap(); let color = Color::fromstr("#ffff00").unwrap(); let color = Color::fromstr("hsl(60, 100%, 50%)").unwrap(); let color = Color::fromstr("hsla(60, 100%, 50%, 0.6)").unwrap(); let color = Color::fromstr("hsv(60, 100%, 100%)").unwrap(); let color = Color::fromstr("hsi(60, 100%, 66.67%)").unwrap(); let color = Color::fromstr("hwb(60, 0%, 0%)").unwrap(); let color = Color::fromstr("cmyk(0%, 0%, 100%, 0%)").unwrap(); let color = Color::fromstr("xyz(0.932231, 0.975339, 0.502949)").unwrap(); let color = Color::fromstr("yuv(0.886, -0.4359, 0.1)").unwrap(); let color = Color::fromstr("YCbCr(225.93, 0.5755, 148.7269)").unwrap(); let color = Color::fromstr("lab(97.14, -21.55, 94.48)").unwrap(); let color = Color::fromstr("yellow").unwrap(); ```
You can use the from_num method to construct a color from a number.
For example:
```rust use color_art::Color;
let color = Color::fromnum(16776960).unwrap(); let color = Color::fromnum(0xffff00).unwrap(); ```
You can use the from_name method to construct a color from a name.
For example:
```rust use color_art::Color;
let color = Color::from_name("yellow").unwrap(); ```
You can use the from_<color_space> method to construct a color from a color space.
Currently supported color spaces:
rgb rgbahslhsvcmykhexMore color spaces will be supported in the future.
For example:
```rust use color_art::Color;
let color = Color::fromrgb(255, 255, 0).unwrap(); let color = Color::fromrgba(255, 255, 0, 0.5).unwrap(); let color = Color::fromhsl(60.0, 1.0, 0.5).unwrap(); let color = Color::fromhsv(60.0, 1.0, 1.0).unwrap(); let color = Color::fromcmyk(0.0, 0.0, 1.0, 0.0).unwrap(); let color = Color::fromhex("#ffff00").unwrap(); ```
More examples can be found in Construct from color spaces.
Stringify a color to a string.
You can use the hex, rgb, rgba, hsl, hsla, hsv, hsi, hwb, cmyk, xyz, yuv, YCbCr, lab, name method to stringify a color to a string.
For example
```rust use color_art::color;
let color = color!(#ffff00); color.hex(); // "#ff0" color.rgb(); // "rgb(255, 255, 0)" color.rgba(); // "rgba(255, 255, 0, 1)" color.hsl(); // "hsl(60, 100%, 50%)" color.hsla(); // "hsl(60, 100%, 50%, 1)" color.hsv(); // "hsv(60, 100%, 100%)" color.hsi(); // "hsi(60, 100%, 66.67%)" color.hwb(); // "hwb(60, 0%, 0%)" color.cmyk(); // "cmyk(0%, 0%, 100%, 0%)" color.xyz(); // "xyz(0.932231, 0.975339, 0.502949)" color.yuv(); // "yuv(0.886, -0.4359, 0.1)" color.ycbcr(); // "YCbCr(225.93, 0.5755, 148.7269)" color.name(); // "yellow" color.lab(); // "lab(97.14, -21.55, 94.48)" ```
You can use the red, green, blue, alpha, hue, saturation, lightness, hsv_hue, hsv_saturation, hsv_value, luma, luminance, gray method to extract the color channel.
For example
```rust use color_art::color;
let color = color!(#abcdef);
color.red(); // 171 color.green(); // 205 color.blue(); // 239 color.alpha(); // 1.0
color.hue(); // 210.0 color.saturation(); // 0.68 color.lightness(); // 0.8039
color.hsvhue(); // 210.0 color.hsvsaturation(); // 0.2845 color.hsv_value(); // 0.9373
color.luma(); // 0.59 color.luminance(); // 0.79
color.gray(); // 198.71 ```
More details, please refer to Color Operation.
Made with ❤️ by JiatLn.