This method allows you to do color reduction on a canvas using a
variety of palette, dither and color options.
You can use many formats of palette. If you want ImageGlue to
derive a palette for you then just specify one of the standard
parameter string options. Additionally you may need to supply a
number of colors for the palette.
If you want to use a palette from a file - typically an act file
- then supply the path to that file.
If you want to use a raw palette derived from some other source
then provide the raw data. You may obtain such information using
the GetInfo method or by reading an act file into memory.
Raw palettes consist of an array of 768 bytes holding 256 RGB
triplets. Additionally ImageGlue will handle RGBA data.
The dither parameter determines whether dithering is performed
when the colors in the image are reduced. ImageGlue uses a highly
optimized Floyd-Steinberg diffusion dither for speed and
Please note that video drivers expect that colors like black and
white will always be present in an image. ImageGlue may remove
these colors if they are not required. This means you may have
problems drawing color reduced canvasses onto other canvasses.