The
var_bmp parameter is an
l-value
referring to a variable of the type
Bitmap.
The function sets the image palette to the parameter
pal.
The palette defines the relation between the pixel value and the color displayed. The
pal
parameter is a color sequence (the type
Seq(Color)).
The size of the palette must not exceed the maximum number of color determined by the bits per pixel
(1 bit – 2 colors, 2 bits – 4 colors, 4 bits – 16 colors, 8 bits – 256 colors).
If the palette specified is not of the full size, only the initial segment of the palette is changed.
The return value is an
l-value
referring to the modified variable.
If the bitmap is monochrome or has more than 8 bits per pixel, an
error
is returned.