makecol15_dither(3alleg4) netbsd man page | unix.com

makecol15_dither(3alleg4)					  Allegro manual					 makecol15_dither(3alleg4)

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 | COLOR-
       CONV_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)

Allegro 							   version 4.4.2					 makecol15_dither(3alleg4)