Struct load_image::export::rgb::RGBA

#[repr(C)]
pub struct RGBA<ComponentType, AlphaComponentType = ComponentType> {
    pub r: ComponentType,
    pub g: ComponentType,
    pub b: ComponentType,
    pub a: AlphaComponentType,
}

The RGBA pixel

The component type can be u8 (aliased as RGBA8), u16 (aliased as RGBA16), or any other type (but simple copyable types are recommended.)

You can specify a different type for alpha, but it’s only for special cases (e.g. if you use a newtype like RGBA<LinearLight<u16>, u16>).

Fields

r: ComponentType

Red

g: ComponentType

Green

b: ComponentType

Blue

a: AlphaComponentType

Alpha

Implementations

impl<T> RGBA<T, T>

pub const fn new(r: T, g: T, b: T, a: T) -> RGBA<T, T>

Convenience function for creating a new pixel The order of arguments is R,G,B,A

impl<T, A> RGBA<T, A>

pub const fn new_alpha(r: T, g: T, b: T, a: A) -> RGBA<T, A>

Convenience function for creating a new pixel The order of arguments is R,G,B,A

impl<T, A> RGBA<T, A>

pub fn rgb_mut(&mut self) -> &mut RGB<T>

Provide a mutable view of only RGB components (leaving out alpha). Useful to change color without changing opacity.

impl<T, A> RGBA<T, A> where
    T: Clone, 

pub fn rgb(&self) -> RGB<T>

Copy RGB components out of the RGBA struct

Note: you can use .into() to convert between other types

impl<T> RGBA<T, T> where
    T: Clone, 

pub fn iter(&self) -> Cloned<Iter<'_, T>>

Iterate over all components (length=4)

impl<T, A> RGBA<T, A> where
    T: Clone, 

pub fn bgr(&self) -> BGR<T>

Copy RGB components out of the RGBA struct

Note: you can use .into() to convert between other types

impl<T, A> RGBA<T, A> where
    T: Copy,
    A: Clone, 

pub fn map_rgb<F, U, B>(&self, f: F) -> RGBA<U, B> where
    B: From<A> + Clone,
    F: FnMut(T) -> U,
    U: Clone, 

Create new RGBA with the same alpha value, but different RGB values

pub fn alpha(&self, a: A) -> RGBA<T, A>

Create a new RGBA with the new alpha value, but same RGB values

pub fn map_alpha<F, B>(&self, f: F) -> RGBA<T, B> where
    F: FnOnce(A) -> B, 

Create a new RGBA with a new alpha value created by the callback. Allows changing of the type used for the alpha channel.

Trait Implementations

impl<T, A> Add<RGBA<T, A>> for RGBA<T, A> where
    T: Add<T>,
    A: Add<A>, 

px + px

type Output = RGBA<<T as Add<T>>::Output, <A as Add<A>>::Output>

The resulting type after applying the + operator.

pub fn add(self, other: RGBA<T, A>) -> <RGBA<T, A> as Add<RGBA<T, A>>>::Output

Performs the + operation.

impl<T> Add<T> for RGBA<T, T> where
    T: Copy + Add<T, Output = T>, 

px + 1

type Output = RGBA<T, T>

The resulting type after applying the + operator.

pub fn add(self, r: T) -> <RGBA<T, T> as Add<T>>::Output

Performs the + operation.

impl<T, A> AddAssign<RGBA<T, A>> for RGBA<T, A> where
    T: Add<T, Output = T> + Copy,
    A: Add<A, Output = A> + Copy, 

px + px

pub fn add_assign(&mut self, other: RGBA<T, A>)

Performs the += operation.

impl<T> AddAssign<T> for RGBA<T, T> where
    T: Copy + Add<T, Output = T>, 

px + 1

pub fn add_assign(&mut self, r: T)

Performs the += operation.

impl<T> AsMut<[T]> for RGBA<T, T>

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

Performs the conversion.

impl<T> AsPixels<RGBA<T, T>> for [T]

