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: Self
pub const BLACK: Self
pub const WHITE: Self
pub const fn new( space: ColorSpace, red: f32, green: f32, blue: f32, alpha: f32, ) -> Self
pub const fn rgba(red: f32, green: f32, blue: f32, alpha: f32) -> Self
pub const fn srgba(red: f32, green: f32, blue: f32, alpha: f32) -> Self
pub const fn linear_rgba(red: f32, green: f32, blue: f32, alpha: f32) -> Self
pub const fn display_p3(red: f32, green: f32, blue: f32, alpha: f32) -> Self
pub const fn linear_display_p3( red: f32, green: f32, blue: f32, alpha: f32, ) -> Self
pub const fn with_alpha(self, alpha: f32) -> Self
pub const fn to_array(self) -> [f32; 4]
pub fn clamped(self) -> Self
Sourcepub fn over(self, backdrop: Color) -> Self
pub fn over(self, backdrop: Color) -> Self
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) -> Self
Sourcepub fn to_space(self, space: ColorSpace) -> Self
pub fn to_space(self, space: ColorSpace) -> Self
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) -> Self
pub fn mix_oklab(self, to: Color, amount: f32) -> Self
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) -> Self
pub fn oklch(lightness: f32, chroma: f32, hue: f32) -> Self
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.