.\" Generated by the Allegro makedoc utility
.TH generate_optimized_palette 3alleg4 "version 4.4.3" "Allegro" "Allegro manual"
.SH NAME
generate_optimized_palette \- Generates an optimized palette for a bitmap. Allegro game programming library.\&
.SH SYNOPSIS
.B #include <allegro.h>

.sp
.B int generate_optimized_palette(BITMAP *bmp, PALETTE pal,
.B const char rsvd[PAL_SIZE]);
.SH 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.
.SH "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.

.SH SEE ALSO
.BR generate_332_palette (3alleg4),
.BR set_color_depth (3alleg4)