Struct palette::rgb::Rgb

#[repr(C)]
pub struct Rgb<S = Srgb, T = f32> {
    pub red: T,
    pub green: T,
    pub blue: T,
    pub standard: PhantomData<S>,
}

Generic RGB.

RGB is probably the most common color space, when it comes to computer graphics, and it’s defined as an additive mixture of red, green and blue light, where gray scale colors are created when these three channels are equal in strength.

Creating a Value

RGB comes in different shapes and formats. You will probably want to start with either the Srgb or Srgba alias, which represents the common sRGB format that most images and tools use. Then, depending on your input, you can either just call new or convert from another data format.

use palette::Srgb;

let rgb_u8 = Srgb::new(171u8, 193, 35);
let rgb_f32 = Srgb::new(0.3f32, 0.8, 0.1);

// `new` is also `const`:
const RGB_U8: Srgb<u8> = Srgb::new(171, 193, 35);

// Converting from one number format to another can be as simple as this:
let rgb_u8_from_f32_1: Srgb<u8> = Srgb::new(0.3f32, 0.8, 0.1).into();

// ...or more explicitly like this:
let rgb_u8_from_f32_2 = Srgb::new(0.3f32, 0.8, 0.1).into_format::<u8>();

// Hexadecimal is also supported, with or without the #:
let rgb_from_hex1: Srgb<u8> = "#f034e6".parse().unwrap();
let rgb_from_hex2: Srgb<u8> = "f034e6".parse().unwrap();
assert_eq!(rgb_from_hex1, rgb_from_hex2);

// This includes the shorthand format:
let rgb_from_short_hex: Srgb<u8> = "f3e".parse().unwrap();
let rgb_from_long_hex: Srgb<u8> = "ff33ee".parse().unwrap();
assert_eq!(rgb_from_short_hex, rgb_from_long_hex);

// It's also possible to convert from (and to) arrays, tuples and `u32` values:
let rgb_from_array = Srgb::from([171u8, 193, 35]);
let rgb_from_tuple = Srgb::from((171u8, 193, 35));
let rgb_from_u32 = Srgb::from(0x607F00);

Linear, sRGB and Gamma Correction

Many conversions and operations on RGB require that it’s linear, meaning that gamma correction is required when converting to and from displayable RGB, such as sRGB. It’s common to store and send RGB values where the numbers are on a non-linear scale. In a non-linear format, a value of, for example, 0.5 would not represent a light intensity of 50%, which makes some operations (such as blurring) give incorrect results.

You will probably encounter or use LinSrgb or LinSrgba at some point. These are aliases for linear sRGB and would usually be obtained by converting an Srgb value with into_linear.

use palette::{LinSrgb, Srgb};

// This function uses linear sRGB for something. But how do we interface with it?
fn uses_linear_srgb(input: LinSrgb<f32>) -> LinSrgb<f32> { todo!() }

// Linear sRGB will usually be created from non-linear sRGB:
let output = uses_linear_srgb(Srgb::new(0.3, 0.8, 0.1).into_linear());

// It's also possible to convert directly from u8 to f32 for sRGB.
// This is much faster than using `into_format` first:
let output = uses_linear_srgb(Srgb::new(171u8, 193, 35).into_linear());

// Converting the output back to `Srgb<u8>` (or `Srgb<f32>`) is just as simple:
let output_u8 = Srgb::<u8>::from_linear(output);
// ..or:
let output_u8: Srgb<u8> = output.into_encoding();

It’s of course also possible to create a linear value from constants, but it’s not necessarily as intuitive. It’s best to avoid storing them as LinSrgb<u8> (or LinRgb<_, u8>) values, to avoid banding among dark colors.

See the encoding module for built-in encoding formats.

Storage Formats and Pixel Buffers

It’s common to read and write RGB values as bytes, hexadecimal strings, or sometimes u32 values. A single RGB value can be converted to all of these formats and more.

use palette::{Srgb, LinSrgb};

let source: LinSrgb<f32> = todo!();

let u8_array: [u8; 3] = Srgb::from_linear(source).into();
let hex_string1 = format!("#{:x}", Srgb::<u8>::from_linear(source)); // The # is optional.
let u32_value: u32 = Srgb::from_linear(source).into();

It’s also possible to control the component order. PackedArgb is one of a few aliases for Packed, which represents a color that has been “packed” into a specific data format. This can be a u32 or [u8; 4], for example. This is helpful for reading and writing colors with a different order than the default RGBA.

use palette::{rgb::PackedArgb, Srgba, LinSrgba};

let source: LinSrgba<f32> = todo!();

let u8_array: [u8; 4] = PackedArgb::from(Srgba::from_linear(source)).into();
let u32_value: u32 = PackedArgb::from(Srgba::from_linear(source)).into();

If you need to work with colors in a byte buffer, such as [u8], Vec<u8> or the image crate, there’s a quick way to borrow that buffer as a slice of RGB(A) colors. The cast module has a number of traits and functions for casting values without copying them.

use image::RgbImage;
use palette::{cast::ComponentsAsMut, Srgb};

let mut image: RgbImage = todo!();
let pixels: &mut [Srgb<u8>] = image.components_as_mut();

for pixel in pixels {
    std::mem::swap(&mut pixel.red, &mut pixel.blue);
}

Fields

red: T

The amount of red light, where 0.0 is no red light and 1.0 (or 255u8) is the highest displayable amount.

green: T

The amount of green light, where 0.0 is no green light and 1.0 (or 255u8) is the highest displayable amount.

blue: T

The amount of blue light, where 0.0 is no blue light and 1.0 (or 255u8) is the highest displayable amount.

standard: PhantomData<S>

The kind of RGB standard. sRGB is the default.

Implementations

impl<S, T> Rgb<S, T>

pub const fn new(red: T, green: T, blue: T) -> Rgb<S, T>

Create an RGB color.

It’s possible to create a color in one number format and convert it to another format with either into_format or into_linear.

use palette::{Srgb, LinSrgb};

// Changes only the number format:
let rgb_f32: Srgb<f32> =  Srgb::new(171u8, 193, 35).into_format();

// Changes the number format and converts to linear in one go.
// This is faster than `.into_format().into_linear()`:
let linear: LinSrgb<f32> = Srgb::new(171u8, 193, 35).into_linear();

pub fn into_format<U>(self) -> Rgb<S, U>

where U: FromStimulus<T>,

Convert the RGB components into another number type.

use palette::Srgb;

let rgb_u8: Srgb<u8> = Srgb::new(0.3, 0.7, 0.2).into_format();

See also into_linear and into_encoding for a faster option if you need to change between linear and non-linear encoding at the same time.

pub fn from_format<U>(color: Rgb<S, U>) -> Self

where T: FromStimulus<U>,

Convert the RGB components from another number type.

use palette::Srgb;

let rgb_u8 = Srgb::<u8>::from_format(Srgb::new(0.3, 0.7, 0.2));

See also from_linear and from_encoding for a faster option if you need to change between linear and non-linear encoding at the same time.

pub fn into_components(self) -> (T, T, T)

Convert to a (red, green, blue) tuple.

pub fn from_components((red, green, blue): (T, T, T)) -> Self

Convert from a (red, green, blue) tuple.

impl<S, T> Rgb<S, T>

where T: Stimulus,

pub fn min_red() -> T

Return the red value minimum.

pub fn max_red() -> T

Return the red value maximum.

pub fn min_green() -> T

Return the green value minimum.

pub fn max_green() -> T

Return the green value maximum.

pub fn min_blue() -> T

Return the blue value minimum.

pub fn max_blue() -> T

