Provided by: allegro5-doc_5.2.9.1+dfsg-1.1build4_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)

Allegro reference manual                                                                al_color_linear(3alleg5)