pub fn as_pixels(&self) -> &[RGBA<T, T>]

Reinterpret the slice as a read-only/shared slice of pixels. Multiple consecutive elements in the slice are intepreted as a single pixel (depending on format, e.g. 3 for RGB, 4 for RGBA).

pub fn as_pixels_mut(&mut self) -> &mut [RGBA<T, T>]

Reinterpret the slice as a mutable/exclusive slice of pixels. Multiple consecutive elements in the slice are intepreted as a single pixel (depending on format, e.g. 3 for RGB, 4 for RGBA).

impl<T> AsRef<[T]> for RGBA<T, T>

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

Performs the conversion.

impl<ComponentType, AlphaComponentType> Clone for RGBA<ComponentType, AlphaComponentType> where
    ComponentType: Clone,
    AlphaComponentType: Clone, 

pub fn clone(&self) -> RGBA<ComponentType, AlphaComponentType>

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<T, B> ComponentMap<RGBA<B, B>, T, B> for RGBA<T, T> where
    T: Copy, 

pub fn map<F>(&self, f: F) -> RGBA<B, B> where
    F: FnMut(T) -> B, 

Convenience function (equivalent of self.iter().map().collect()) for applying the same formula to every component.

impl<T> ComponentSlice<T> for RGBA<T, T>

pub fn as_slice(&self) -> &[T]

The components interpreted as an array, e.g. one RGB expands to 3 elements.

pub fn as_mut_slice(&mut self) -> &mut [T]

The components interpreted as a mutable array, e.g. one RGB expands to 3 elements.

impl<ComponentType, AlphaComponentType> Debug for RGBA<ComponentType, AlphaComponentType> where
    ComponentType: Debug,
    AlphaComponentType: Debug, 

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

Formats the value using the given formatter.

impl<ComponentType, AlphaComponentType> Default for RGBA<ComponentType, AlphaComponentType> where
    ComponentType: Default,
    AlphaComponentType: Default, 

pub fn default() -> RGBA<ComponentType, AlphaComponentType>

Returns the “default value” for a type.

impl<T, A> Display for RGBA<T, A> where
    T: Display,
    A: Display, 

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

Formats the value using the given formatter.

impl<T> Div<T> for RGBA<T, T> where
    T: Copy + Div<T, Output = T>, 

px / 1

type Output = RGBA<T, T>

The resulting type after applying the / operator.

pub fn div(self, r: T) -> <RGBA<T, T> as Div<T>>::Output

Performs the / operation.

impl<T> DivAssign<T> for RGBA<T, T> where
    T: Copy + Div<T, Output = T>, 

px * 1

pub fn div_assign(&mut self, r: T)

Performs the /= operation.

impl<T> From<[T; 4]> for RGBA<T, T> where
    T: Copy, 

pub fn from(other: [T; 4]) -> RGBA<T, T>

Performs the conversion.

impl<T, A> From<(T, T, T, A)> for RGBA<T, A>

pub fn from(other: (T, T, T, A)) -> RGBA<T, A>

Performs the conversion.

impl<T> From<BGR<T>> for RGBA<T, u16> where
    T: Copy, 

Assumes 65535 is opaque

pub fn from(other: BGR<T>) -> RGBA<T, u16>

Performs the conversion.

impl<T> From<BGR<T>> for RGBA<T, u8> where
    T: Copy, 

Assumes 255 is opaque

pub fn from(other: BGR<T>) -> RGBA<T, u8>

Performs the conversion.

impl<T> From<BGRA<T, T>> for RGBA<T, T>

pub fn from(other: BGRA<T, T>) -> RGBA<T, T>

Performs the conversion.

impl<T, A> From<GrayAlpha<T, A>> for RGBA<T, A> where
    T: Clone, 

pub fn from(other: GrayAlpha<T, A>) -> RGBA<T, A>

Performs the conversion.

impl<T> From<RGB<T>> for RGBA<T, u16> where
    T: Copy, 

Assumes 65535 is opaque

pub fn from(other: RGB<T>) -> RGBA<T, u16>