Return the blue value maximum.

impl<S> Rgb<S, u8>

pub fn into_u32<O>(self) -> u32

where O: ComponentOrder<Rgba<S, u8>, u32>,

Convert to a packed u32 with with specifiable component order.

use palette::{rgb, Srgb};

let integer = Srgb::new(96u8, 127, 0).into_u32::<rgb::channels::Rgba>();
assert_eq!(0x607F00FF, integer);

It’s also possible to use From and Into, which defaults to the 0xAARRGGBB component order:

use palette::Srgb;

let integer = u32::from(Srgb::new(96u8, 127, 0));
assert_eq!(0xFF607F00, integer);

See Packed for more details.

pub fn from_u32<O>(color: u32) -> Self

where O: ComponentOrder<Rgba<S, u8>, u32>,

Convert from a packed u32 with specifiable component order.

use palette::{rgb, Srgb};

let rgb = Srgb::from_u32::<rgb::channels::Rgba>(0x607F00FF);
assert_eq!(Srgb::new(96u8, 127, 0), rgb);

It’s also possible to use From and Into, which defaults to the 0xAARRGGBB component order:

use palette::Srgb;

let rgb = Srgb::from(0x607F00);
assert_eq!(Srgb::new(96u8, 127, 0), rgb);

See Packed for more details.

impl<S: RgbStandard, T> Rgb<S, T>

pub fn into_linear<U>(self) -> Rgb<Linear<S::Space>, U>

where S::TransferFn: IntoLinear<U, T>,

Convert the color to linear RGB.

Some transfer functions allow the component type to be converted at the same time. This is usually offered with increased performance, compared to using into_format.

use palette::{Srgb, LinSrgb};

let linear: LinSrgb<f32> = Srgb::new(96u8, 127, 0).into_linear();

See the transfer function types in the encoding module for details and performance characteristics.

pub fn from_linear<U>(color: Rgb<Linear<S::Space>, U>) -> Self

where S::TransferFn: FromLinear<U, T>,

Convert linear RGB to non-linear RGB.

Some transfer functions allow the component type to be converted at the same time. This is usually offered with increased performance, compared to using into_format.

use palette::{Srgb, LinSrgb};

let encoded = Srgb::<u8>::from_linear(LinSrgb::new(0.95f32, 0.90, 0.30));

See the transfer function types in the encoding module for details and performance characteristics.

impl<S: RgbSpace, T> Rgb<Linear<S>, T>

pub fn into_encoding<U, St>(self) -> Rgb<St, U>

where St: RgbStandard<Space = S>, St::TransferFn: FromLinear<T, U>,

Convert a linear color to a different encoding.

Some transfer functions allow the component type to be converted at the same time. This is usually offered with increased performance, compared to using into_format.

use palette::{Srgb, LinSrgb};

let encoded: Srgb<u8> = LinSrgb::new(0.95f32, 0.90, 0.30).into_encoding();

See the transfer function types in the encoding module for details and performance characteristics.

pub fn from_encoding<U, St>(color: Rgb<St, U>) -> Self

where St: RgbStandard<Space = S>, St::TransferFn: IntoLinear<T, U>,

Convert linear RGB from a different encoding.

Some transfer functions allow the component type to be converted at the same time. This is usually offered with increased performance, compared to using into_format.

use palette::{Srgb, LinSrgb};

let linear = LinSrgb::<f32>::from_encoding(Srgb::new(96u8, 127, 0));

See the transfer function types in the encoding module for details and performance characteristics.

impl<S, T> Rgb<S, &T>

pub fn copied(&self) -> Rgb<S, T>

where T: Copy,

Get an owned, copied version of this color.

pub fn cloned(&self) -> Rgb<S, T>

where T: Clone,

Get an owned, cloned version of this color.

impl<S, T> Rgb<S, &mut T>

pub fn set(&mut self, value: Rgb<S, T>)

Update this color with new values.

pub fn as_refs(&self) -> Rgb<S, &T>

Borrow this color’s components as shared references.

pub fn copied(&self) -> Rgb<S, T>

where T: Copy,

Get an owned, copied version of this color.

pub fn cloned(&self) -> Rgb<S, T>

where T: Clone,

Get an owned, cloned version of this color.

impl<S, C> Rgb<S, C>

pub fn iter<'a>(&'a self) -> <&'a Self as IntoIterator>::IntoIter

where &'a Self: IntoIterator,

Return an iterator over the colors in the wrapped collections.

pub fn iter_mut<'a>(&'a mut self) -> <&'a mut Self as IntoIterator>::IntoIter

where &'a mut Self: IntoIterator,

Return an iterator that allows modifying the colors in the wrapped collections.

pub fn get<'a, I, T>( &'a self, index: I ) -> Option<Rgb<S, &<I as SliceIndex<[T]>>::Output>>

where T: 'a, C: AsRef<[T]>, I: SliceIndex<[T]> + Clone,

Get a color, or slice of colors, with references to the components at index. See slice::get for details.

pub fn get_mut<'a, I, T>( &'a mut self, index: I ) -> Option<Rgb<S, &mut <I as SliceIndex<[T]>>::Output>>

where T: 'a, C: AsMut<[T]>, I: SliceIndex<[T]> + Clone,

Get a color, or slice of colors, that allows modifying the components at index. See slice::get_mut for details.

impl<S, T> Rgb<S, Vec<T>>

pub fn with_capacity(capacity: usize) -> Self

Create a struct of vectors with a minimum capacity. See Vec::with_capacity for details.

pub fn push(&mut self, value: Rgb<S, T>)

Push an additional color’s components onto the component vectors. See Vec::push for details.

pub fn pop(&mut self) -> Option<Rgb<S, T>>

Pop a color’s components from the component vectors. See Vec::pop for details.

pub fn clear(&mut self)

Clear the component vectors. See Vec::clear for details.

pub fn drain<R>(&mut self, range: R) -> Iter<Drain<'_, T>, S>

where R: RangeBounds<usize> + Clone,

Return an iterator that moves colors out of the specified range.

Trait Implementations

impl<S, T> AbsDiffEq for Rgb<S, T>

where T: AbsDiffEq, T::Epsilon: Clone,

type Epsilon = <T as AbsDiffEq>::Epsilon

Used for specifying relative comparisons.

fn default_epsilon() -> Self::Epsilon

The default tolerance to use when testing values that are close together.

fn abs_diff_eq(&self, other: &Self, epsilon: T::Epsilon) -> bool

A test for equality that uses the absolute difference to compute the approximate equality of two numbers.

fn abs_diff_ne(&self, other: &Self, epsilon: T::Epsilon) -> bool

The inverse of AbsDiffEq::abs_diff_eq.

impl<S, T> Add<T> for Rgb<S, T>

where T: Add<Output = T> + Clone,

type Output = Rgb<S, T>

The resulting type after applying the + operator.

fn add(self, c: T) -> Self::Output

Performs the + operation.

impl<S, T> Add for Rgb<S, T>

where T: Add<Output = T>,

type Output = Rgb<S, T>

The resulting type after applying the + operator.

fn add(self, other: Self) -> Self::Output

Performs the + operation.

impl<S, T> AddAssign<T> for Rgb<S, T>

where T: AddAssign + Clone,

fn add_assign(&mut self, c: T)

Performs the += operation.

impl<S, T> AddAssign for Rgb<S, T>

where T: AddAssign,

fn add_assign(&mut self, other: Self)

Performs the += operation.

impl<S, T> ArrayCast for Rgb<S, T>

type Array = [T; 3]

The output type of a cast to an array.

impl<S, T> AsMut<[T]> for Rgb<S, T>

