Graphics.CreateMappedBmp Function

Changes the color table in a bitmap.

Pascal

function CreateMappedBmp(Handle: HBITMAP; const OldColors: array of TColor; const NewColors: array of TColor): HBITMAP;

C++

HBITMAP CreateMappedBmp(HBITMAP Handle, const array of TColor OldColors, const array of TColor NewColors);

File

Graphics

Description

Call CreateMappedBmp to make selective changes to the color map of a bitmap. This function replaces the colors specified by the OldColors parameter with the colors specified by the NewColors parameter and returns the handle for a new device dependent bitmap (DDB) that uses the new color table. Handle is the handle to the bitmap whose color table should be changed. In C++, specify the size of the color arrays in OldColors_Size and NewColors_Size. This value should be the index of the last entry in the corresponding array. The OldColors and NewColors arrays should contain the same number of elements.

CreateMappedBmp creates a new bitmap. It does not alter the original bitmap, which has the handle specified by the Handle parameter.

Note: CreateMappedBmp does not work with bitmaps that have more than 256 colors. For bitmaps with more than 256 colors (8bpp), this function returns the original bitmap.