Crate bevy_color

Representations of colors in various color spaces.

This crate provides a number of color representations, including:

• Srgba (standard RGBA, with gamma correction)
• LinearRgba (linear RGBA, without gamma correction)
• Hsla (hue, saturation, lightness, alpha)
• Lcha (lightness, chroma, hue, alpha)
• Oklaba (hue, chroma, lightness, alpha)

Each of these color spaces is represented as a distinct Rust type. Colors can be converted from one color space to another using the From trait.

Color Space Usage

Rendering engines typically use linear RGBA colors, which allow for physically accurate lighting calculations. However, linear RGBA colors are not perceptually uniform, because both human eyes and computer monitors have non-linear responses to light. “Standard” RGBA represents an industry-wide compromise designed to encode colors in a way that looks good to humans in as few bits as possible, but it is not suitable for lighting calculations.

Most image file formats and scene graph formats use standard RGBA, because graphic design tools are intended to be used by humans. However, GPU hardware operates on linear RGBA, so it is important to convert standard colors to linear before sending them to the GPU. Most Bevy APIs will handle this conversion automatically, but if you are writing a custom shader, you will need to do this conversion yourself.

Other Utilities

The crate also provides a number of color operations, such as blending, color difference, and color range operations.

In addition, there is a ColorRepresentation enum that can represent any of the color types in this crate. This is useful when you need to store a color in a data structure that can’t be generic over the color type.

Example

use bevy_color::{Srgba, Hsla};

let srgba = Srgba::new(0.5, 0.2, 0.8, 1.0);
let hsla: Hsla = srgba.into();

println!("Srgba: {:?}", srgba);
println!("Hsla: {:?}", hsla);

Modules

• color_difference

Structs

• ColorRange
  Represents a range of colors that can be linearly interpolated, defined by a start and end point which must be in the same color space. It works for any color type that implements Mix.
• Hsla
  Color in Hue-Saturation-Lightness color space with alpha
• Lcha
  Color in Oklaba color space, with alpha
• LinearRgba
  Linear standard RGB color with alpha.
• Oklaba
  Color in Oklaba color space, with alpha
• Srgba
  Non-linear standard RGB with alpha.

Enums

• ColorRepresentation
  An enumerated type that can represent any of the color types in this crate.

Traits

• Alpha
  Methods for manipulating alpha values.
• AnyColorRange
  A type-erased color range that can be used to interpolate between colors in various color spaces. Note that both the start and end points must be in the same color space.
• Luminance
  Methods for changing the luminance of a color. Note that these methods are not guaranteed to produce the same results in different color spaces, but are only approximations.
• Mix
  Linear interpolation of two colors within a given color space.