Performs the conversion.

impl<T> From<RGB<T>> for RGBA<T, u8> where
    T: Copy, 

Assumes 255 is opaque

pub fn from(other: RGB<T>) -> RGBA<T, u8>

Performs the conversion.

impl<T> From<RGBA<T, T>> for BGRA<T, T>

pub fn from(other: RGBA<T, T>) -> BGRA<T, T>

Performs the conversion.

impl From<RGBA<f32, f32>> for RGBA<f64, f64>

pub fn from(other: RGBA<f32, f32>) -> RGBA<f64, f64>

Performs the conversion.

impl From<RGBA<i16, i16>> for RGBA<f32, f32>

pub fn from(other: RGBA<i16, i16>) -> RGBA<f32, f32>

Performs the conversion.

impl From<RGBA<i16, i16>> for RGBA<f64, f64>

pub fn from(other: RGBA<i16, i16>) -> RGBA<f64, f64>

Performs the conversion.

impl From<RGBA<i32, i32>> for RGBA<f64, f64>

pub fn from(other: RGBA<i32, i32>) -> RGBA<f64, f64>

Performs the conversion.

impl From<RGBA<u16, u16>> for RGBA<f32, f32>

pub fn from(other: RGBA<u16, u16>) -> RGBA<f32, f32>

Performs the conversion.

impl From<RGBA<u16, u16>> for RGBA<i32, i32>

pub fn from(other: RGBA<u16, u16>) -> RGBA<i32, i32>

Performs the conversion.

impl From<RGBA<u16, u16>> for RGBA<f64, f64>

pub fn from(other: RGBA<u16, u16>) -> RGBA<f64, f64>

Performs the conversion.

impl From<RGBA<u8, u8>> for RGBA<f32, f32>

pub fn from(other: RGBA<u8, u8>) -> RGBA<f32, f32>

Performs the conversion.

impl From<RGBA<u8, u8>> for RGBA<f64, f64>

pub fn from(other: RGBA<u8, u8>) -> RGBA<f64, f64>

Performs the conversion.

impl<T> FromIterator<T> for RGBA<T, T>

pub fn from_iter<I>(into_iter: I) -> RGBA<T, T> where
    I: IntoIterator<Item = T>, 

Takes exactly 4 elements from the iterator and creates a new instance. Panics if there are fewer elements in the iterator.

impl<ComponentType, AlphaComponentType> Hash for RGBA<ComponentType, AlphaComponentType> where
    ComponentType: Hash,
    AlphaComponentType: Hash, 

pub fn hash<__H>(&self, state: &mut __H) where
    __H: Hasher, 

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H) where
    H: Hasher, 

Feeds a slice of this type into the given Hasher.

impl<T> Into<[T; 4]> for RGBA<T, T>

pub fn into(self) -> [T; 4]

Performs the conversion.

impl<T, A> Into<(T, T, T, A)> for RGBA<T, A>

pub fn into(self) -> (T, T, T, A)

Performs the conversion.

impl<T> Mul<T> for RGBA<T, T> where
    T: Copy + Mul<T, Output = T>, 

px * 1

type Output = RGBA<T, T>

The resulting type after applying the * operator.

pub fn mul(self, r: T) -> <RGBA<T, T> as Mul<T>>::Output

Performs the * operation.

impl<T> MulAssign<T> for RGBA<T, T> where
    T: Copy + Mul<T, Output = T>, 

px * 1

pub fn mul_assign(&mut self, r: T)

Performs the *= operation.

impl<ComponentType, AlphaComponentType> Ord for RGBA<ComponentType, AlphaComponentType> where
    ComponentType: Ord,
    AlphaComponentType: Ord, 

pub fn cmp(&self, other: &RGBA<ComponentType, AlphaComponentType>) -> Ordering

This method returns an Ordering between self and other.

#[must_use]

fn max(self, other: Self) -> Self

Compares and returns the maximum of two values.

#[must_use]

fn min(self, other: Self) -> Self

Compares and returns the minimum of two values.

