Struct tetra::graphics::Color

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

An RGBA color.

The components are stored as f32 values in the range of 0.0 to 1.0. If your data is made up of bytes or hex values, this type provides constructors that will carry out the conversion for you.

The std arithmetic traits are implemented for this type, which allows you to add/subtract/multiply/divide colors. These are implemented as saturating operations (i.e. the values will always remain between 0.0 and 1.0).

Serde

Serialization and deserialization of this type (via Serde) can be enabled via the serde_support feature.

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.

Implementations

impl Color

pub const fn rgb(r: f32, g: f32, b: f32) -> Color

Creates a new Color, with the specified RGB values and the alpha set to 1.0.

pub const fn rgba(r: f32, g: f32, b: f32, a: f32) -> Color

Creates a new Color, with the specified RGBA values.

pub fn rgb8(r: u8, g: u8, b: u8) -> Color

Creates a new Color, with the specified RGB integer (0-255) values and the alpha set to 255.

pub fn rgba8(r: u8, g: u8, b: u8, a: u8) -> Color

Creates a new Color, with the specified RGBA (0-255) integer values.

pub fn hex(hex: &str) -> Color

Creates a new Color using a hexidecimal color code, panicking if the input is invalid.

Six and eight digit codes can be used - the former will be interpreted as RGB, and the latter as RGBA. The # prefix (commonly used on the web) will be stripped if present.

pub fn try_hex(hex: &str) -> Result<Color>

Creates a new Color using a hexidecimal color code, returning an error if the input is invalid.

Six and eight digit codes can be used - the former will be interpreted as RGB, and the latter as RGBA. The # prefix (commonly used on the web) will be stripped if present.

Errors

• TetraError::InvalidColor will be returned if the specified color is invalid.

pub const fn with_red(self, r: f32) -> Self

Returns the color with the red component set to the specified value.

pub const fn with_green(self, g: f32) -> Self

Returns the color with the green component set to the specified value.

pub const fn with_blue(self, b: f32) -> Self

Returns the color with the blue component set to the specified value.

pub const fn with_alpha(self, a: f32) -> Self

Returns the color with the alpha component set to the specified value.

pub fn to_premultiplied(self) -> Color

Returns the color with the RGB components multiplied by the alpha component.

This can be useful when working with premultiplied alpha blending, if you want to convert a non-premultiplied color into its premultiplied version.

pub const BLACK: Color

Shortcut for Color::rgb(0.0, 0.0, 0.0).

pub const WHITE: Color

Shortcut for Color::rgb(1.0, 1.0, 1.0).

pub const RED: Color

Shortcut for Color::rgb(1.0, 0.0, 0.0).

pub const GREEN: Color

Shortcut for Color::rgb(0.0, 1.0, 0.0).

pub const BLUE: Color

Shortcut for Color::rgb(0.0, 0.0, 1.0)`](Self::rgb).

Trait Implementations

impl Add<Color> for Color

type Output = Color

The resulting type after applying the + operator.

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

Performs the + operation.

impl Add<f32> for Color

type Output = Color

The resulting type after applying the + operator.

fn add(self, rhs: f32) -> Self::Output

Performs the + operation.

impl AddAssign<Color> for Color

fn add_assign(&mut self, rhs: Self)

Performs the += operation.

impl AddAssign<f32> for Color

fn add_assign(&mut self, rhs: f32)

Performs the += operation.

impl Clone for Color

fn clone(&self) -> Color

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for Color

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

Formats the value using the given formatter.

impl Default for Color

fn default() -> Color

Returns the “default value” for a type.

impl Div<Color> for Color

type Output = Color

The resulting type after applying the / operator.

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

Performs the / operation.

impl Div<f32> for Color

type Output = Color

The resulting type after applying the / operator.

fn div(self, rhs: f32) -> Self::Output

Performs the / operation.

impl DivAssign<Color> for Color

fn div_assign(&mut self, rhs: Self)

Performs the /= operation.

impl DivAssign<f32> for Color

fn div_assign(&mut self, rhs: f32)

Performs the /= operation.

impl From<[f32; 4]> for Color

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

Performs the conversion.

impl From<[u8; 4]> for Color

fn from(v: [u8; 4]) -> Self

Performs the conversion.

impl From<Vec4<f32>> for Color

fn from(v: Vec4<f32>) -> Self

Performs the conversion.

impl Mul<Color> for Color

type Output = Color

The resulting type after applying the * operator.

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

Performs the * operation.

impl Mul<f32> for Color

type Output = Color

The resulting type after applying the * operator.

fn mul(self, rhs: f32) -> Self::Output

Performs the * operation.

impl MulAssign<Color> for Color

fn mul_assign(&mut self, rhs: Self)

Performs the *= operation.

impl MulAssign<f32> for Color

fn mul_assign(&mut self, rhs: f32)

Performs the *= operation.

impl PartialEq<Color> for Color

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

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

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

This method tests for !=.

impl Sub<Color> for Color

type Output = Color

The resulting type after applying the - operator.

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

Performs the - operation.

impl Sub<f32> for Color

type Output = Color

The resulting type after applying the - operator.

fn sub(self, rhs: f32) -> Self::Output

Performs the - operation.

impl SubAssign<Color> for Color

fn sub_assign(&mut self, rhs: Self)

Performs the -= operation.

impl SubAssign<f32> for Color

fn sub_assign(&mut self, rhs: f32)

Performs the -= operation.

impl Copy for Color

impl StructuralPartialEq for Color

impl UniformValue for Color

Can be accessed as a vec4 in your shader.