Enum picto::color::Color [−][src]
pub enum Color<T = f32> where
T: Float, {
Luma(Luma<T>),
Rgb(Rgb<T>),
Xyz(Xyz<T>),
Yxy(Yxy<T>),
Lab(Lab<T>),
Lch(Lch<T>),
Hsv(Hsv<T>),
Hsl(Hsl<T>),
Hwb(Hwb<T>),
}
Expand description
A generic color type.
The Color
may belong to any color space and it may change
depending on which operation is performed. That makes it immune to
the “without conversion” rule of the operations it supports. The
color spaces are selected as follows:
Mix
: RGB for no particular reason, except that it’s intuitive.Shade
: CIE Lab* for its luminance component.Hue
andGetHue
: CIE LCh° for its hue component and how it preserves the apparent lightness.Saturate
: CIE LCh° for its chromaticity component and how it preserves the apparent lightness.
It’s not recommended to use Color
when full control is necessary,
but it can easily be converted to a fixed color space in those
cases.
Variants
Luma(Luma<T>)
Tuple Fields
0: Luma<T>
Linear luminance.
Rgb(Rgb<T>)
Tuple Fields
0: Rgb<T>
Linear RGB.
Xyz(Xyz<T>)
Tuple Fields
0: Xyz<T>
CIE 1931 XYZ.
Yxy(Yxy<T>)
Tuple Fields
0: Yxy<T>
CIE 1931 Yxy.
Lab(Lab<T>)
Tuple Fields
0: Lab<T>
CIE Lab* (CIELAB).
Lch(Lch<T>)
Tuple Fields
0: Lch<T>
CIE LCh°, a polar version of CIE Lab*.
Hsv(Hsv<T>)
Tuple Fields
0: Hsv<T>
Linear HSV, a cylindrical version of RGB.
Hsl(Hsl<T>)
Tuple Fields
0: Hsl<T>
Linear HSL, a cylindrical version of RGB.
Hwb(Hwb<T>)
Tuple Fields
0: Hwb<T>
Linear HWB, an intuitive cylindrical version of RGB.
Implementations
Trait Implementations
type Epsilon = <T as ApproxEq>::Epsilon
type Epsilon = <T as ApproxEq>::Epsilon
Used for specifying relative comparisons.
The default tolerance to use when testing values that are close together. Read more
The default relative tolerance for testing values that are far-apart. Read more
The default ULPs to tolerate when testing values that are far-apart. Read more
A test for equality that uses a relative comparison if the values are far apart.
A test for equality that uses units in the last place (ULP) if the values are far apart.
fn relative_ne(
&self,
other: &Self,
epsilon: Self::Epsilon,
max_relative: Self::Epsilon
) -> bool
fn relative_ne(
&self,
other: &Self,
epsilon: Self::Epsilon,
max_relative: Self::Epsilon
) -> bool
The inverse of ApproxEq::relative_eq
.
Convert the color to premultiplied alpha.
Convert the color from premultiplied alpha.
fn blend<F>(self, destination: Self, blend_function: F) -> Self where
F: BlendFunction<Self::Color>,
fn blend<F>(self, destination: Self, blend_function: F) -> Self where
F: BlendFunction<Self::Color>,
Blend self, as the source color, with destination
, using
blend_function
. Anything that implements BlendFunction
is
acceptable, including functions and closures. Read more
Place self
over other
. This is the good old common alpha
composition equation. Read more
Results in the parts of self
that overlaps the visible parts of
other
. Read more
Results in the parts of self
that lies outside the visible parts of
other
. Read more
Add self
and other
. This uses the alpha component to regulate the
effect, so it’s not just plain component wise addition. Read more
Multiply self
with other
. This uses the alpha component to regulate
the effect, so it’s not just plain component wise multiplication. Read more
Multiply self
or other
if other is dark, or screen them if other
is light. This results in an S curve. Read more
Lighten other
to reflect self
. Results in other
if self
is
black. Read more
Darken other
to reflect self
. Results in other
if self
is
white. Read more
Multiply self
or other
if other is dark, or screen them if self
is light. This is similar to overlay
, but depends on self
instead
of other
. Read more
Lighten other
if self
is light, or darken other
as if it’s burned
if self
is dark. The effect is increased if the components of self
is further from 0.5. Read more
Return the absolute difference between self
and other
. It’s
basically abs(self - other)
, but regulated by the alpha component. Read more
Auto Trait Implementations
impl<T> RefUnwindSafe for Color<T> where
T: RefUnwindSafe,
impl<T> UnwindSafe for Color<T> where
T: UnwindSafe,
Blanket Implementations
Mutably borrows from an owned value. Read more