Struct RGBA

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

A Red + Green + Blue + Alpha pixel.

Examples

use rgb::Rgba;

let pixel: Rgba<u8> = Rgba { r: 0, g: 0, b: 0, a: 255 };

Fields

r: T

Red Component

g: T

Green Component

b: T

Blue Component

a: A

Alpha Component

Implementations

impl<T> Rgba<T>

where T: Copy,

pub const fn new(red: T, green: T, blue: T, alpha: T) -> Rgba<T>

Creates a new Rgba pixel type from its components.

Alternatively, you can use struct literal syntax to create the new pixel type:

use rgb::Rgba;

let pixel = Rgba {r : red, g : green, b : blue, a : alpha};

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>

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 F: FnMut(T) -> U, U: Clone, B: From<A> + Clone,

👎Deprecated: Renamed to map_colors()

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

pub fn with_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> Add<T> for Rgba<T>

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

px + 1

type Output = Rgba<T>

The resulting type after applying the + operator.

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

Performs the + operation.

impl<T, A> Add for Rgba<T, A>

where T: Add, A: Add,

px + px

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

The resulting type after applying the + operator.

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

Performs the + operation.

impl<T> AddAssign<T> for Rgba<T>

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

px + 1

fn add_assign(&mut self, r: T)

Performs the += operation.

impl<T, A> AddAssign for Rgba<T, A>

where T: Add<Output = T> + Copy, A: Add<Output = A> + Copy,

px + px

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

Performs the += operation.

impl<T> AsMut<[T]> for Rgba<T>

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

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

impl<T> AsPixels<Rgba<T>> for [T]

fn as_pixels(&self) -> &[Rgba<T>]

Use ::bytemuck::cast_slice() instead.

fn as_pixels_mut(&mut self) -> &mut [Rgba<T>]

Use ::bytemuck::cast_slice_mut() instead.

impl<T> AsRef<[T]> for Rgba<T>

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

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

impl<T, A> Clone for Rgba<T, A>

where T: Clone, A: Clone,

fn clone(&self) -> Rgba<T, A>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<T, A, B> ColorComponentMap<Rgba<B, A>, T, B> for Rgba<T, A>

where T: Copy, A: Copy,

fn map_colors<F>(&self, f: F) -> Rgba<B, A>

where F: FnMut(T) -> B,

Convenience function for applying the same formula to every rgb/gray component, but skipping the alpha component.

fn map_c<Callback>(&self, f: Callback) -> DestPixel

where Callback: FnMut(SrcComponent) -> DestComponent,

👎Deprecated: renamed to map_colors

Alias of map_colors

impl<T, B> ComponentMap<Rgba<B>, T, B> for Rgba<T>

where T: Copy,

fn map<F>(&self, f: F) -> Rgba<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>

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

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

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

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

impl<T, A> Debug for Rgba<T, A>

where T: Debug, A: Debug,

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

Formats the value using the given formatter.

impl<T, A> Default for Rgba<T, A>

where T: Default, A: Default,

fn default() -> Rgba<T, A>

Returns the “default value” for a type.

impl<T, A> Display for Rgba<T, A>

where T: Display, A: Display,

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

Formats the value using the given formatter.

impl<T> Div<T> for Rgba<T>

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

px / 1

type Output = Rgba<T>

The resulting type after applying the / operator.

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

Performs the / operation.

impl<T> DivAssign<T> for Rgba<T>

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

px * 1

fn div_assign(&mut self, r: T)

Performs the /= operation.

impl<T> From<[T; 4]> for Rgba<T>

where T: Copy,

fn from(other: [T; 4]) -> Rgba<T>

Converts to this type from the input type.

impl<R, S> From<(R, R, R, R)> for Rgba<S>

where R: Into<S>,

fn from(value: (R, R, R, R)) -> Rgba<S>

Converts to this type from the input type.

impl<T> From<Abgr<T>> for Rgba<T>

where T: Clone,

fn from(other: Abgr<T>) -> Rgba<T>

Converts to this type from the input type.

impl<T> From<Argb<T>> for Rgba<T>

where T: Clone,

fn from(other: Argb<T>) -> Rgba<T>

Converts to this type from the input type.

impl<T> From<Bgr<T>> for Rgba<T, u16>

where T: Copy,

Assumes 65535 is opaque

fn from(other: Bgr<T>) -> Rgba<T, u16>

Converts to this type from the input type.

impl<T> From<Bgr<T>> for Rgba<T, u8>

where T: Copy,

Assumes 255 is opaque

fn from(other: Bgr<T>) -> Rgba<T, u8>

Converts to this type from the input type.

impl<T> From<Bgra<T>> for Rgba<T>

where T: Clone,

fn from(other: Bgra<T>) -> Rgba<T>

Converts to this type from the input type.

impl<T, A> From<GrayAlpha_v08<T, A>> for Rgba<T, A>

where T: Clone,

fn from(other: GrayAlpha_v08<T, A>) -> Rgba<T, A>

Converts to this type from the input type.

impl<T> From<Gray_v08<T>> for Rgba<T, u8>

where T: Clone,

fn from(other: Gray_v08<T>) -> Rgba<T, u8>

Converts to this type from the input type.

impl<T> From<Rgb<T>> for Rgba<T, u16>

where T: Copy,

Assumes 65535 is opaque

fn from(other: Rgb<T>) -> Rgba<T, u16>

Converts to this type from the input type.

