NAME

       generate_optimized_palette  -  Generates  an  optimized palette for a bitmap. Allegro game
       programming library.

SYNOPSIS

       #include <allegro.h>

       int generate_optimized_palette(BITMAP *bmp, PALETTE pal, const char rsvd[PAL_SIZE]);

DESCRIPTION

       Generates a 256-color palette suitable for making a reduced color version of the specified
       truecolor  image.  The  rsvd  parameter  points  to  a table indicating which colors it is
       allowed to modify: zero for free colors which may be set to whatever the optimiser  likes,
       negative  values  for  reserved colors which cannot be used, and positive values for fixed
       palette entries that must not be changed, but can be used in the optimisation.

RETURN VALUE

       Returns the number of different colors recognised in the  provided  bitmap,  zero  if  the
       bitmap  is  not  a truecolor image or there wasn't enough memory to perform the operation,
       and negative if there was any internal error in the color reduction code.

SEE ALSO

       generate_332_palette(3alleg4), set_color_depth(3alleg4)