Graphics.CreateMappedRes Function

Changes the color table in a bitmap resource.

Pascal

function CreateMappedRes(Instance: THandle; ResName: PChar; const OldColors: array of TColor; const NewColors: array of TColor): HBITMAP;

C++

HBITMAP CreateMappedRes(THandle Instance, const char * ResName, const array of TColor OldColors, const array of TColor NewColors);

File

Graphics

Description

Call CreateMappedRes to make selective changes to the color map of a resourced 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. Use the Instance and ResName parameters to identify the bitmap resource whose color table should be changed. In C++, indicate the number of elements in the color arrays by the OldColors_Size and NewColors_Size parameters. These values should be the index of the last element in the corresponding color array, not the number of entries. The OldColors and NewColors arrays should contain the same number of elements.

Note: CreateMappedRes does not work with bitmaps that have more than 256 colors. For bitmaps with more than 256 colors (8bpp), this function returns an instance of the original bitmap without color modifications.