impl<T> From<Rgb<T>> for Rgba<T, u8>

where T: Copy,

Assumes 255 is opaque

fn from(other: Rgb<T>) -> Rgba<T, u8>

Converts to this type from the input type.

impl From<Rgba<f32>> for Rgba<f64>

fn from(other: Rgba<f32>) -> Rgba<f64>

Converts to this type from the input type.

impl From<Rgba<i16>> for Rgba<f32>

fn from(other: Rgba<i16>) -> Rgba<f32>

Converts to this type from the input type.

impl From<Rgba<i16>> for Rgba<f64>

fn from(other: Rgba<i16>) -> Rgba<f64>

Converts to this type from the input type.

impl From<Rgba<i32>> for Rgba<f64>

fn from(other: Rgba<i32>) -> Rgba<f64>

Converts to this type from the input type.

impl From<Rgba<u16>> for Rgba<f32>

fn from(other: Rgba<u16>) -> Rgba<f32>

Converts to this type from the input type.

impl From<Rgba<u16>> for Rgba<f64>

fn from(other: Rgba<u16>) -> Rgba<f64>

Converts to this type from the input type.

impl From<Rgba<u16>> for Rgba<i32>

fn from(other: Rgba<u16>) -> Rgba<i32>

Converts to this type from the input type.

impl From<Rgba<u16>> for Rgba<u32>

fn from(other: Rgba<u16>) -> Rgba<u32>

Converts to this type from the input type.

impl From<Rgba<u16>> for Rgba<u64>

fn from(other: Rgba<u16>) -> Rgba<u64>

Converts to this type from the input type.

impl From<Rgba<u8>> for Rgba<f32>

fn from(other: Rgba<u8>) -> Rgba<f32>

Converts to this type from the input type.

impl From<Rgba<u8>> for Rgba<f64>

fn from(other: Rgba<u8>) -> Rgba<f64>

Converts to this type from the input type.

impl From<Rgba<u8>> for Rgba<i16>

fn from(other: Rgba<u8>) -> Rgba<i16>

Converts to this type from the input type.

impl From<Rgba<u8>> for Rgba<u16>

fn from(other: Rgba<u8>) -> Rgba<u16>

Converts to this type from the input type.

impl From<Rgba<u8>> for Rgba<u32>

fn from(other: Rgba<u8>) -> Rgba<u32>

Converts to this type from the input type.

impl<T> FromIterator<T> for Rgba<T>

fn from_iter<I>(into_iter: I) -> Rgba<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<T, A> Hash for Rgba<T, A>

where T: Hash, A: Hash,

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, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl<T> Mul<T> for Rgba<T>

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

px * 1

type Output = Rgba<T>

The resulting type after applying the * operator.

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

Performs the * operation.

impl<T> MulAssign<T> for Rgba<T>

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

px * 1

fn mul_assign(&mut self, r: T)

Performs the *= operation.

impl<T, A> Ord for Rgba<T, A>

where T: Ord, A: Ord,

fn cmp(&self, other: &Rgba<T, A>) -> Ordering

This method returns an Ordering between self and other.

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

where Self: Sized,

Compares and returns the maximum of two values.

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

where Self: Sized,

Compares and returns the minimum of two values.

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

where Self: Sized,

Restrict a value to a certain interval.

impl<T, A> PartialEq for Rgba<T, A>

where T: PartialEq, A: PartialEq,

fn eq(&self, other: &Rgba<T, A>) -> bool

Tests for self and other values to be equal, and is used by ==.

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

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

impl<T, A> PartialOrd for Rgba<T, A>

where T: PartialOrd, A: PartialOrd,

fn partial_cmp(&self, other: &Rgba<T, A>) -> Option<Ordering>

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

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

Tests less than (for self and other) and is used by the < operator.

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

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

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

Tests greater than (for self and other) and is used by the > operator.

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

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

impl<T> Sub<T> for Rgba<T>

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

px - 1

type Output = Rgba<<T as Sub>::Output>

The resulting type after applying the - operator.

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

Performs the - operation.

impl<T, A> Sub for Rgba<T, A>

where T: Sub, A: Sub,

px - px

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

The resulting type after applying the - operator.

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

Performs the - operation.

impl<T> SubAssign<T> for Rgba<T>

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

px - 1

fn sub_assign(&mut self, r: T)

Performs the -= operation.

impl<T, A> SubAssign for Rgba<T, A>

where T: Sub<Output = T> + Copy, A: Sub<Output = A> + Copy,

px - px

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

Performs the -= operation.

impl<T, A> Sum for Rgba<T, A>

where T: Default + Add<Output = T>, A: Default + Add<Output = A>,

fn sum<I>(iter: I) -> Rgba<T, A>

where I: Iterator<Item = Rgba<T, A>>,

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,

This is unsound. You can disable as-bytes feature, enable bytemuck, and use bytemuck::cast_slice() instead.

fn zeroed() -> Rgba<T, A>

Calls zeroed.

impl<T, A> Copy for Rgba<T, A>

where T: Copy, A: Copy,

impl<T, A> Eq for Rgba<T, A>

where T: Eq, A: Eq,

impl<T, A> Pod for Rgba<T, A>

where T: Pod, A: Pod,

This is unsound. You can disable as-bytes feature, enable bytemuck, and use bytemuck::cast_slice() instead.

impl<T, A> StructuralPartialEq for Rgba<T, A>