color-art 0.1.6

A rust crate for working with colors and color spaces.
Documentation

Color Art

A rust crate for working with colors and color spaces.

Documentation

See Color Art.

Usage

Add Dependency

[dependencies]

color-art = "0.1"

Color generation

Color Space

Construct a color from a string. You can use the from_str method to construct a color from a string. Currently supported color spaces are:

  • RGB
  • RGBA
  • HEX
  • HSL
  • HSV
  • 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("yellow").unwrap();

Random

You can use the random method to construct a random color.

use color_art::Color;

let color = Color::random();

Color conversion

Stringify a color

Stringify a color to a string. You can use the hex, rgb, rgba, hsl, hsv, 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.name(); // "yellow"

Color Channel

You can use the red, green, blue, hue, saturation, lightness, alpha method to extract the color channel.

use color_art::Color;
use std::str::FromStr;

let color = Color::from_str("#ffff00").unwrap();
color.red(); // 255
color.green(); // 255
color.blue(); // 0
color.hue(); // 60.0
color.saturation(); // 1.0
color.lightness(); // 0.5
color.alpha(); // 1.0

Color Operation

More details, please refer to Color Operation.


Made with ❤️ by JiatLn.

License

MIT License © 2022-Present JiatLn