Enum Color 

pub enum Color {
    Rgb(Rgb),
    LinearRgb(LinearRgb),
    Hsl(Hsl),
    Hsv(Hsv),
    Hwb(Hwb),
    Lab(Lab),
    Lab65(Lab65),
    Lch(Lch),
    Lch65(Lch65),
    Oklab(Oklab),
    Oklch(Oklch),
    Xyz50(Xyz50),
    Xyz65(Xyz65),
    P3(P3),
    Rec2020(Rec2020),
    A98(A98),
    ProphotoRgb(ProphotoRgb),
    Cubehelix(Cubehelix),
    Dlab(Dlab),
    Dlch(Dlch),
    Jab(Jab),
    Jch(Jch),
    Yiq(Yiq),
    Hsi(Hsi),
    Hsluv(Hsluv),
    Hpluv(Hpluv),
    Okhsl(Okhsl),
    Okhsv(Okhsv),
    Itp(Itp),
    Xyb(Xyb),
    Luv(Luv),
    Lchuv(Lchuv),
    Prismatic(Prismatic),
}

Tagged union over every supported color space. Variants are added as each space lands.

Variants

Rgb(Rgb)

sRGB.

LinearRgb(LinearRgb)

Linear-sRGB.

Hsl(Hsl)

HSL (cylindrical sRGB).

Hsv(Hsv)

HSV (cylindrical sRGB).

Hwb(Hwb)

HWB (hue/whiteness/blackness).

Lab(Lab)

CIE Lab D50.

Lab65(Lab65)

CIE Lab D65.

Lch(Lch)

CIE Lch D50 (polar Lab).

Lch65(Lch65)

CIE Lch D65 (polar Lab65).

Oklab(Oklab)

Oklab (perceptually uniform).

Oklch(Oklch)

Oklch (polar Oklab).

Xyz50(Xyz50)

CIE XYZ D50.

Xyz65(Xyz65)

CIE XYZ D65.

P3(P3)

Display P3.

Rec2020(Rec2020)

Rec. 2020.

A98(A98)

Adobe RGB (1998).

ProphotoRgb(ProphotoRgb)

ProPhoto RGB.

Cubehelix(Cubehelix)

Cubehelix (Dave Green’s astronomical color scheme as a space).

Dlab(Dlab)

DIN99o Lab (rectangular form of DIN99o LCh).

Dlch(Dlch)

DIN99o LCh (polar form).

Jab(Jab)

JzAzBz (HDR perceptual Lab).

Jch(Jch)

JzCzHz (polar form of JzAzBz).

Yiq(Yiq)

NTSC Y’IQ.

Hsi(Hsi)

HSI (Hue/Saturation/Intensity).

Hsluv(Hsluv)

HSLuv (perceptually uniform HSL).

Hpluv(Hpluv)

HPLuv (perceptually uniform HSL, pastel).

Okhsl(Okhsl)

OkHSL (Oklab-derived HSL).

Okhsv(Okhsv)

OkHSV (Oklab-derived HSV).

Itp(Itp)

ICtCp (HDR perceptual, Rec. BT.2100).

Xyb(Xyb)

XYB (JPEG XL).

Luv(Luv)

CIELUV (D50).

Lchuv(Lchuv)

CIELChuv (polar form of CIELUV).

Prismatic(Prismatic)

Prismatic (intensity + barycentric chromaticity, Hauke 2009). culors extension; not in culori 4.0.2.

Implementations

impl Color

pub fn mode(&self) -> &'static str

Returns the culori mode string for this color’s underlying space ("rgb", "lab", "oklch", etc.). Identical to the corresponding space struct’s ColorSpace::MODE.

impl Color

pub fn convert_to(&self, target_mode: &str) -> Option<Color>

Convert this color to the named target color space, mirroring culori’s converter(target_mode)(self) dispatch.

Returns None if target_mode is not a recognized culori mode string. Recognized modes match the ColorSpace::MODE constants of every space implemented by this crate ("rgb", "hsl", "hsv", "hwb", "lab", "lab65", "lch", "lch65", "oklab", "oklch", "xyz50", "xyz65", "p3", "rec2020", "a98", "prophoto", "lrgb", "cubehelix", "dlab", "dlch", "jab", "jch", "yiq", "hsi", "hsluv", "hpluv", "okhsl", "okhsv", "itp", "xyb", "luv", "lchuv", "prismatic").

Routing semantics

For every pair (from, target_mode) where culori 4.0.2’s converters table has a direct entry, this method takes the same path. For pairs without a direct entry, both this method and culori route through rgb. Output agrees with culori.converter(target_mode)(self) to within 1e-13 per channel across the full pair matrix (see fixture suite).

Contrast with crate::convert() which always routes through XYZ D65 and so accumulates ~1e-14 drift on pairs where culori takes a shorter path.

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 From<A98> for Color

fn from(c: A98) -> Self

Converts to this type from the input type.

impl From<Cubehelix> for Color

fn from(c: Cubehelix) -> Self

Converts to this type from the input type.

impl From<Dlab> for Color

