pub struct Color {
pub space: ColorSpace,
pub red: f32,
pub green: f32,
pub blue: f32,
pub alpha: f32,
}Fields§
§space: ColorSpace§red: f32§green: f32§blue: f32§alpha: f32Implementations§
Source§impl Color
impl Color
pub const TRANSPARENT: Color
pub const BLACK: Color
pub const WHITE: Color
pub const fn new( space: ColorSpace, red: f32, green: f32, blue: f32, alpha: f32, ) -> Color
pub const fn rgba(red: f32, green: f32, blue: f32, alpha: f32) -> Color
pub const fn srgba(red: f32, green: f32, blue: f32, alpha: f32) -> Color
pub const fn linear_rgba(red: f32, green: f32, blue: f32, alpha: f32) -> Color
pub const fn display_p3(red: f32, green: f32, blue: f32, alpha: f32) -> Color
pub const fn linear_display_p3( red: f32, green: f32, blue: f32, alpha: f32, ) -> Color
pub const fn with_alpha(self, alpha: f32) -> Color
pub const fn to_array(self) -> [f32; 4]
pub fn clamped(self) -> Color
Sourcepub fn over(self, backdrop: Color) -> Color
pub fn over(self, backdrop: Color) -> Color
Source-over composite this (possibly translucent) color onto an opaque
backdrop, blending in the encoded (gamma) space — the same
arithmetic CSS uses for rgba() overlays. The renderer blends in
linear space, which reads translucent washes noticeably heavier than
their CSS-authored intent, so design tokens specified as CSS rgba
values should be flattened with this before painting.
Both colors must be in the same encoded space; the backdrop’s alpha is treated as 1. The result is opaque.
pub fn to_linear_srgb(self) -> Color
Sourcepub fn to_space(self, space: ColorSpace) -> Color
pub fn to_space(self, space: ColorSpace) -> Color
Convert this color to space, keeping alpha. Channels are not clamped,
so colors outside the target gamut keep their out-of-range values.
Sourcepub fn mix_oklab(self, to: Color, amount: f32) -> Color
pub fn mix_oklab(self, to: Color, amount: f32) -> Color
Blend toward to by amount (0 to 1) in premultiplied OKLab, the
perceptual mixing CSS color-mix() uses by default.
Blending the premultiplied values keeps a fade from a transparent
color free of a dark fringe: the color holds steady while only its
opacity changes. The endpoints are returned exactly, and blends between
colors in different spaces come out in to’s space.
Sourcepub fn oklch(lightness: f32, chroma: f32, hue: f32) -> Color
pub fn oklch(lightness: f32, chroma: f32, hue: f32) -> Color
Build an encoded sRGB color from OKLCH coordinates, reducing chroma
until the color fits the sRGB gamut. See Oklch::to_srgb.
Sourcepub fn to_oklch(self) -> Oklch
pub fn to_oklch(self) -> Oklch
Convert this color to OKLCH. Channels outside the displayable range are converted as-is, so wide-gamut and extended-range colors keep their chroma.
Sourcepub fn relative_luminance(self) -> f32
pub fn relative_luminance(self) -> f32
WCAG 2 relative luminance of the opaque color, clamped to the SDR range.
Sourcepub fn contrast_ratio(self, other: Color) -> f32
pub fn contrast_ratio(self, other: Color) -> f32
WCAG 2 contrast ratio between two opaque colors, from 1.0 to 21.0.
Trait Implementations§
impl Copy for Color
Source§impl From<Color> for AnimationValue
impl From<Color> for AnimationValue
Source§fn from(value: Color) -> AnimationValue
fn from(value: Color) -> AnimationValue
Source§impl Interpolate for Color
Colors blend in premultiplied OKLab (see Color::mix_oklab): mixes are
perceptually even, and fades from a transparent color keep their hue
instead of passing through a dark fringe.
impl Interpolate for Color
Colors blend in premultiplied OKLab (see Color::mix_oklab): mixes are
perceptually even, and fades from a transparent color keep their hue
instead of passing through a dark fringe.
fn interpolate(from: Color, to: Color, t: f32) -> Color
Source§fn extrapolate(from: Self, to: Self, t: f32) -> Self
fn extrapolate(from: Self, to: Self, t: f32) -> Self
Interpolate::interpolate, but lets t leave 0..=1 so a
spring can overshoot its target. Values that cannot extend past their
endpoints, such as colors, clamp instead.impl StructuralPartialEq for Color
Auto Trait Implementations§
impl Forget for Color
impl Freeze for Color
impl Move for Color
impl RefUnwindSafe for Color
impl Send for Color
impl Sync for Color
impl Unpin for Color
impl UnsafeUnpin for Color
impl UnwindSafe for Color
Blanket Implementations§
Source§impl<T> BorrowMut<T> for Twhere
T: ?Sized,
impl<T> BorrowMut<T> for Twhere
T: ?Sized,
Source§fn borrow_mut(&mut self) -> &mut T
fn borrow_mut(&mut self) -> &mut T
impl<ST, DT> CastableFrom<ST, Initialized, Initialized> for DT
impl<ST, DT> CastableFrom<ST, Uninit, Uninit> for DT
Source§impl<T> CloneToUninit for Twhere
T: Clone,
impl<T> CloneToUninit for Twhere
T: Clone,
Source§impl<T> Downcast for Twhere
T: Any,
impl<T> Downcast for Twhere
T: Any,
Source§fn into_any(self: Box<T>) -> Box<dyn Any>
fn into_any(self: Box<T>) -> Box<dyn Any>
Box<dyn Trait> (where Trait: Downcast) to Box<dyn Any>. Box<dyn Any> can
then be further downcast into Box<ConcreteType> where ConcreteType implements Trait.Source§fn into_any_rc(self: Rc<T>) -> Rc<dyn Any>
fn into_any_rc(self: Rc<T>) -> Rc<dyn Any>
Rc<Trait> (where Trait: Downcast) to Rc<Any>. Rc<Any> can then be
further downcast into Rc<ConcreteType> where ConcreteType implements Trait.Source§fn as_any(&self) -> &(dyn Any + 'static)
fn as_any(&self) -> &(dyn Any + 'static)
&Trait (where Trait: Downcast) to &Any. This is needed since Rust cannot
generate &Any’s vtable from &Trait’s.Source§fn as_any_mut(&mut self) -> &mut (dyn Any + 'static)
fn as_any_mut(&mut self) -> &mut (dyn Any + 'static)
&mut Trait (where Trait: Downcast) to &Any. This is needed since Rust cannot
generate &mut Any’s vtable from &mut Trait’s.