Enum bevy::render::color::Color

pub enum Color {
    Rgba {
        red: f32,
        green: f32,
        blue: f32,
        alpha: f32,
    },
    RgbaLinear {
        red: f32,
        green: f32,
        blue: f32,
        alpha: f32,
    },
    Hsla {
        hue: f32,
        saturation: f32,
        lightness: f32,
        alpha: f32,
    },
    Lcha {
        lightness: f32,
        chroma: f32,
        hue: f32,
        alpha: f32,
    },
}

Variants

Rgba

Fields

red: f32

Red channel. [0.0, 1.0]

green: f32

Green channel. [0.0, 1.0]

blue: f32

Blue channel. [0.0, 1.0]

alpha: f32

Alpha channel. [0.0, 1.0]

sRGBA color

RgbaLinear

Fields

red: f32

Red channel. [0.0, 1.0]

green: f32

Green channel. [0.0, 1.0]

blue: f32

Blue channel. [0.0, 1.0]

alpha: f32

Alpha channel. [0.0, 1.0]

RGBA color in the Linear sRGB colorspace (often colloquially referred to as “linear”, “RGB”, or “linear RGB”).

Hsla

Fields

hue: f32

Hue channel. [0.0, 360.0]

saturation: f32

Saturation channel. [0.0, 1.0]

lightness: f32

Lightness channel. [0.0, 1.0]

alpha: f32

Alpha channel. [0.0, 1.0]

HSL (hue, saturation, lightness) color with an alpha channel

Lcha

Fields

lightness: f32

Lightness channel. [0.0, 1.5]

chroma: f32

Chroma channel. [0.0, 1.5]

hue: f32

Hue channel. [0.0, 360.0]

alpha: f32

Alpha channel. [0.0, 1.0]

LCH(ab) (lightness, chroma, hue) color with an alpha channel

Implementations

impl Color

pub const ALICE_BLUE: Color = Color::rgb(0.94, 0.97, 1.0)

pub const ANTIQUE_WHITE: Color = Color::rgb(0.98, 0.92, 0.84)

pub const AQUAMARINE: Color = Color::rgb(0.49, 1.0, 0.83)

pub const AZURE: Color = Color::rgb(0.94, 1.0, 1.0)

pub const BEIGE: Color = Color::rgb(0.96, 0.96, 0.86)

pub const BISQUE: Color = Color::rgb(1.0, 0.89, 0.77)

pub const BLACK: Color = Color::rgb(0.0, 0.0, 0.0)

pub const BLUE: Color = Color::rgb(0.0, 0.0, 1.0)

pub const CRIMSON: Color = Color::rgb(0.86, 0.08, 0.24)

pub const CYAN: Color = Color::rgb(0.0, 1.0, 1.0)

pub const DARK_GRAY: Color = Color::rgb(0.25, 0.25, 0.25)

pub const DARK_GREEN: Color = Color::rgb(0.0, 0.5, 0.0)

pub const FUCHSIA: Color = Color::rgb(1.0, 0.0, 1.0)

pub const GOLD: Color = Color::rgb(1.0, 0.84, 0.0)

pub const GRAY: Color = Color::rgb(0.5, 0.5, 0.5)

pub const GREEN: Color = Color::rgb(0.0, 1.0, 0.0)

pub const INDIGO: Color = Color::rgb(0.29, 0.0, 0.51)

pub const LIME_GREEN: Color = Color::rgb(0.2, 0.8, 0.2)

pub const MAROON: Color = Color::rgb(0.5, 0.0, 0.0)

pub const MIDNIGHT_BLUE: Color = Color::rgb(0.1, 0.1, 0.44)

pub const NAVY: Color = Color::rgb(0.0, 0.0, 0.5)

pub const NONE: Color = Color::rgba(0.0, 0.0, 0.0, 0.0)

pub const OLIVE: Color = Color::rgb(0.5, 0.5, 0.0)

pub const ORANGE: Color = Color::rgb(1.0, 0.65, 0.0)

pub const ORANGE_RED: Color = Color::rgb(1.0, 0.27, 0.0)

pub const PINK: Color = Color::rgb(1.0, 0.08, 0.58)

pub const PURPLE: Color = Color::rgb(0.5, 0.0, 0.5)

pub const RED: Color = Color::rgb(1.0, 0.0, 0.0)

pub const SALMON: Color = Color::rgb(0.98, 0.5, 0.45)

pub const SEA_GREEN: Color = Color::rgb(0.18, 0.55, 0.34)

pub const SILVER: Color = Color::rgb(0.75, 0.75, 0.75)

pub const TEAL: Color = Color::rgb(0.0, 0.5, 0.5)

pub const TOMATO: Color = Color::rgb(1.0, 0.39, 0.28)

pub const TURQUOISE: Color = Color::rgb(0.25, 0.88, 0.82)

