L_DupBitmapPalette

#include "l_bitmap.h"

L_LTKRN_API L_HPALETTE L_DupBitmapPalette(pBitmap)

pBITMAPHANDLE pBitmap;

/* pointer to the bitmap handle */

Creates a Windows HPALETTE from the specified bitmaps palette.

Parameter

Description

pBitmap

Pointer to the bitmap whose palette is to be duplicated.

Returns

Handle of the palette that is created.

Comments

This function does not support signed data images. It returns the error code ERROR_SIGNED_DATA_NOT_SUPPORTED if a signed data image is passed to this function.

The bitmap must be 8-bit or less in order to have a valid palette.

The palette returned by this function must be destroyed using the Windows API DeleteObject() when it is no longer needed.

Required DLLs and Libraries

LTKRN

For a listing of the exact DLLs and Libraries needed, based on the toolkit version, refer to Files To Be Included With Your Application.

Platforms

Windows 2000 / XP/Vista, Windows CE.

See Also

Functions:

L_GetFixedPalette, L_ColorResBitmap, L_CreatePaintPalette, L_GetBitmapColors, L_PutBitmapColors, L_DupPalette, L_SetBitmapPalette

Topics:

Raster Image Functions: Displaying Images

 

Handling Palette Changes

Example

For an example, refer to L_ChangeToDDB.