Struct Color 

pub struct Color {
    pub r: u8,
    pub g: u8,
    pub b: u8,
}

A color represented as RGB components. All values are compile-time constants with zero runtime cost.

Fields

r: u8

Red component (0–255).

g: u8

Green component (0–255).

b: u8

Blue component (0–255).

Implementations

impl Color

pub const fn new(r: u8, g: u8, b: u8) -> Self

Construct a Color from RGB components.

Examples

use chromata::Color;

let red = Color::new(255, 0, 0);
assert_eq!(red.r, 255);
assert_eq!(red.g, 0);

pub const fn from_hex(hex: u32) -> Self

Construct a Color from a 24-bit hex value (0xRRGGBB).

Examples

use chromata::Color;

let c = Color::from_hex(0x1d2021);
assert_eq!(c.r, 0x1d);
assert_eq!(c.g, 0x20);
assert_eq!(c.b, 0x21);

pub const fn to_hex(self) -> u32

Return the color as a 24-bit hex value.

Examples

use chromata::Color;

let c = Color::new(0x1d, 0x20, 0x21);
assert_eq!(c.to_hex(), 0x1d2021);

pub fn to_css_hex(self) -> String

Return the color as a CSS hex string like “#1d2021”.

Examples

use chromata::Color;

let c = Color::from_hex(0x1d2021);
assert_eq!(c.to_css_hex(), "#1d2021");

pub const fn to_f32(self) -> (f32, f32, f32)

Convert to an (f32, f32, f32) tuple in [0.0, 1.0] range.

Examples

use chromata::Color;

let white = Color::new(255, 255, 255);
let (r, g, b) = white.to_f32();
assert!((r - 1.0).abs() < f32::EPSILON);

pub fn luminance(self) -> f64

Relative luminance per WCAG 2.0.

Returns a value between 0.0 (black) and 1.0 (white).

Examples

use chromata::Color;

let black = Color::new(0, 0, 0);
let white = Color::new(255, 255, 255);
assert!((black.luminance()).abs() < 0.001);
assert!((white.luminance() - 1.0).abs() < 0.001);

pub fn contrast_ratio(self, other: Color) -> f64

WCAG contrast ratio between two colors.

Returns a value between 1.0 (identical) and 21.0 (black vs white).

Examples

use chromata::Color;

let black = Color::new(0, 0, 0);
let white = Color::new(255, 255, 255);
let ratio = black.contrast_ratio(white);
assert!(ratio > 20.0); // ~21:1 for black/white

pub fn lerp(self, other: Color, t: f32) -> Color

Linear interpolation between two colors.

t is clamped to [0.0, 1.0]. Interpolation is performed in sRGB space.

Examples

use chromata::Color;

let black = Color::new(0, 0, 0);
let white = Color::new(255, 255, 255);
let mid = black.lerp(white, 0.5);
assert_eq!(mid, Color::new(127, 127, 127));

Trait Implementations

impl Clone for Color

fn clone(&self) -> Color

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for Color

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Display for Color

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Hash for Color

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl PartialEq for Color

fn eq(&self, other: &Color) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Copy for Color

impl Eq for Color

impl StructuralPartialEq for Color