fn from(c: Dlab) -> Self

Converts to this type from the input type.

impl From<Dlch> for Color

fn from(c: Dlch) -> Self

Converts to this type from the input type.

impl From<Hpluv> for Color

fn from(c: Hpluv) -> Self

Converts to this type from the input type.

impl From<Hsi> for Color

fn from(c: Hsi) -> Self

Converts to this type from the input type.

impl From<Hsl> for Color

fn from(c: Hsl) -> Self

Converts to this type from the input type.

impl From<Hsluv> for Color

fn from(c: Hsluv) -> Self

Converts to this type from the input type.

impl From<Hsv> for Color

fn from(c: Hsv) -> Self

Converts to this type from the input type.

impl From<Hwb> for Color

fn from(c: Hwb) -> Self

Converts to this type from the input type.

impl From<Itp> for Color

fn from(c: Itp) -> Self

Converts to this type from the input type.

impl From<Jab> for Color

fn from(c: Jab) -> Self

Converts to this type from the input type.

impl From<Jch> for Color

fn from(c: Jch) -> Self

Converts to this type from the input type.

impl From<Lab> for Color

fn from(c: Lab) -> Self

Converts to this type from the input type.

impl From<Lab65> for Color

fn from(c: Lab65) -> Self

Converts to this type from the input type.

impl From<Lch> for Color

fn from(c: Lch) -> Self

Converts to this type from the input type.

impl From<Lch65> for Color

fn from(c: Lch65) -> Self

Converts to this type from the input type.

impl From<Lchuv> for Color

fn from(c: Lchuv) -> Self

Converts to this type from the input type.

impl From<LinearRgb> for Color

fn from(c: LinearRgb) -> Self

Converts to this type from the input type.

impl From<Luv> for Color

fn from(c: Luv) -> Self

Converts to this type from the input type.

impl From<Okhsl> for Color

fn from(c: Okhsl) -> Self

Converts to this type from the input type.

impl From<Okhsv> for Color

fn from(c: Okhsv) -> Self

Converts to this type from the input type.

impl From<Oklab> for Color

fn from(c: Oklab) -> Self

Converts to this type from the input type.

impl From<Oklch> for Color

fn from(c: Oklch) -> Self

Converts to this type from the input type.

impl From<P3> for Color

fn from(c: P3) -> Self

Converts to this type from the input type.

impl From<Prismatic> for Color

fn from(c: Prismatic) -> Self

Converts to this type from the input type.

impl From<ProphotoRgb> for Color

fn from(c: ProphotoRgb) -> Self

Converts to this type from the input type.

impl From<Rec2020> for Color

fn from(c: Rec2020) -> Self

Converts to this type from the input type.

impl From<Rgb> for Color

fn from(c: Rgb) -> Self

Converts to this type from the input type.

impl From<Xyb> for Color

fn from(c: Xyb) -> Self

Converts to this type from the input type.

impl From<Xyz50> for Color

fn from(c: Xyz50) -> Self

Converts to this type from the input type.

impl From<Xyz65> for Color

fn from(c: Xyz65) -> Self

Converts to this type from the input type.

impl From<Yiq> for Color

fn from(c: Yiq) -> Self

Converts to this type from the input type.

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 TryFrom<Color> for A98

type Error = ColorVariantMismatch

The type returned in the event of a conversion error.

fn try_from(c: Color) -> Result<Self, Self::Error>

Performs the conversion.

impl TryFrom<Color> for Cubehelix

type Error = ColorVariantMismatch

The type returned in the event of a conversion error.

fn try_from(c: Color) -> Result<Self, Self::Error>

Performs the conversion.

impl TryFrom<Color> for Dlab

type Error = ColorVariantMismatch

The type returned in the event of a conversion error.

fn try_from(c: Color) -> Result<Self, Self::Error>

Performs the conversion.

impl TryFrom<Color> for Dlch

type Error = ColorVariantMismatch

The type returned in the event of a conversion error.

fn try_from(c: Color) -> Result<Self, Self::Error>

Performs the conversion.

impl TryFrom<Color> for Hpluv

type Error = ColorVariantMismatch

The type returned in the event of a conversion error.

fn try_from(c: Color) -> Result<Self, Self::Error>

Performs the conversion.

impl TryFrom<Color> for Hsi

type Error = ColorVariantMismatch

The type returned in the event of a conversion error.

fn try_from(c: Color) -> Result<Self, Self::Error>

Performs the conversion.

impl TryFrom<Color> for Hsl

type Error = ColorVariantMismatch

The type returned in the event of a conversion error.

fn try_from(c: Color) -> Result<Self, Self::Error>

Performs the conversion.

impl TryFrom<Color> for Hsluv

type Error = ColorVariantMismatch

The type returned in the event of a conversion error.

fn try_from(c: Color) -> Result<Self, Self::Error>

Performs the conversion.

impl TryFrom<Color> for Hsv

type Error = ColorVariantMismatch

The type returned in the event of a conversion error.

fn try_from(c: Color) -> Result<Self, Self::Error>

