Struct smol_rgb::LinearRgb

pub struct LinearRgb {
    pub r: f32,
    pub g: f32,
    pub b: f32,
    pub a: f32,
}

This is a Color in the linear space. This represents “linear sRGB”. You should use this color space when blending colors on the CPU or when sending uniforms to a linear card.

Colors on disc are EncodedRgb, but to blend them correctly, you need to move them into the linear color space with to_linear.

You can directly create this struct, but you probably don’t want to. You’d need already linear sRGB to correctly make this struct – that’s possible to have, but generally, textures, color pickers (like photoshop), and outputted surface (like if you use a Color Picker on a game) will all be in the encoded RGB space. Exceptions abound though, so it is possible to directly create this color.

Fields

r: f32

The red component of the color.

g: f32

The green component of the color.

b: f32

The blue component of the color.

a: f32

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

Implementations

impl LinearRgb

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

You probably don’t want to use this function. This creates a color in the LinearColor space directly. For this function to be valid, the colors given to this function must be in the linear space already.

pub fn to_encoded_space(self) -> EncodedRgb

Transforms this color into the Encoded color space. Use this space to serialize colors.

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

Creates an array representation of the color. This is useful for sending the color to a uniform, but is the same memory representation as Self. LinearRgb also implements Into, but this function is often more convenient.

pub fn to_bits(self) -> [u8; 16]

Encodes the 4 floats as 16 u8s. This is useful for sending the color to a uniform, but is the same memory representation as Self – ie, the bits have just been reinterpreted as 16 u8s, but they’re still secret floats.

Trait Implementations

impl Clone for LinearRgb

fn clone(&self) -> LinearRgb

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Copy for LinearRgb

impl Debug for LinearRgb

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

Formats the value using the given formatter.

impl Default for LinearRgb

fn default() -> LinearRgb

Returns the “default value” for a type.

impl Display for LinearRgb

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

Formats the value using the given formatter.

impl From<[f32; 4]> for LinearRgb

fn from(o: [f32; 4]) -> Self

Performs the conversion.

impl From<(f32, f32, f32, f32)> for LinearRgb

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

Performs the conversion.

impl From<EncodedRgb> for LinearRgb

fn from(o: EncodedRgb) -> Self

Performs the conversion.

impl From<LinearRgb> for EncodedRgb

fn from(o: LinearRgb) -> Self

Performs the conversion.

impl Into<[f32; 4]> for LinearRgb

fn into(self) -> [f32; 4]

Performs the conversion.

impl Into<(f32, f32, f32, f32)> for LinearRgb

fn into(self) -> (f32, f32, f32, f32)

Performs the conversion.

impl PartialEq<LinearRgb> for LinearRgb

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

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

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

This method tests for !=.

impl PartialOrd<LinearRgb> for LinearRgb

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

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

#[must_use]pub fn lt(&self, other: &Rhs) -> bool

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

#[must_use]pub 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]pub fn gt(&self, other: &Rhs) -> bool

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

#[must_use]pub 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 StructuralPartialEq for LinearRgb