fn as_mut(&mut self) -> &mut [T]

Converts this type into a mutable reference of the (usually inferred) input type.

impl<S, T> AsMut<[T; 3]> for Rgb<S, T>

fn as_mut(&mut self) -> &mut [T; 3]

Converts this type into a mutable reference of the (usually inferred) input type.

impl<S, T> AsMut<Rgb<S, T>> for [T; 3]

fn as_mut(&mut self) -> &mut Rgb<S, T>

Converts this type into a mutable reference of the (usually inferred) input type.

impl<S, T> AsRef<[T]> for Rgb<S, T>

fn as_ref(&self) -> &[T]

Converts this type into a shared reference of the (usually inferred) input type.

impl<S, T> AsRef<[T; 3]> for Rgb<S, T>

fn as_ref(&self) -> &[T; 3]

Converts this type into a shared reference of the (usually inferred) input type.

impl<S, T> AsRef<Rgb<S, T>> for [T; 3]

fn as_ref(&self) -> &Rgb<S, T>

Converts this type into a shared reference of the (usually inferred) input type.

impl<S, T> Clamp for Rgb<S, T>

where T: Clamp + Stimulus,

fn clamp(self) -> Self

Return a new color where out-of-bounds components have been changed to the nearest valid values.

impl<S, T> ClampAssign for Rgb<S, T>

where T: ClampAssign + Stimulus,

fn clamp_assign(&mut self)

Changes out-of-bounds components to the nearest valid values.

impl<S, T> Clone for Rgb<S, T>

where T: Clone,

fn clone(&self) -> Rgb<S, T>

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl<S: Debug, T: Debug> Debug for Rgb<S, T>

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

Formats the value using the given formatter.

impl<S, T> Default for Rgb<S, T>

where T: Stimulus,

fn default() -> Rgb<S, T>

Returns the “default value” for a type.

impl<'de, S, T> Deserialize<'de> for Rgb<S, T>

where T: Deserialize<'de>,

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl<S, T> Distribution<Rgb<S, T>> for Standard

where Standard: Distribution<T>,

fn sample<R: Rng + ?Sized>(&self, rng: &mut R) -> Rgb<S, T>

Generate a random value of T, using rng as the source of randomness.

fn sample_iter<R>(self, rng: R) -> DistIter<Self, R, T>

where R: Rng, Self: Sized,

Create an iterator that generates random values of T, using rng as the source of randomness.

fn map<F, S>(self, func: F) -> DistMap<Self, F, T, S>

where F: Fn(T) -> S, Self: Sized,

Create a distribution of values of ‘S’ by mapping the output of Self through the closure F

impl<S, T> Div<T> for Rgb<S, T>

where T: Div<Output = T> + Clone,

type Output = Rgb<S, T>

The resulting type after applying the / operator.

fn div(self, c: T) -> Self::Output

Performs the / operation.

impl<S, T> Div for Rgb<S, T>

where T: Div<Output = T>,

type Output = Rgb<S, T>

The resulting type after applying the / operator.

fn div(self, other: Self) -> Self::Output

Performs the / operation.

impl<S, T> DivAssign<T> for Rgb<S, T>

where T: DivAssign + Clone,

fn div_assign(&mut self, c: T)

Performs the /= operation.

impl<S, T> DivAssign for Rgb<S, T>

where T: DivAssign,

fn div_assign(&mut self, other: Self)

Performs the /= operation.

impl<S, T> EuclideanDistance for Rgb<S, T>

where T: Real + Sub<T, Output = T> + Add<T, Output = T> + Mul<T, Output = T> + Clone,

type Scalar = T

The type for the distance value.

fn distance_squared(self, other: Self) -> Self::Scalar

Calculate the squared Euclidean distance from self to other.

impl<S, T, C> Extend<Rgb<S, T>> for Rgb<S, C>

where C: Extend<T>,

fn extend<I: IntoIterator<Item = Rgb<S, T>>>(&mut self, iter: I)

Extends a collection with the contents of an iterator.

fn extend_one(&mut self, item: A)

🔬This is a nightly-only experimental API. (extend_one)

Extends a collection with exactly one element.

fn extend_reserve(&mut self, additional: usize)

🔬This is a nightly-only experimental API. (extend_one)

Reserves capacity in a collection for the given number of additional elements.

impl<'a, S, T> From<&'a [T; 3]> for &'a Rgb<S, T>

