Struct Color 

pub struct Color {
    pub r: f32,
    pub g: f32,
    pub b: f32,
    pub a: f32,
}

sRGB color with straight (non-premultiplied) alpha, components in 0..=1.

Interpolation (Lerp) happens in OKLab.

Fields

r: f32

Red, 0..=1 (sRGB-encoded).

g: f32

Green, 0..=1.

b: f32

Blue, 0..=1.

a: f32

Alpha (straight, not premultiplied), 0..=1.

Implementations

impl Color

pub const TRANSPARENT: Color

Fully transparent black.

pub const BLACK: Color

Opaque black.

pub const WHITE: Color

Opaque white.

pub const fn rgb(r: f32, g: f32, b: f32) -> Color

Opaque color from 0..=1 components.

pub const fn rgba(r: f32, g: f32, b: f32, a: f32) -> Color

Color from 0..=1 components with alpha.

pub const fn from_rgba8(r: u8, g: u8, b: u8, a: u8) -> Color

Color from 0..=255 components.

pub const fn from_hex(hex: &str) -> Option<Color>

Parses #rgb, #rgba, #rrggbb or #rrggbbaa (the # is optional).

pub fn with_alpha(self, a: f32) -> Color

The same color with another alpha.

pub fn to_rgba8(self) -> [u8; 4]

Components as 0..=255 bytes.

pub fn to_oklab(self) -> [f32; 3]

Converts to OKLab [L, a, b], the space colors are interpolated in.

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

WCAG contrast ratio against another color (1..=21). Alpha is ignored.

pub fn luminance(self) -> f32

Relative luminance, 0..=1, used to decide whether a color is light.

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

Mix in OKLab. t = 0 is self, t = 1 is other.

pub fn readable_on(self, against: Color, min: f32) -> Color

The same hue, lightened or darkened until contrast against against reaches min (WCAG). Already-sufficient colors are returned unchanged.

pub fn from_oklab(_: [f32; 3], alpha: f32) -> Color

Converts from OKLab [L, a, b].

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 Copy for Color

impl Debug for Color

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

Formats the value using the given formatter.

impl Display for Color

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

Formats the value using the given formatter.

impl From<Color> for Paint

fn from(c: Color) -> Self

Converts to this type from the input type.

impl From<Ink> for Color

fn from(ink: Ink) -> Color

Converts to this type from the input type.

impl IntoPaint for Color

fn into_paint(self) -> Color

Resolves to a color. An Ink uses the current theme.

impl Lerp for Color

Interpolates in OKLab so that midpoints keep perceived lightness.

fn lerp(&self, to: &Color, t: f64) -> Color

Value at t between self (0) and to (1); t may leave 0..=1.

impl PartialEq for Color

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for Color