Performs the conversion.

impl TryFrom<Color> for Hwb

type Error = ColorVariantMismatch

The type returned in the event of a conversion error.

fn try_from(c: Color) -> Result<Self, Self::Error>

Performs the conversion.

impl TryFrom<Color> for Itp

type Error = ColorVariantMismatch

The type returned in the event of a conversion error.

fn try_from(c: Color) -> Result<Self, Self::Error>

Performs the conversion.

impl TryFrom<Color> for Jab

type Error = ColorVariantMismatch

The type returned in the event of a conversion error.

fn try_from(c: Color) -> Result<Self, Self::Error>

Performs the conversion.

impl TryFrom<Color> for Jch

type Error = ColorVariantMismatch

The type returned in the event of a conversion error.

fn try_from(c: Color) -> Result<Self, Self::Error>

Performs the conversion.

impl TryFrom<Color> for Lab

type Error = ColorVariantMismatch

The type returned in the event of a conversion error.

fn try_from(c: Color) -> Result<Self, Self::Error>

Performs the conversion.

impl TryFrom<Color> for Lab65

type Error = ColorVariantMismatch

The type returned in the event of a conversion error.

fn try_from(c: Color) -> Result<Self, Self::Error>

Performs the conversion.

impl TryFrom<Color> for Lch

type Error = ColorVariantMismatch

The type returned in the event of a conversion error.

fn try_from(c: Color) -> Result<Self, Self::Error>

Performs the conversion.

impl TryFrom<Color> for Lch65

type Error = ColorVariantMismatch

The type returned in the event of a conversion error.

fn try_from(c: Color) -> Result<Self, Self::Error>

Performs the conversion.

impl TryFrom<Color> for Lchuv

type Error = ColorVariantMismatch

The type returned in the event of a conversion error.

fn try_from(c: Color) -> Result<Self, Self::Error>

Performs the conversion.

impl TryFrom<Color> for LinearRgb

type Error = ColorVariantMismatch

The type returned in the event of a conversion error.

fn try_from(c: Color) -> Result<Self, Self::Error>

Performs the conversion.

impl TryFrom<Color> for Luv

type Error = ColorVariantMismatch

The type returned in the event of a conversion error.

fn try_from(c: Color) -> Result<Self, Self::Error>

Performs the conversion.

impl TryFrom<Color> for Okhsl

type Error = ColorVariantMismatch

The type returned in the event of a conversion error.

fn try_from(c: Color) -> Result<Self, Self::Error>

Performs the conversion.

impl TryFrom<Color> for Okhsv

type Error = ColorVariantMismatch

The type returned in the event of a conversion error.

fn try_from(c: Color) -> Result<Self, Self::Error>

Performs the conversion.

impl TryFrom<Color> for Oklab

type Error = ColorVariantMismatch

The type returned in the event of a conversion error.

fn try_from(c: Color) -> Result<Self, Self::Error>

Performs the conversion.

impl TryFrom<Color> for Oklch

type Error = ColorVariantMismatch

The type returned in the event of a conversion error.

fn try_from(c: Color) -> Result<Self, Self::Error>

Performs the conversion.

impl TryFrom<Color> for P3

type Error = ColorVariantMismatch

The type returned in the event of a conversion error.

fn try_from(c: Color) -> Result<Self, Self::Error>

Performs the conversion.

impl TryFrom<Color> for Prismatic

type Error = ColorVariantMismatch

The type returned in the event of a conversion error.

fn try_from(c: Color) -> Result<Self, Self::Error>

Performs the conversion.

impl TryFrom<Color> for ProphotoRgb

type Error = ColorVariantMismatch

The type returned in the event of a conversion error.

fn try_from(c: Color) -> Result<Self, Self::Error>

Performs the conversion.

impl TryFrom<Color> for Rec2020

type Error = ColorVariantMismatch

The type returned in the event of a conversion error.

fn try_from(c: Color) -> Result<Self, Self::Error>

Performs the conversion.

impl TryFrom<Color> for Rgb

type Error = ColorVariantMismatch

The type returned in the event of a conversion error.

fn try_from(c: Color) -> Result<Self, Self::Error>

Performs the conversion.

impl TryFrom<Color> for Xyb

type Error = ColorVariantMismatch

The type returned in the event of a conversion error.

fn try_from(c: Color) -> Result<Self, Self::Error>

Performs the conversion.

impl TryFrom<Color> for Xyz50

type Error = ColorVariantMismatch

The type returned in the event of a conversion error.

fn try_from(c: Color) -> Result<Self, Self::Error>

Performs the conversion.

impl TryFrom<Color> for Xyz65

type Error = ColorVariantMismatch

The type returned in the event of a conversion error.

fn try_from(c: Color) -> Result<Self, Self::Error>

Performs the conversion.

impl TryFrom<Color> for Yiq

type Error = ColorVariantMismatch

The type returned in the event of a conversion error.

fn try_from(c: Color) -> Result<Self, Self::Error>

Performs the conversion.

impl Copy for Color

impl StructuralPartialEq for Color