pub const VIOLET: Color = Color::rgb(0.93, 0.51, 0.93)

pub const WHITE: Color = Color::rgb(1.0, 1.0, 1.0)

pub const YELLOW: Color = Color::rgb(1.0, 1.0, 0.0)

pub const YELLOW_GREEN: Color = Color::rgb(0.6, 0.8, 0.2)

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

New Color from sRGB colorspace.

Arguments

• r - Red channel. [0.0, 1.0]
• g - Green channel. [0.0, 1.0]
• b - Blue channel. [0.0, 1.0]

See also Color::rgba, Color::rgb_u8, Color::hex.

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

New Color from sRGB colorspace.

Arguments

• r - Red channel. [0.0, 1.0]
• g - Green channel. [0.0, 1.0]
• b - Blue channel. [0.0, 1.0]
• a - Alpha channel. [0.0, 1.0]

See also Color::rgb, Color::rgba_u8, Color::hex.

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

New Color from linear RGB colorspace.

Arguments

• r - Red channel. [0.0, 1.0]
• g - Green channel. [0.0, 1.0]
• b - Blue channel. [0.0, 1.0]

See also Color::rgb, Color::rgba_linear.

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

New Color from linear RGB colorspace.

Arguments

• r - Red channel. [0.0, 1.0]
• g - Green channel. [0.0, 1.0]
• b - Blue channel. [0.0, 1.0]
• a - Alpha channel. [0.0, 1.0]

See also Color::rgba, Color::rgb_linear.

pub const fn hsl(hue: f32, saturation: f32, lightness: f32) -> Color

New Color with HSL representation in sRGB colorspace.

Arguments

• hue - Hue channel. [0.0, 360.0]
• saturation - Saturation channel. [0.0, 1.0]
• lightness - Lightness channel. [0.0, 1.0]

See also Color::hsla.

pub const fn hsla(hue: f32, saturation: f32, lightness: f32, alpha: f32) -> Color

New Color with HSL representation in sRGB colorspace.

Arguments

• hue - Hue channel. [0.0, 360.0]
• saturation - Saturation channel. [0.0, 1.0]
• lightness - Lightness channel. [0.0, 1.0]
• alpha - Alpha channel. [0.0, 1.0]

See also Color::hsl.

pub fn hex<T>(hex: T) -> Result<Color, HexColorError>where T: AsRef<str>,

New Color from sRGB colorspace.

Examples

let color = Color::hex("FF00FF").unwrap(); // fuchsia
let color = Color::hex("FF00FF7F").unwrap(); // partially transparent fuchsia

// A standard hex color notation is also available
assert_eq!(Color::hex("#FFFFFF").unwrap(), Color::rgb(1.0, 1.0, 1.0));

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

New Color from sRGB colorspace.

Arguments

• r - Red channel. [0, 255]
• g - Green channel. [0, 255]
• b - Blue channel. [0, 255]

See also Color::rgb, Color::rgba_u8, Color::hex.

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

New Color from sRGB colorspace.

Arguments

• r - Red channel. [0, 255]
• g - Green channel. [0, 255]
• b - Blue channel. [0, 255]
• a - Alpha channel. [0, 255]

See also Color::rgba, Color::rgb_u8, Color::hex.

pub fn r(&self) -> f32

Get red in sRGB colorspace.

pub fn g(&self) -> f32

Get green in sRGB colorspace.

pub fn b(&self) -> f32

Get blue in sRGB colorspace.

pub fn set_r(&mut self, r: f32) -> &mut Color

Set red in sRGB colorspace.

pub fn with_r(self, r: f32) -> Color

Returns this color with red set to a new value in sRGB colorspace.

pub fn set_g(&mut self, g: f32) -> &mut Color

Set green in sRGB colorspace.

pub fn with_g(self, g: f32) -> Color

Returns this color with green set to a new value in sRGB colorspace.

pub fn set_b(&mut self, b: f32) -> &mut Color

Set blue in sRGB colorspace.

pub fn with_b(self, b: f32) -> Color

Returns this color with blue set to a new value in sRGB colorspace.

pub fn a(&self) -> f32

Get alpha.

pub fn set_a(&mut self, a: f32) -> &mut Color

Set alpha.

pub fn with_a(self, a: f32) -> Color

Returns this color with a new alpha value.

pub fn as_rgba(&self) -> Color

Converts a Color to variant Color::Rgba

pub fn as_rgba_linear(&self) -> Color

Converts a Color to variant Color::RgbaLinear

pub fn as_hsla(&self) -> Color

Converts a Color to variant Color::Hsla

pub fn as_lcha(&self) -> Color

Converts a Color to variant Color::Lcha

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

Converts a Color to a [f32; 4] from sRGB colorspace

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

Converts a Color to a [f32; 4] from linear RGB colorspace

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

