Struct smol_rgb::EncodedColor

#[repr(C)]
pub struct EncodedColor {
    pub r: u8,
    pub g: u8,
    pub b: u8,
    pub a: u8,
}

A color used in linear applications. On a technical level, this color is in sRGB; however, this name is not very clear.

In code, we will say that this Color is encoded. This is generally the same colorspace that texels in a texture are in. This color space is not valid to perform mixing operations between colors in, so we must convert this color space into a different color, LinearColor, with to_linear before we do such operations.

Fields

r: u8

The red component of the color.

g: u8

The green component of the color.

b: u8

The blue component of the color.

a: u8

The alpha component of the color, normally the opacity in blending operations.

Implementations

impl EncodedColor

pub const WHITE: EncodedColor = _

A basic white (255, 255, 255, 255) with full opacity.

pub const BLACK: EncodedColor = _

A basic black (0, 0, 0, 255) with full opacity.

pub const CLEAR: EncodedColor = _

A black (0, 0, 0, 0) with zero opacity.

pub const fn new(r: u8, g: u8, b: u8, a: u8) -> Self

Creates a new encoded 32bit color.

pub fn to_linear(self) -> LinearColor

Transforms this color into the Linear color space.

pub fn to_encoded_f32s(self) -> [f32; 4]

Converts this color to an [f32; 4] array. This is still in encoded space but they are converted to an f32. This is mostly for compatability with other libraries which sometimes need to f32s even while in encoded sRGB.

We use this dedicated function, rather than a From or Into because this is an unusual use of f32s, and in general, this module acts as if f32 == Linear and u8 == Encoded, though this is not technically true.

pub fn from_encoded_f32s(input: [f32; 4]) -> Self

Converts this color to an [f32; 4] array. This is still in encoded space but they are converted to an f32. This is mostly for compatability with other libraries which sometimes need to f32s even while in encoded sRGB.

We use this dedicated function, rather than a From or Into because this is an unusual use of f32s, and in general, this module acts as if f32 == Linear and u8 == Encoded, though this is not technically true.

pub const fn from_rgba_u32(input: u32) -> Self

Converts a packed u32 to an encoded rgba struct.

Note, your colors must be in order of red, green, blue, alpha. For bgra support, use from_bgra_u32.

This function might also has issues on non-little endian platforms, but look, you’re not on one of those.

pub const fn to_rgba_u32(self) -> u32

Converts the encoded rgba struct to a packed u32 in rgba encoding.

This will output your colors in order of red, green, blue, alpha. For bgra support, use to_bgra_u32.

This function might also have issues on non-little endian platforms, but look, you’re not on one of those.

pub const fn from_bgra_u32(input: u32) -> Self

Converts a packed u32 to an encoded rgba struct. On little endian platforms, this is a no-op.

Note, your colors must be in order of blue, green, red, alpha.

This function might also has issues on non-little endian platforms, but look, you’re not on one of those probably.

pub const fn to_bgra_u32(self) -> u32

Converts the encoded rgba struct to a packed u32 in bgra encoding.

This will output your colors in order of red, green, blue, alpha. For bgra support, use to_bgra_u32.

This function might also have issues on non-little endian platforms, but look, you’re not on one of those.

pub const fn from_bits_u32(value: u32) -> Self

Recasts four u8s into EncodedColor

pub const fn from_bits(value: [u8; 4]) -> Self

Recasts four u8s into EncodedColor

impl EncodedColor

pub const RED: EncodedColor = _

Full alpha Red (255, 0, 0, 255)

pub const RED_CLEAR: EncodedColor = _

Zero alpha Red (255, 0, 0, 255)

pub const GREEN: EncodedColor = _

Full alpha green (255, 0, 0, 255)

pub const GREEN_CLEAR: EncodedColor = _

Zero alpha green (255, 0, 0, 255)

pub const BLUE: EncodedColor = _

Full alpha blue (255, 0, 0, 255)

pub const BLUE_CLEAR: EncodedColor = _

Zero alpha blue (255, 0, 0, 255)

pub const YELLOW: EncodedColor = _

Full alpha Yellow (255, 255, 0, 255).

pub const YELLOW_CLEAR: EncodedColor = _

Zero alpha Yellow (255, 255, 0, 0).

pub const FUCHSIA: EncodedColor = _

God’s color (255, 0, 255, 255). The color of choice for graphics testing.

pub const FUCHSIA_CLEAR: EncodedColor = _

God’s color but clear (255, 0, 255, 255). The color of choice for graphics testing.

pub const TEAL: EncodedColor = _

Full alpha Teal (0, 255, 255, 255).

pub const TEAL_CLEAR: EncodedColor = _

Zero alpha Teal (0, 255, 255, 0).

Trait Implementations

impl Clone for EncodedColor

fn clone(&self) -> EncodedColor

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for EncodedColor

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

Formats the value using the given formatter.

impl Default for EncodedColor

fn default() -> Self

Returns the “default value” for a type.

impl Display for EncodedColor

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

Formats the value using the given formatter.

impl From<[u8; 4]> for EncodedColor

fn from([r, g, b, a]: [u8; 4]) -> Self

Converts to this type from the input type.

impl From<(u8, u8, u8, u8)> for EncodedColor

fn from(o: (u8, u8, u8, u8)) -> Self

Converts to this type from the input type.

impl From<EncodedColor> for [u8; 4]

fn from(o: EncodedColor) -> Self

Converts to this type from the input type.

impl From<EncodedColor> for (u8, u8, u8, u8)

fn from(o: EncodedColor) -> Self

Converts to this type from the input type.

impl From<EncodedColor> for LinearColor

fn from(o: EncodedColor) -> Self

Converts to this type from the input type.

impl From<LinearColor> for EncodedColor

fn from(o: LinearColor) -> Self

Converts to this type from the input type.

impl Hash for EncodedColor

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

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 LowerHex for EncodedColor

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

Formats the value using the given formatter.

impl Ord for EncodedColor

fn cmp(&self, other: &EncodedColor) -> Ordering

This method returns an Ordering between self and other.

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

Compares and returns the maximum of two values.

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

Compares and returns the minimum of two values.

fn clamp(self, min: Self, max: Self) -> Selfwhere Self: Sized + PartialOrd<Self>,

Restrict a value to a certain interval.

impl PartialEq<EncodedColor> for EncodedColor

fn eq(&self, other: &EncodedColor) -> 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 PartialOrd<EncodedColor> for EncodedColor

fn partial_cmp(&self, other: &EncodedColor) -> Option<Ordering>

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

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

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

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

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

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

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

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 UpperHex for EncodedColor

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

Formats the value using the given formatter.

impl Copy for EncodedColor

impl Eq for EncodedColor

impl StructuralEq for EncodedColor

impl StructuralPartialEq for EncodedColor