Colors are often thought of as being 4 values that make up that can make any color.
But that is of course too limited. In C we didn’t spend time to annotate what we meant
when using colors.
Recently BLI_color.hh was made to facilitate color structures in CPP. CPP has possibilities to
enforce annotating structures during compilation and can adds conversions between them using
function overloading and explicit constructors.
The storage structs can hold 4 channels (r, g, b and a).
Usage:
Convert a theme byte color to a linearrgb premultiplied.
ColorTheme4b theme_color;
ColorSceneLinear4f<eAlpha::Premultiplied> linearrgb_color =
BLI_color_convert_to_scene_linear(theme_color).premultiply_alpha();The API is structured to make most use of inlining. Most notable are space
conversions done via BLI_color_convert_to* functions.
- Conversions between spaces (theme <=> scene linear) should always be done by invoking the BLI_color_convert_to* methods.
- Encoding colors (compressing to store colors inside a less precision storage) should be done by invoking the encode and decode methods.
- Changing alpha association should be done by invoking premultiply_alpha or unpremultiply_alpha methods.
Encoding.
Color encoding is used to store colors with less precision as in using uint8_t in
stead of float. This encoding is supported for eSpace::SceneLinear.
To make this clear to the developer the eSpace::SceneLinearByteEncoded
space is added.
Precision
Colors can be stored using uint8_t or float colors. The conversion
between the two precisions are available as methods. (to_4b and
to_4f).
Alpha conversion
Alpha conversion is only supported in SceneLinear space.
Extending:
- This file can be extended with ColorHex/Hsl/Hsv for different representations of rgb based colors. ColorHsl4f<eSpace::SceneLinear, eAlpha::Premultiplied>
- Add non RGB spaces/storages ColorXyz.