Converts a Color to a [f32; 4] from HSL colorspace

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

Converts a Color to a [f32; 4] from LCH colorspace

pub fn as_rgba_u32(self) -> u32

Converts Color to a u32 from sRGB colorspace.

Maps the RGBA channels in RGBA order to a little-endian byte array (GPUs are little-endian). A will be the most significant byte and R the least significant.

pub fn as_linear_rgba_u32(self) -> u32

Converts Color to a u32 from linear RGB colorspace.

Maps the RGBA channels in RGBA order to a little-endian byte array (GPUs are little-endian). A will be the most significant byte and R the least significant.

Trait Implementations

impl Add<Color> for Color

type Output = Color

The resulting type after applying the + operator.

fn add(self, rhs: Color) -> <Color as Add<Color>>::Output

Performs the + operation.

impl Add<Vec4> for Color

type Output = Color

The resulting type after applying the + operator.

fn add(self, rhs: Vec4) -> <Color as Add<Vec4>>::Output

Performs the + operation.

impl AddAssign<Color> for Color

fn add_assign(&mut self, rhs: Color)

Performs the += operation.

impl AddAssign<Vec4> for Color

fn add_assign(&mut self, rhs: Vec4)

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

fn create_from<B>(reader: &mut Reader<B>) -> Colorwhere B: BufferRef,

impl Debug for Color

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

Formats the value using the given formatter.

impl Default for Color

fn default() -> Color

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for Color

fn deserialize<__D>( __deserializer: __D ) -> Result<Color, <__D as Deserializer<'de>>::Error>where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Enum for Colorwhere f32: FromReflect,

