Struct tetra::graphics::Color

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 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).

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 AddAssign<Color> for Color

fn add_assign(&mut self, rhs: Self)

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 Copy for Color

impl Debug for Color

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

Formats the value using the given formatter.

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 DivAssign<Color> for Color

fn div_assign(&mut self, rhs: Self)

Performs the /= operation.

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 MulAssign<Color> for Color

fn mul_assign(&mut self, rhs: Self)

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 StructuralPartialEq for Color

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 SubAssign<Color> for Color

fn sub_assign(&mut self, rhs: Self)

Performs the -= operation.