#[must_use]

fn clamp(self, min: Self, max: Self) -> Self

Restrict a value to a certain interval.

impl<ComponentType, AlphaComponentType> PartialEq<RGBA<ComponentType, AlphaComponentType>> for RGBA<ComponentType, AlphaComponentType> where
    ComponentType: PartialEq<ComponentType>,
    AlphaComponentType: PartialEq<AlphaComponentType>, 

pub fn eq(&self, other: &RGBA<ComponentType, AlphaComponentType>) -> bool

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

pub fn ne(&self, other: &RGBA<ComponentType, AlphaComponentType>) -> bool

This method tests for !=.

impl<ComponentType, AlphaComponentType> PartialOrd<RGBA<ComponentType, AlphaComponentType>> for RGBA<ComponentType, AlphaComponentType> where
    ComponentType: PartialOrd<ComponentType>,
    AlphaComponentType: PartialOrd<AlphaComponentType>, 

pub fn partial_cmp(
    &self,
    other: &RGBA<ComponentType, AlphaComponentType>
) -> Option<Ordering>

This method returns an ordering between self and other values if one exists.

#[must_use]

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

This method tests less than (for self and other) and is used by the < operator.

#[must_use]

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

This method tests less than or equal to (for self and other) and is used by the <= operator.

#[must_use]

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

This method tests greater than (for self and other) and is used by the > operator.

#[must_use]

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

This method tests greater than or equal to (for self and other) and is used by the >= operator.

impl<T, A> Sub<RGBA<T, A>> for RGBA<T, A> where
    T: Sub<T>,
    A: Sub<A>, 

px - px

type Output = RGBA<<T as Sub<T>>::Output, <A as Sub<A>>::Output>

The resulting type after applying the - operator.

pub fn sub(self, other: RGBA<T, A>) -> <RGBA<T, A> as Sub<RGBA<T, A>>>::Output

Performs the - operation.

impl<T> Sub<T> for RGBA<T, T> where
    T: Copy + Sub<T, Output = T>, 

px - 1

type Output = RGBA<<T as Sub<T>>::Output, <T as Sub<T>>::Output>

The resulting type after applying the - operator.

pub fn sub(self, r: T) -> <RGBA<T, T> as Sub<T>>::Output

Performs the - operation.

impl<T, A> SubAssign<RGBA<T, A>> for RGBA<T, A> where
    T: Sub<T, Output = T> + Copy,
    A: Sub<A, Output = A> + Copy, 

px - px

pub fn sub_assign(&mut self, other: RGBA<T, A>)

Performs the -= operation.

impl<T> SubAssign<T> for RGBA<T, T> where
    T: Copy + Sub<T, Output = T>, 

px - 1

pub fn sub_assign(&mut self, r: T)

Performs the -= operation.

impl<T, A> Sum<RGBA<T, A>> for RGBA<T, A> where
    T: Default + Add<T, Output = T>,
    A: Default + Add<A, Output = A>, 

pub fn sum<I>(iter: I) -> RGBA<T, A> where
    I: Iterator<Item = RGBA<T, A>>, 

Method which takes an iterator and generates Self from the elements by “summing up” the items.

impl<T, A> Zeroable for RGBA<T, A> where
    T: Zeroable,
    A: Zeroable, 

fn zeroed() -> Self

Calls zeroed.

impl<ComponentType, AlphaComponentType> Copy for RGBA<ComponentType, AlphaComponentType> where
    ComponentType: Copy,
    AlphaComponentType: Copy, 

impl<ComponentType, AlphaComponentType> Eq for RGBA<ComponentType, AlphaComponentType> where
    ComponentType: Eq,
    AlphaComponentType: Eq, 

impl<T, A> Pod for RGBA<T, A> where
    T: Pod,
    A: Pod, 

impl<ComponentType, AlphaComponentType> StructuralEq for RGBA<ComponentType, AlphaComponentType>

impl<ComponentType, AlphaComponentType> StructuralPartialEq for RGBA<ComponentType, AlphaComponentType>