fn field(&self, __name_param: &str) -> Option<&(dyn Reflect + 'static)>

Returns a reference to the value of the field (in the current variant) with the given name.

fn field_at(&self, __index_param: usize) -> Option<&(dyn Reflect + 'static)>

Returns a reference to the value of the field (in the current variant) at the given index.

fn field_mut( &mut self, __name_param: &str ) -> Option<&mut (dyn Reflect + 'static)>

Returns a mutable reference to the value of the field (in the current variant) with the given name.

fn field_at_mut( &mut self, __index_param: usize ) -> Option<&mut (dyn Reflect + 'static)>

Returns a mutable reference to the value of the field (in the current variant) at the given index.

fn index_of(&self, __name_param: &str) -> Option<usize>

Returns the index of the field (in the current variant) with the given name.

fn name_at(&self, __index_param: usize) -> Option<&str>

Returns the name of the field (in the current variant) with the given index.

fn iter_fields(&self) -> VariantFieldIter<'_>

Returns an iterator over the values of the current variant’s fields.

fn field_len(&self) -> usize

Returns the number of fields in the current variant.

fn variant_name(&self) -> &str

The name of the current variant.

fn variant_index(&self) -> usize

The index of the current variant.

fn variant_type(&self) -> VariantType

The type of the current variant.

fn clone_dynamic(&self) -> DynamicEnum

fn is_variant(&self, variant_type: VariantType) -> bool

Returns true if the current variant’s type matches the given one.

fn variant_path(&self) -> String

Returns the full path to the current variant.

impl From<[f32; 3]> for Color

fn from(_: [f32; 3]) -> Color

Converts to this type from the input type.

impl From<[f32; 4]> for Color

fn from(_: [f32; 4]) -> Color

Converts to this type from the input type.

impl From<Color> for [f32; 4]

fn from(color: Color) -> [f32; 4]

Converts to this type from the input type.

impl From<Color> for BackgroundColor

fn from(color: Color) -> BackgroundColor

Converts to this type from the input type.

impl From<Color> for Color

fn from(color: Color) -> Color

Converts to this type from the input type.

impl From<Color> for ColorMaterial

fn from(color: Color) -> ColorMaterial

Converts to this type from the input type.

impl From<Color> for StandardMaterial

fn from(color: Color) -> StandardMaterial

Converts to this type from the input type.

impl From<Color> for Vec4

fn from(color: Color) -> Vec4

Converts to this type from the input type.

impl From<Vec4> for Color

fn from(vec4: Vec4) -> Color

Converts to this type from the input type.

impl FromReflect for Color

fn from_reflect(__param0: &(dyn Reflect + 'static)) -> Option<Color>

Constructs a concrete instance of Self from a reflected value.

fn take_from_reflect( reflect: Box<dyn Reflect + 'static, Global> ) -> Result<Self, Box<dyn Reflect + 'static, Global>>

Attempts to downcast the given value to Self using, constructing the value using from_reflect if that fails.

impl GetTypeRegistration for Colorwhere f32: FromReflect,

fn get_type_registration() -> TypeRegistration

impl Mul<[f32; 3]> for Color

type Output = Color

The resulting type after applying the * operator.

fn mul(self, rhs: [f32; 3]) -> <Color as Mul<[f32; 3]>>::Output

Performs the * operation.

impl Mul<[f32; 4]> for Color

type Output = Color

The resulting type after applying the * operator.

fn mul(self, rhs: [f32; 4]) -> <Color as Mul<[f32; 4]>>::Output

Performs the * operation.

impl Mul<Vec3> for Color

type Output = Color

The resulting type after applying the * operator.

fn mul(self, rhs: Vec3) -> <Color as Mul<Vec3>>::Output

Performs the * operation.

impl Mul<Vec4> for Color

type Output = Color

The resulting type after applying the * operator.

fn mul(self, rhs: Vec4) -> <Color as Mul<Vec4>>::Output

Performs the * operation.

impl Mul<f32> for Color

type Output = Color

The resulting type after applying the * operator.

fn mul(self, rhs: f32) -> <Color as Mul<f32>>::Output

Performs the * operation.

impl MulAssign<[f32; 3]> for Color

fn mul_assign(&mut self, rhs: [f32; 3])

Performs the *= operation.

impl MulAssign<[f32; 4]> for Color

fn mul_assign(&mut self, rhs: [f32; 4])

Performs the *= operation.

impl MulAssign<Vec3> for Color

fn mul_assign(&mut self, rhs: Vec3)

Performs the *= operation.

impl MulAssign<Vec4> for Color

fn mul_assign(&mut self, rhs: Vec4)

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: &Rhs) -> bool

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

impl ReadFrom for Color

fn read_from<B>(&mut self, reader: &mut Reader<B>)where B: BufferRef,

impl Reflect for Colorwhere f32: FromReflect,

fn type_name(&self) -> &str

Returns the type name of the underlying type.

fn get_type_info(&self) -> &'static TypeInfo

Returns the TypeInfo of the underlying type.

fn into_any(self: Box<Color, Global>) -> Box<dyn Any + 'static, Global>

Returns the value as a Box<dyn Any>.

fn as_any(&self) -> &(dyn Any + 'static)

Returns the value as a &dyn Any.

fn as_any_mut(&mut self) -> &mut (dyn Any + 'static)

Returns the value as a &mut dyn Any.

fn into_reflect(self: Box<Color, Global>) -> Box<dyn Reflect + 'static, Global>

Casts this type to a boxed reflected value.

fn as_reflect(&self) -> &(dyn Reflect + 'static)

Casts this type to a reflected value.

fn as_reflect_mut(&mut self) -> &mut (dyn Reflect + 'static)

Casts this type to a mutable reflected value.

fn clone_value(&self) -> Box<dyn Reflect + 'static, Global>

Clones the value as a Reflect trait object.

fn set( &mut self, __value_param: Box<dyn Reflect + 'static, Global> ) -> Result<(), Box<dyn Reflect + 'static, Global>>

Performs a type-checked assignment of a reflected value to this value.

fn apply(&mut self, __value_param: &(dyn Reflect + 'static))

Applies a reflected value to this value.

fn reflect_ref(&self) -> ReflectRef<'_>

Returns an enumeration of “kinds” of type.

fn reflect_mut(&mut self) -> ReflectMut<'_>

Returns a mutable enumeration of “kinds” of type.

fn reflect_owned(self: Box<Color, Global>) -> ReflectOwned

Returns an owned enumeration of “kinds” of type.

fn reflect_hash(&self) -> Option<u64>

Returns a hash of the value (which includes the type).

fn reflect_partial_eq(&self, value: &(dyn Reflect + 'static)) -> Option<bool>

Returns a “partial equality” comparison result.

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

Debug formatter for the value.

fn serializable(&self) -> Option<Serializable<'_>>

Returns a serializable version of the value.

impl Serialize for Color

fn serialize<__S>( &self, __serializer: __S ) -> Result<<__S as Serializer>::Ok, <__S as Serializer>::Error>where __S: Serializer,

Serialize this value into the given Serde serializer.

impl ShaderSize for Color

const SHADER_SIZE: NonZeroU64 = Self::METADATA.min_size().0

Represents WGSL Size (equivalent to ShaderType::min_size)

impl ShaderType for Color

fn min_size() -> NonZeroU64

Represents the minimum size of Self (equivalent to GPUBufferBindingLayout.minBindingSize)

fn size(&self) -> NonZeroU64

Returns the size of Self at runtime

fn assert_uniform_compat()

Asserts that Self meets the requirements of the uniform address space restrictions on stored values and the uniform address space layout constraints

impl Typed for Colorwhere f32: FromReflect,

fn type_info() -> &'static TypeInfo

Returns the compile-time info for the underlying type.

impl WriteInto for Color

fn write_into<B>(&self, writer: &mut Writer<B>)where B: BufferMut,

impl Copy for Color

impl StructuralPartialEq for Color