NAME

       makecol15_dither, makecol16_dither - Calculates a dithered 15 or 16-bit RGB value. Allegro
       game programming library.

SYNOPSIS

       #include <allegro.h>

       int makecol15_dither(int r, int g, int b, int x, int y);

       int makecol16_dither(int r, int g, int b, int x, int y);

DESCRIPTION

       Given both a color value and a pixel coordinate, calculate a dithered  15  or  16-bit  RGB
       value.  This can produce better results when reducing images from truecolor to hicolor. In
       addition to calling these functions  directly,  hicolor  dithering  can  be  automatically
       enabled  when loading graphics by calling the set_color_conversion() function, for example
       set_color_conversion(COLORCONV_REDUCE_TRUE_TO_HI | COLORCONV_DITHER).

       Example:

          int pixel1, pixel2;

          /* The following two color values MAY be different. */
          pixel1 = makecol16_dither(255, 192, 64, 0, 0);
          pixel2 = makecol16_dither(255, 192, 64, 1, 0);

RETURN VALUE

       Returns the RGB value dithered for the specified coordinate.

SEE ALSO

       makecol(3alleg4), makecol8(3alleg4), set_color_conversion(3alleg4)