This function is intended for use when the source data is palettized.
This function is useful for displaying LUT8 source images from applications that perform palette animation. If no source palette is specified, the OS/2 default palette values will be used for translating LUT8 source data to direct color formats. If the source and destination color formats are both LUT8 and no source palette or no destination palette has been set, DiveBlitImage will transfer the 8-bit image without performing any translation. If the source and destination color formats are both LUT8 and both palettes have been set, DiveBlitImage will perform palette translation between the source palette (associated with the source image) and the destination palette (usually the physical palette, in the case where the destination is the screen).
If DiveSetSourcePalette is not called and the source format is LUT8, then the current physical palette will be used. If DiveSetSourcePalette is not called and the source format is not LUT8, then the OS/2 default palette will be used.
Neither DiveSetSourcePalette nor DiveSetDestinationPalette will set the physical palette. If your application needs to set the physical palette (that is, all 256 entries), it must do so as a full-screen (maximized) application. No WM_REALIZEPALETTE message will be sent to other applications, and no redraw is done.