fn from(array: &'a [T; 3]) -> Self

Converts to this type from the input type.

impl<'a, S, T> From<&'a Rgb<S, T>> for &'a [T]

fn from(color: &'a Rgb<S, T>) -> Self

Converts to this type from the input type.

impl<'a, S, T> From<&'a Rgb<S, T>> for &'a [T; 3]

fn from(color: &'a Rgb<S, T>) -> Self

Converts to this type from the input type.

impl<'a, S, T> From<&'a mut [T; 3]> for &'a mut Rgb<S, T>

fn from(array: &'a mut [T; 3]) -> Self

Converts to this type from the input type.

impl<'a, S, T> From<&'a mut Rgb<S, T>> for &'a mut [T]

fn from(color: &'a mut Rgb<S, T>) -> Self

Converts to this type from the input type.

impl<'a, S, T> From<&'a mut Rgb<S, T>> for &'a mut [T; 3]

fn from(color: &'a mut Rgb<S, T>) -> Self

Converts to this type from the input type.

impl<S, T, V, const N: usize> From<[Rgb<S, T>; N]> for Rgb<S, V>

where [T; N]: Default, V: FromScalarArray<N, Scalar = T>,

fn from(colors: [Rgb<S, T>; N]) -> Self

Converts to this type from the input type.

impl<S, T> From<[T; 3]> for Rgb<S, T>

fn from(array: [T; 3]) -> Self

Converts to this type from the input type.

impl<S, T> From<(T, T, T)> for Rgb<S, T>

fn from(components: (T, T, T)) -> Self

Converts to this type from the input type.

impl<S, T> From<Box<[T; 3]>> for Box<Rgb<S, T>>

fn from(array: Box<[T; 3]>) -> Self

Converts to this type from the input type.

impl<S, O, P> From<Packed<O, P>> for Rgb<S, u8>

where O: ComponentOrder<Rgba<S, u8>, P>,

fn from(packed: Packed<O, P>) -> Self

Converts to this type from the input type.

impl<S, T> From<PreAlpha<Rgb<S, T>>> for Rgb<S, T>

where Self: Premultiply<Scalar = T>,

fn from(premultiplied: PreAlpha<Self>) -> Self

Converts to this type from the input type.

impl<T, U> From<Rgb<Linear<Srgb>, T>> for Srgba<U>

where U: Stimulus, Srgb: RgbStandard<Space = Srgb> + FromLinear<T, U>,

fn from(lin_srgb: LinSrgb<T>) -> Self

Converts to this type from the input type.

impl<T, U> From<Rgb<Linear<Srgb>, T>> for Srgb<U>

where Srgb: RgbStandard<Space = Srgb> + FromLinear<T, U>,

fn from(lin_srgb: LinSrgb<T>) -> Self

Converts to this type from the input type.

impl<S> From<Rgb<S>> for Rgb<S, f64>

fn from(color: Rgb<S, f32>) -> Self

Converts to this type from the input type.

impl<S> From<Rgb<S>> for Rgb<S, u8>

fn from(color: Rgb<S, f32>) -> Self

Converts to this type from the input type.

impl<S, T> From<Rgb<S, T>> for [T; 3]

fn from(color: Rgb<S, T>) -> Self

Converts to this type from the input type.

impl<S, T> From<Rgb<S, T>> for (T, T, T)

fn from(color: Rgb<S, T>) -> (T, T, T)

Converts to this type from the input type.

impl<S, T, P, O> From<Rgb<S, T>> for Packed<O, P>

where O: ComponentOrder<Rgba<S, T>, P>, Rgba<S, T>: From<Rgb<S, T>>,

fn from(color: Rgb<S, T>) -> Self

Converts to this type from the input type.

impl<S, T, V, const N: usize> From<Rgb<S, V>> for [Rgb<S, T>; N]

where Self: Default, V: IntoScalarArray<N, Scalar = T>,

fn from(color: Rgb<S, V>) -> Self

Converts to this type from the input type.

impl<S> From<Rgb<S, f64>> for Rgb<S, f32>

fn from(color: Rgb<S, f64>) -> Self

Converts to this type from the input type.

impl<S> From<Rgb<S, f64>> for Rgb<S, u8>

fn from(color: Rgb<S, f64>) -> Self

Converts to this type from the input type.

impl<S> From<Rgb<S, u8>> for Rgb<S, f32>

fn from(color: Rgb<S, u8>) -> Self

Converts to this type from the input type.

impl<S> From<Rgb<S, u8>> for Rgb<S, f64>

fn from(color: Rgb<S, u8>) -> Self

Converts to this type from the input type.

impl<S> From<Rgb<S, u8>> for u32

fn from(color: Rgb<S, u8>) -> Self

Converts to this type from the input type.

impl<T, U> From<Rgb<Srgb, T>> for LinSrgba<U>

where U: Stimulus, Srgb: RgbStandard<Space = Srgb> + IntoLinear<U, T>,

fn from(srgb: Srgb<T>) -> Self

Converts to this type from the input type.

impl<T, U> From<Rgb<Srgb, T>> for LinSrgb<U>

where Srgb: RgbStandard<Space = Srgb> + IntoLinear<U, T>,

fn from(srgb: Srgb<T>) -> Self

Converts to this type from the input type.

impl<S> From<u32> for Rgb<S, u8>

fn from(color: u32) -> Self

Converts to this type from the input type.

impl<S, T, _C, _A> FromColorUnclamped<Alpha<_C, _A>> for Rgb<S, T>

where _C: IntoColorUnclamped<Self>,

fn from_color_unclamped(color: Alpha<_C, _A>) -> Self

Convert from T. The resulting color might be invalid in its color space.

impl<S, T> FromColorUnclamped<Hsl<S, T>> for Rgb<S, T>

where T: Real + RealAngle + UnsignedAngle + Zero + One + Abs + Round + PartialCmp + Arithmetics + Clone, T::Mask: LazySelect<T> + BitOps + Clone,

fn from_color_unclamped(hsl: Hsl<S, T>) -> Self

Convert from T. The resulting color might be invalid in its color space.

impl<S, T> FromColorUnclamped<Hsluv<<<S as RgbStandard>::Space as RgbSpace>::WhitePoint, T>> for Rgb<S, T>

where S: RgbStandard, Xyz<<<S as RgbStandard>::Space as RgbSpace>::WhitePoint, T>: FromColorUnclamped<Hsluv<<<S as RgbStandard>::Space as RgbSpace>::WhitePoint, T>> + IntoColorUnclamped<Self>,

fn from_color_unclamped( color: Hsluv<<<S as RgbStandard>::Space as RgbSpace>::WhitePoint, T> ) -> Self

Convert from T. The resulting color might be invalid in its color space.

impl<S, T> FromColorUnclamped<Hsv<S, T>> for Rgb<S, T>

where T: Real + RealAngle + UnsignedAngle + Round + Zero + One + Abs + PartialCmp + Arithmetics + Clone, T::Mask: LazySelect<T> + BitOps + Clone,

fn from_color_unclamped(hsv: Hsv<S, T>) -> Self

Convert from T. The resulting color might be invalid in its color space.

impl<S, T> FromColorUnclamped<Hwb<S, T>> for Rgb<S, T>

where Hsv<S, T>: FromColorUnclamped<Hwb<S, T>> + IntoColorUnclamped<Self>,

fn from_color_unclamped(color: Hwb<S, T>) -> Self

Convert from T. The resulting color might be invalid in its color space.

impl<S, T> FromColorUnclamped<Lab<<<S as RgbStandard>::Space as RgbSpace>::WhitePoint, T>> for Rgb<S, T>

where S: RgbStandard, Xyz<<<S as RgbStandard>::Space as RgbSpace>::WhitePoint, T>: FromColorUnclamped<Lab<<<S as RgbStandard>::Space as RgbSpace>::WhitePoint, T>> + IntoColorUnclamped<Self>,

fn from_color_unclamped( color: Lab<<<S as RgbStandard>::Space as RgbSpace>::WhitePoint, T> ) -> Self

Convert from T. The resulting color might be invalid in its color space.

impl<S, T> FromColorUnclamped<Lch<<<S as RgbStandard>::Space as RgbSpace>::WhitePoint, T>> for Rgb<S, T>

where S: RgbStandard, Xyz<<<S as RgbStandard>::Space as RgbSpace>::WhitePoint, T>: FromColorUnclamped<Lch<<<S as RgbStandard>::Space as RgbSpace>::WhitePoint, T>> + IntoColorUnclamped<Self>,

fn from_color_unclamped( color: Lch<<<S as RgbStandard>::Space as RgbSpace>::WhitePoint, T> ) -> Self

Convert from T. The resulting color might be invalid in its color space.

impl<S, T> FromColorUnclamped<Lchuv<<<S as RgbStandard>::Space as RgbSpace>::WhitePoint, T>> for Rgb<S, T>

where S: RgbStandard, Xyz<<<S as RgbStandard>::Space as RgbSpace>::WhitePoint, T>: FromColorUnclamped<Lchuv<<<S as RgbStandard>::Space as RgbSpace>::WhitePoint, T>> + IntoColorUnclamped<Self>,

fn from_color_unclamped( color: Lchuv<<<S as RgbStandard>::Space as RgbSpace>::WhitePoint, T> ) -> Self

Convert from T. The resulting color might be invalid in its color space.

impl<S, St, T> FromColorUnclamped<Luma<St, T>> for Rgb<S, T>

where S: RgbStandard + 'static, St: LumaStandard<WhitePoint = <S::Space as RgbSpace>::WhitePoint> + 'static, S::TransferFn: FromLinear<T, T>, St::TransferFn: IntoLinear<T, T>, T: Clone,

fn from_color_unclamped(color: Luma<St, T>) -> Self

Convert from T. The resulting color might be invalid in its color space.

impl<S, T> FromColorUnclamped<Luv<<<S as RgbStandard>::Space as RgbSpace>::WhitePoint, T>> for Rgb<S, T>

where S: RgbStandard, Xyz<<<S as RgbStandard>::Space as RgbSpace>::WhitePoint, T>: FromColorUnclamped<Luv<<<S as RgbStandard>::Space as RgbSpace>::WhitePoint, T>> + IntoColorUnclamped<Self>,

fn from_color_unclamped( color: Luv<<<S as RgbStandard>::Space as RgbSpace>::WhitePoint, T> ) -> Self

Convert from T. The resulting color might be invalid in its color space.

impl<S, T> FromColorUnclamped<Okhsl<T>> for Rgb<S, T>

where Oklab<T>: FromColorUnclamped<Okhsl<T>> + IntoColorUnclamped<Self>,

fn from_color_unclamped(color: Okhsl<T>) -> Self

Convert from T. The resulting color might be invalid in its color space.

impl<S, T> FromColorUnclamped<Okhsv<T>> for Rgb<S, T>

where Oklab<T>: FromColorUnclamped<Okhsv<T>> + IntoColorUnclamped<Self>,

fn from_color_unclamped(color: Okhsv<T>) -> Self

Convert from T. The resulting color might be invalid in its color space.

impl<S, T> FromColorUnclamped<Okhwb<T>> for Rgb<S, T>

where Oklab<T>: FromColorUnclamped<Okhwb<T>> + IntoColorUnclamped<Self>,

fn from_color_unclamped(color: Okhwb<T>) -> Self

Convert from T. The resulting color might be invalid in its color space.

impl<S, T> FromColorUnclamped<Oklab<T>> for Rgb<S, T>

where T: Real + Arithmetics + Copy, S: RgbStandard, S::TransferFn: FromLinear<T, T>, S::Space: RgbSpace<WhitePoint = D65> + 'static, Rgb<Linear<Srgb>, T>: IntoColorUnclamped<Self>, Xyz<D65, T>: FromColorUnclamped<Oklab<T>> + IntoColorUnclamped<Self>,

fn from_color_unclamped(oklab: Oklab<T>) -> Self

Convert from T. The resulting color might be invalid in its color space.

impl<S, T> FromColorUnclamped<Oklch<T>> for Rgb<S, T>

where Oklab<T>: FromColorUnclamped<Oklch<T>> + IntoColorUnclamped<Self>,

fn from_color_unclamped(color: Oklch<T>) -> Self

Convert from T. The resulting color might be invalid in its color space.

impl<S, T> FromColorUnclamped<Rgb<S, T>> for Hsl<S, T>

where T: RealAngle + Zero + One + MinMax + Arithmetics + PartialCmp + Clone, T::Mask: BoolMask + BitOps + LazySelect<T> + Clone + 'static,

fn from_color_unclamped(rgb: Rgb<S, T>) -> Self

Convert from T. The resulting color might be invalid in its color space.

impl<S, T> FromColorUnclamped<Rgb<S, T>> for Hsv<S, T>

where T: RealAngle + One + Zero + MinMax + Arithmetics + PartialCmp + Clone, T::Mask: BoolMask + BitOps + LazySelect<T> + Clone + 'static,

fn from_color_unclamped(rgb: Rgb<S, T>) -> Self

Convert from T. The resulting color might be invalid in its color space.

impl<S, T> FromColorUnclamped<Rgb<S, T>> for Hwb<S, T>

where Hsv<S, T>: FromColorUnclamped<Rgb<S, T>> + IntoColorUnclamped<Self>,

fn from_color_unclamped(color: Rgb<S, T>) -> Self

Convert from T. The resulting color might be invalid in its color space.

impl<S, T> FromColorUnclamped<Rgb<S, T>> for Oklab<T>

where T: Real + Cbrt + Arithmetics + Copy, S: RgbStandard, S::TransferFn: IntoLinear<T, T>, S::Space: RgbSpace<WhitePoint = D65> + 'static, Xyz<D65, T>: FromColorUnclamped<Rgb<S, T>>,

fn from_color_unclamped(rgb: Rgb<S, T>) -> Self

Convert from T. The resulting color might be invalid in its color space.

impl<Wp, T, S> FromColorUnclamped<Rgb<S, T>> for Xyz<Wp, T>

where T: Arithmetics + FromScalar, T::Scalar: Real + Recip + IsValidDivisor<Mask = bool> + Arithmetics + FromScalar<Scalar = T::Scalar> + Clone, Wp: WhitePoint<T::Scalar>, S: RgbStandard, S::TransferFn: IntoLinear<T, T>, S::Space: RgbSpace<WhitePoint = Wp>, <S::Space as RgbSpace>::Primaries: Primaries<T::Scalar>, Yxy<Any, T::Scalar>: IntoColorUnclamped<Xyz<Any, T::Scalar>>,

fn from_color_unclamped(color: Rgb<S, T>) -> Self

Convert from T. The resulting color might be invalid in its color space.

impl<S1, S2, T> FromColorUnclamped<Rgb<S2, T>> for Rgb<S1, T>

where S1: RgbStandard + 'static, S2: RgbStandard + 'static, S1::TransferFn: FromLinear<T, T>, S2::TransferFn: IntoLinear<T, T>, S2::Space: RgbSpace<WhitePoint = <S1::Space as RgbSpace>::WhitePoint>, Xyz<<S2::Space as RgbSpace>::WhitePoint, T>: FromColorUnclamped<Rgb<S2, T>>, Rgb<S1, T>: FromColorUnclamped<Xyz<<S1::Space as RgbSpace>::WhitePoint, T>>,

fn from_color_unclamped(rgb: Rgb<S2, T>) -> Self

Convert from T. The resulting color might be invalid in its color space.

impl<Wp, T, _S> FromColorUnclamped<Rgb<_S, T>> for Hsluv<Wp, T>

where _S: RgbStandard, _S::Space: RgbSpace<WhitePoint = Wp>, Wp: WhitePoint<T>, Lchuv<Wp, T>: FromColorUnclamped<Rgb<_S, T>> + IntoColorUnclamped<Self>,

fn from_color_unclamped(color: Rgb<_S, T>) -> Self

Convert from T. The resulting color might be invalid in its color space.

impl<Wp, T, _S> FromColorUnclamped<Rgb<_S, T>> for Lab<Wp, T>

where _S: RgbStandard, _S::Space: RgbSpace<WhitePoint = Wp>, Wp: WhitePoint<T>, Xyz<Wp, T>: FromColorUnclamped<Rgb<_S, T>> + IntoColorUnclamped<Self>,

fn from_color_unclamped(color: Rgb<_S, T>) -> Self

Convert from T. The resulting color might be invalid in its color space.

impl<Wp, T, _S> FromColorUnclamped<Rgb<_S, T>> for Lch<Wp, T>

where _S: RgbStandard, _S::Space: RgbSpace<WhitePoint = Wp>, Wp: WhitePoint<T>, Lab<Wp, T>: FromColorUnclamped<Rgb<_S, T>> + IntoColorUnclamped<Self>,

fn from_color_unclamped(color: Rgb<_S, T>) -> Self

Convert from T. The resulting color might be invalid in its color space.

impl<Wp, T, _S> FromColorUnclamped<Rgb<_S, T>> for Lchuv<Wp, T>

where _S: RgbStandard, _S::Space: RgbSpace<WhitePoint = Wp>, Wp: WhitePoint<T>, Luv<Wp, T>: FromColorUnclamped<Rgb<_S, T>> + IntoColorUnclamped<Self>,

fn from_color_unclamped(color: Rgb<_S, T>) -> Self

Convert from T. The resulting color might be invalid in its color space.

impl<S, T, _S> FromColorUnclamped<Rgb<_S, T>> for Luma<S, T>

where _S: RgbStandard, _S::Space: RgbSpace<WhitePoint = <S as LumaStandard>::WhitePoint>, S: LumaStandard, Xyz<<S as LumaStandard>::WhitePoint, T>: FromColorUnclamped<Rgb<_S, T>> + IntoColorUnclamped<Self>,

fn from_color_unclamped(color: Rgb<_S, T>) -> Self

Convert from T. The resulting color might be invalid in its color space.

impl<Wp, T, _S> FromColorUnclamped<Rgb<_S, T>> for Luv<Wp, T>

where _S: RgbStandard, _S::Space: RgbSpace<WhitePoint = Wp>, Wp: WhitePoint<T>, Xyz<Wp, T>: FromColorUnclamped<Rgb<_S, T>> + IntoColorUnclamped<Self>,

fn from_color_unclamped(color: Rgb<_S, T>) -> Self

Convert from T. The resulting color might be invalid in its color space.

impl<T, _S> FromColorUnclamped<Rgb<_S, T>> for Okhsl<T>

where _S: RgbStandard, _S::Space: RgbSpace<WhitePoint = D65>, D65: WhitePoint<T>, Oklab<T>: FromColorUnclamped<Rgb<_S, T>> + IntoColorUnclamped<Self>,

fn from_color_unclamped(color: Rgb<_S, T>) -> Self

Convert from T. The resulting color might be invalid in its color space.

impl<T, _S> FromColorUnclamped<Rgb<_S, T>> for Okhsv<T>

where _S: RgbStandard, _S::Space: RgbSpace<WhitePoint = D65>, D65: WhitePoint<T>, Oklab<T>: FromColorUnclamped<Rgb<_S, T>> + IntoColorUnclamped<Self>,

fn from_color_unclamped(color: Rgb<_S, T>) -> Self

Convert from T. The resulting color might be invalid in its color space.

impl<T, _S> FromColorUnclamped<Rgb<_S, T>> for Okhwb<T>

where _S: RgbStandard, _S::Space: RgbSpace<WhitePoint = D65>, D65: WhitePoint<T>, Okhsv<T>: FromColorUnclamped<Rgb<_S, T>> + IntoColorUnclamped<Self>,

fn from_color_unclamped(color: Rgb<_S, T>) -> Self

Convert from T. The resulting color might be invalid in its color space.

impl<T, _S> FromColorUnclamped<Rgb<_S, T>> for Oklch<T>

where _S: RgbStandard, _S::Space: RgbSpace<WhitePoint = D65>, D65: WhitePoint<T>, Oklab<T>: FromColorUnclamped<Rgb<_S, T>> + IntoColorUnclamped<Self>,

fn from_color_unclamped(color: Rgb<_S, T>) -> Self

Convert from T. The resulting color might be invalid in its color space.

impl<Wp, T, _S> FromColorUnclamped<Rgb<_S, T>> for Yxy<Wp, T>

where _S: RgbStandard, _S::Space: RgbSpace<WhitePoint = Wp>, Wp: WhitePoint<T>, Xyz<Wp, T>: FromColorUnclamped<Rgb<_S, T>> + IntoColorUnclamped<Self>,

fn from_color_unclamped(color: Rgb<_S, T>) -> Self

Convert from T. The resulting color might be invalid in its color space.

impl<S, T> FromColorUnclamped<Xyz<<<S as RgbStandard>::Space as RgbSpace>::WhitePoint, T>> for Rgb<S, T>

where S: RgbStandard, S::TransferFn: FromLinear<T, T>, <S::Space as RgbSpace>::Primaries: Primaries<T::Scalar>, <S::Space as RgbSpace>::WhitePoint: WhitePoint<T::Scalar>, T: Arithmetics + FromScalar, T::Scalar: Real + Recip + IsValidDivisor<Mask = bool> + Arithmetics + Clone + FromScalar<Scalar = T::Scalar>, Yxy<Any, T::Scalar>: IntoColorUnclamped<Xyz<Any, T::Scalar>>,

fn from_color_unclamped( color: Xyz<<S::Space as RgbSpace>::WhitePoint, T> ) -> Self

Convert from T. The resulting color might be invalid in its color space.

impl<S, T> FromColorUnclamped<Yxy<<<S as RgbStandard>::Space as RgbSpace>::WhitePoint, T>> for Rgb<S, T>

where S: RgbStandard, Xyz<<<S as RgbStandard>::Space as RgbSpace>::WhitePoint, T>: FromColorUnclamped<Yxy<<<S as RgbStandard>::Space as RgbSpace>::WhitePoint, T>> + IntoColorUnclamped<Self>,

fn from_color_unclamped( color: Yxy<<<S as RgbStandard>::Space as RgbSpace>::WhitePoint, T> ) -> Self

Convert from T. The resulting color might be invalid in its color space.

impl<S, T, C> FromIterator<Rgb<S, T>> for Rgb<S, C>

where Self: Extend<Rgb<S, T>>, C: Default,

fn from_iter<I: IntoIterator<Item = Rgb<S, T>>>(iter: I) -> Self

Creates a value from an iterator.

impl<S> FromStr for Rgb<S, u8>

fn from_str(hex: &str) -> Result<Self, Self::Err>

Parses a color hex code of format ‘#ff00bb’ or ‘#abc’ (with or without the leading ‘#’) into a Rgb<S, u8> instance.

type Err = FromHexError

The associated error which can be returned from parsing.

impl<S, T> GetHue for Rgb<S, T>

where T: Real + RealAngle + Trigonometry + Arithmetics + Clone,

type Hue = RgbHue<T>

The kind of hue unit this color space uses.

fn get_hue(&self) -> RgbHue<T>

Calculate a hue if possible.

impl<S, T> HasBoolMask for Rgb<S, T>

where T: HasBoolMask,

type Mask = <T as HasBoolMask>::Mask

The mask type to use for selecting Self values.

impl<'a, 'b, S, T> IntoIterator for &'a Rgb<S, &'b [T]>

type Item = Rgb<S, &'a T>

The type of the elements being iterated over.

type IntoIter = Iter<Iter<'a, T>, S>

Which kind of iterator are we turning this into?

fn into_iter(self) -> Self::IntoIter

Creates an iterator from a value.

impl<'a, 'b, S, T> IntoIterator for &'a Rgb<S, &'b mut [T]>

type Item = Rgb<S, &'a T>

The type of the elements being iterated over.

type IntoIter = Iter<Iter<'a, T>, S>

Which kind of iterator are we turning this into?

fn into_iter(self) -> Self::IntoIter

Creates an iterator from a value.

impl<'a, S, T, const N: usize> IntoIterator for &'a Rgb<S, [T; N]>

type Item = Rgb<S, &'a T>

The type of the elements being iterated over.

type IntoIter = Iter<Iter<'a, T>, S>

Which kind of iterator are we turning this into?

fn into_iter(self) -> Self::IntoIter

Creates an iterator from a value.

impl<'a, S, T> IntoIterator for &'a Rgb<S, Box<[T]>>

type Item = Rgb<S, &'a T>

The type of the elements being iterated over.

type IntoIter = Iter<Iter<'a, T>, S>

Which kind of iterator are we turning this into?

fn into_iter(self) -> Self::IntoIter

Creates an iterator from a value.

impl<'a, S, T> IntoIterator for &'a Rgb<S, Vec<T>>

type Item = Rgb<S, &'a T>

The type of the elements being iterated over.

type IntoIter = Iter<Iter<'a, T>, S>

Which kind of iterator are we turning this into?

fn into_iter(self) -> Self::IntoIter

Creates an iterator from a value.

impl<'a, 'b, S, T> IntoIterator for &'a mut Rgb<S, &'b mut [T]>

type Item = Rgb<S, &'a mut T>

The type of the elements being iterated over.

type IntoIter = Iter<IterMut<'a, T>, S>

Which kind of iterator are we turning this into?

fn into_iter(self) -> Self::IntoIter

Creates an iterator from a value.

impl<'a, S, T, const N: usize> IntoIterator for &'a mut Rgb<S, [T; N]>

type Item = Rgb<S, &'a mut T>

The type of the elements being iterated over.

type IntoIter = Iter<IterMut<'a, T>, S>

Which kind of iterator are we turning this into?

fn into_iter(self) -> Self::IntoIter

Creates an iterator from a value.

impl<'a, S, T> IntoIterator for &'a mut Rgb<S, Box<[T]>>

where T: 'a,

type Item = Rgb<S, &'a mut T>

The type of the elements being iterated over.

type IntoIter = Iter<IterMut<'a, T>, S>

Which kind of iterator are we turning this into?

fn into_iter(self) -> Self::IntoIter

Creates an iterator from a value.

impl<'a, S, T> IntoIterator for &'a mut Rgb<S, Vec<T>>

type Item = Rgb<S, &'a mut T>

The type of the elements being iterated over.

type IntoIter = Iter<IterMut<'a, T>, S>

Which kind of iterator are we turning this into?

fn into_iter(self) -> Self::IntoIter

Creates an iterator from a value.

impl<'a, S, T> IntoIterator for Rgb<S, &'a [T]>

type Item = Rgb<S, &'a T>

The type of the elements being iterated over.

type IntoIter = Iter<Iter<'a, T>, S>

Which kind of iterator are we turning this into?

fn into_iter(self) -> Self::IntoIter

Creates an iterator from a value.

impl<'a, S, T> IntoIterator for Rgb<S, &'a mut [T]>

type Item = Rgb<S, &'a mut T>

The type of the elements being iterated over.

type IntoIter = Iter<IterMut<'a, T>, S>

Which kind of iterator are we turning this into?

fn into_iter(self) -> Self::IntoIter

Creates an iterator from a value.

impl<S, T, const N: usize> IntoIterator for Rgb<S, [T; N]>

type Item = Rgb<S, T>

The type of the elements being iterated over.

type IntoIter = Iter<IntoIter<T, N>, S>

Which kind of iterator are we turning this into?

fn into_iter(self) -> Self::IntoIter

Creates an iterator from a value.

impl<S, T> IntoIterator for Rgb<S, Vec<T>>

type Item = Rgb<S, T>

The type of the elements being iterated over.

type IntoIter = Iter<IntoIter<T>, S>

Which kind of iterator are we turning this into?

fn into_iter(self) -> Self::IntoIter

Creates an iterator from a value.

impl<S, T> IsWithinBounds for Rgb<S, T>

where T: PartialCmp + Stimulus, T::Mask: BitAnd<Output = T::Mask>,

fn is_within_bounds(&self) -> T::Mask

Check if the color’s components are within the expected range bounds.

impl<S, T> Lighten for Rgb<S, T>

where T: Real + Zero + MinMax + Clamp + Arithmetics + PartialCmp + Clone + Stimulus, T::Mask: LazySelect<T>,

type Scalar = T

The type of the lighten modifier.

fn lighten(self, factor: T) -> Self

Scale the color towards the maximum lightness by factor, a value ranging from 0.0 to 1.0.

fn lighten_fixed(self, amount: T) -> Self

Lighten the color by amount, a value ranging from 0.0 to 1.0.

impl<S, T> LightenAssign for Rgb<S, T>

where T: Real + Zero + MinMax + ClampAssign + AddAssign + Arithmetics + PartialCmp + Clone + Stimulus, T::Mask: LazySelect<T>,

type Scalar = T

The type of the lighten modifier.

fn lighten_assign(&mut self, factor: T)

Scale the color towards the maximum lightness by factor, a value ranging from 0.0 to 1.0.

fn lighten_fixed_assign(&mut self, amount: T)

Lighten the color by amount, a value ranging from 0.0 to 1.0.

impl<S, T> LowerHex for Rgb<S, T>

where T: LowerHex,

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

Formats the value using the given formatter.

impl<S, T> Mix for Rgb<S, T>

where T: Real + Zero + One + Arithmetics + Clamp + Clone,

type Scalar = T

The type of the mixing factor.

fn mix(self, other: Self, factor: T) -> Self

Mix the color with an other color, by factor.

impl<S, T> MixAssign for Rgb<S, T>

where T: Real + Zero + One + AddAssign + Arithmetics + Clamp + Clone,

type Scalar = T

The type of the mixing factor.

fn mix_assign(&mut self, other: Self, factor: T)

Mix the color with an other color, by factor.

impl<S, T> Mul<T> for Rgb<S, T>

where T: Mul<Output = T> + Clone,

type Output = Rgb<S, T>

The resulting type after applying the * operator.

fn mul(self, c: T) -> Self::Output

Performs the * operation.

impl<S, T> Mul for Rgb<S, T>

where T: Mul<Output = T>,

type Output = Rgb<S, T>

The resulting type after applying the * operator.

fn mul(self, other: Self) -> Self::Output

Performs the * operation.

impl<S, T> MulAssign<T> for Rgb<S, T>

where T: MulAssign + Clone,

fn mul_assign(&mut self, c: T)

Performs the *= operation.

impl<S, T> MulAssign for Rgb<S, T>

where T: MulAssign,

fn mul_assign(&mut self, other: Self)

Performs the *= operation.

impl<S, T> PartialEq for Rgb<S, T>

where T: PartialEq,

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

This method tests for self and other values to be equal, and is used by ==.

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

This method tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl<S, T> Premultiply for Rgb<S, T>

where T: Real + Stimulus + Zero + IsValidDivisor + Mul<T, Output = T> + Div<T, Output = T> + Clone, T::Mask: LazySelect<T> + Clone,

type Scalar = T

The color’s component type.

fn premultiply(self, alpha: T) -> PreAlpha<Self>

Alpha mask the color.

fn unpremultiply(premultiplied: PreAlpha<Self>) -> (Self, T)

Alpha unmask the color, resulting in a color and transparency pair.

impl<S, T> RelativeContrast for Rgb<S, T>

where T: Real + Arithmetics + PartialCmp, T::Mask: LazySelect<T>, S: RgbStandard, Xyz<<<S as RgbStandard>::Space as RgbSpace>::WhitePoint, T>: FromColor<Self>,

type Scalar = T

👎Deprecated since 0.7.2: replaced by palette::color_difference::Wcag21RelativeContrast

The type of the contrast ratio.

fn get_contrast_ratio(self, other: Self) -> T

👎Deprecated since 0.7.2: replaced by palette::color_difference::Wcag21RelativeContrast

Calculate the contrast ratio between two colors.

fn has_min_contrast_text( self, other: Self ) -> <Self::Scalar as HasBoolMask>::Mask

👎Deprecated since 0.7.2: replaced by palette::color_difference::Wcag21RelativeContrast

Verify the contrast between two colors satisfies SC 1.4.3. Contrast is at least 4.5:1 (Level AA).

fn has_min_contrast_large_text( self, other: Self ) -> <Self::Scalar as HasBoolMask>::Mask

👎Deprecated since 0.7.2: replaced by palette::color_difference::Wcag21RelativeContrast

Verify the contrast between two colors satisfies SC 1.4.3 for large text. Contrast is at least 3:1 (Level AA).

fn has_enhanced_contrast_text( self, other: Self ) -> <Self::Scalar as HasBoolMask>::Mask

👎Deprecated since 0.7.2: replaced by palette::color_difference::Wcag21RelativeContrast

Verify the contrast between two colors satisfies SC 1.4.6. Contrast is at least 7:1 (Level AAA).

fn has_enhanced_contrast_large_text( self, other: Self ) -> <Self::Scalar as HasBoolMask>::Mask

👎Deprecated since 0.7.2: replaced by palette::color_difference::Wcag21RelativeContrast

Verify the contrast between two colors satisfies SC 1.4.6 for large text. Contrast is at least 4.5:1 (Level AAA).

fn has_min_contrast_graphics( self, other: Self ) -> <Self::Scalar as HasBoolMask>::Mask

👎Deprecated since 0.7.2: replaced by palette::color_difference::Wcag21RelativeContrast

Verify the contrast between two colors satisfies SC 1.4.11 for graphical objects. Contrast is at least 3:1 (Level AA).

impl<S, T> RelativeEq for Rgb<S, T>

where T: RelativeEq, T::Epsilon: Clone,

fn default_max_relative() -> T::Epsilon

The default relative tolerance for testing values that are far-apart.

fn relative_eq( &self, other: &Self, epsilon: T::Epsilon, max_relative: T::Epsilon ) -> bool

A test for equality that uses a relative comparison if the values are far apart.

fn relative_ne( &self, other: &Self, epsilon: T::Epsilon, max_relative: T::Epsilon ) -> bool

The inverse of RelativeEq::relative_eq.

impl<S, T> SampleUniform for Rgb<S, T>

where T: SampleUniform + Clone,

type Sampler = UniformRgb<S, T>

The UniformSampler implementation supporting type X.

impl<S, T> SaturatingAdd<T> for Rgb<S, T>

where T: SaturatingAdd<Output = T> + Clone,

type Output = Rgb<S, T>

The resulting type.

fn saturating_add(self, c: T) -> Self::Output

Returns the sum of self and other, but saturates instead of overflowing.

impl<S, T> SaturatingAdd for Rgb<S, T>

where T: SaturatingAdd<Output = T>,

type Output = Rgb<S, T>

The resulting type.

fn saturating_add(self, other: Self) -> Self::Output

Returns the sum of self and other, but saturates instead of overflowing.

impl<S, T> SaturatingSub<T> for Rgb<S, T>

where T: SaturatingSub<Output = T> + Clone,

type Output = Rgb<S, T>

The resulting type.

fn saturating_sub(self, c: T) -> Self::Output

Returns the difference of self and other, but saturates instead of overflowing.

impl<S, T> SaturatingSub for Rgb<S, T>

where T: SaturatingSub<Output = T>,

type Output = Rgb<S, T>

The resulting type.

fn saturating_sub(self, other: Self) -> Self::Output

Returns the difference of self and other, but saturates instead of overflowing.

impl<S, T> Serialize for Rgb<S, T>

where T: Serialize,

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl<S, T> Sub<T> for Rgb<S, T>

where T: Sub<Output = T> + Clone,

type Output = Rgb<S, T>

The resulting type after applying the - operator.

fn sub(self, c: T) -> Self::Output

Performs the - operation.

impl<S, T> Sub for Rgb<S, T>

where T: Sub<Output = T>,

type Output = Rgb<S, T>

The resulting type after applying the - operator.

fn sub(self, other: Self) -> Self::Output

Performs the - operation.

impl<S, T> SubAssign<T> for Rgb<S, T>

where T: SubAssign + Clone,

fn sub_assign(&mut self, c: T)

Performs the -= operation.

impl<S, T> SubAssign for Rgb<S, T>

where T: SubAssign,

fn sub_assign(&mut self, other: Self)

Performs the -= operation.

impl<'a, S, T> TryFrom<&'a [T]> for &'a Rgb<S, T>

type Error = <&'a [T; 3] as TryFrom<&'a [T]>>::Error

The type returned in the event of a conversion error.

fn try_from(slice: &'a [T]) -> Result<Self, Self::Error>

Performs the conversion.

impl<'a, S, T> TryFrom<&'a mut [T]> for &'a mut Rgb<S, T>

type Error = <&'a mut [T; 3] as TryFrom<&'a mut [T]>>::Error

The type returned in the event of a conversion error.

fn try_from(slice: &'a mut [T]) -> Result<Self, Self::Error>

Performs the conversion.

impl<S, T> UlpsEq for Rgb<S, T>

where T: UlpsEq, T::Epsilon: Clone,

fn default_max_ulps() -> u32

The default ULPs to tolerate when testing values that are far-apart.

fn ulps_eq(&self, other: &Self, epsilon: T::Epsilon, max_ulps: u32) -> bool

A test for equality that uses units in the last place (ULP) if the values are far apart.

fn ulps_ne(&self, other: &Self, epsilon: T::Epsilon, max_ulps: u32) -> bool

The inverse of UlpsEq::ulps_eq.

impl<S, T> UpperHex for Rgb<S, T>

where T: UpperHex,

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

Formats the value using the given formatter.

impl<S, T> Wcag21RelativeContrast for Rgb<S, T>

where Self: IntoColor<Luma<Linear<D65>, T>>, S: RgbStandard<Space = Srgb>, T: Real + Add<T, Output = T> + Div<T, Output = T> + PartialCmp + MinMax,

type Scalar = T

The scalar type used for luminance and contrast.

fn relative_luminance(self) -> Luma<Linear<D65>, Self::Scalar>

Returns the WCAG 2.1 relative luminance of self.

fn relative_contrast(self, other: Self) -> Self::Scalar

Returns the WCAG 2.1 relative luminance contrast between self and other.

fn has_min_contrast_text( self, other: Self ) -> <Self::Scalar as HasBoolMask>::Mask

Verify the contrast between two colors satisfies SC 1.4.3. Contrast is at least 4.5:1 (Level AA).

fn has_min_contrast_large_text( self, other: Self ) -> <Self::Scalar as HasBoolMask>::Mask

Verify the contrast between two colors satisfies SC 1.4.3 for large text. Contrast is at least 3:1 (Level AA).

fn has_enhanced_contrast_text( self, other: Self ) -> <Self::Scalar as HasBoolMask>::Mask

Verify the contrast between two colors satisfies SC 1.4.6. Contrast is at least 7:1 (Level AAA).

fn has_enhanced_contrast_large_text( self, other: Self ) -> <Self::Scalar as HasBoolMask>::Mask

Verify the contrast between two colors satisfies SC 1.4.6 for large text. Contrast is at least 4.5:1 (Level AAA).

fn has_min_contrast_graphics( self, other: Self ) -> <Self::Scalar as HasBoolMask>::Mask

Verify the contrast between two colors satisfies SC 1.4.11 for graphical objects. Contrast is at least 3:1 (Level AA).

impl<S, T, _A> WithAlpha<_A> for Rgb<S, T>

where _A: Stimulus,

type Color = Rgb<S, T>

The opaque color type, without any transparency.

type WithAlpha = Alpha<Rgb<S, T>, _A>

The color type with transparency applied.

fn with_alpha(self, alpha: _A) -> Self::WithAlpha

Transforms the color into a transparent color with the provided alpha value. If Self already has a transparency, it is overwritten.

fn without_alpha(self) -> Self::Color

Removes the transparency from the color. If Self::Color has an internal transparency field, that field will be set to A::max_intensity() to make it opaque.

fn split(self) -> (Self::Color, _A)

Splits the color into separate color and transparency values.

fn opaque(self) -> Self::WithAlpha

where A: Stimulus,

Transforms the color into a fully opaque color with a transparency field. If Self already has a transparency, it is overwritten.

fn transparent(self) -> Self::WithAlpha

where A: Zero,

Transforms the color into a fully transparent color. If Self already has a transparency, it is overwritten.

impl<S, T> Zeroable for Rgb<S, T>

where T: Zeroable,

fn zeroed() -> Self

Calls zeroed.

impl<S, T> Copy for Rgb<S, T>

where T: Copy,

impl<S, T> Eq for Rgb<S, T>

where T: Eq,

impl<S: 'static, T> Pod for Rgb<S, T>

where T: Pod,

impl<S, T> StimulusColor for Rgb<S, T>

where T: Stimulus,