L_DupBitmapPalette (original) (raw)

Summary

Creates a Windows HPALETTE from the specified bitmaps palette.

Syntax

#include "l_bitmap.h"

L_LTKRN_API L_HPALETTE L_DupBitmapPalette(pBitmap)

Parameters

pBITMAPHANDLE 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 C 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

Win32, x64, Linux.

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.

LEADTOOLS Raster Imaging C API Help