Provided by: allegro5-doc_5.2.8.0-2_all bug

NAME

       al_color_linear - Allegro 5 API

SYNOPSIS

              #include <allegro5/allegro_color.h>

              ALLEGRO_COLOR al_color_linear(float r, float g, float b)

DESCRIPTION

       Return  an  ALLEGRO_COLOR(3alleg5)  structure from linear sRGB values.  Allegro RGB values
       are assumed to be sRGB.  The sRGB standard is in wide use by various display devices.   It
       accounts for a standard gamma correction applied to RGB colors before they get displayed.

       Gamma  correction  means  if  for  example  we  have  a  medium  gray color specified with
       al_map_rgb_f(0.5,0.5,0.5) then we do not want the monitor to set the pixel to exactly half
       the  physical  maximum  intensity,  but instead to an intensity that appears to be half as
       bright as the maximum to the person looking at it.  In this case that would be  closer  to
       21% of maximum intensity rather than to 50% intensity.

       For  some  applications  it may be useful to specify a color in linear sRGB components, in
       which case you can use this function.  For example:

              ALLEGRO_COLOR gray = al_color_linear(0.216, 0.216, 0.216);
              char html[8];
              al_color_rgb_to_html(gray.r, gray.g, gray.b, html); // "#808080"

SINCE

       5.2.8

SEE ALSO

       al_color_linear_to_rgb(3alleg5), al_color_rgb_to_linear(3alleg5)