L_CreatePaintPalette

#include "l_bitmap.h"

L_LTDIS_API L_HPALETTE L_CreatePaintPalette(hDC, pBitmap)

L_HDC hDC;

device context that is used

pBITMAPHANDLE pBitmap;

pointer to the LEAD bitmap handle

Returns a palette handle that must be selected and realized before calling the L_PaintDC function.

Parameter

Description

hDC

Device context that is used.

pBitmap

Pointer to the LEAD bitmap handle that references the image data.

Returns

> 0

Palette handle.

NULL

No palette needed.

Comments

You must use this function if either the display device or the bitmap is 8 bits per pixel or less. You can use this function whenever the bitmap or device changes, and check the return value to decide whether to select and realize the palette. If the return value is NULL, no palette needs to be selected.

You must also call this function before calling L_PaintDC, when painting a 16-bit grayscale image on a 24-bit device.

You must delete the palette handle when it is no longer needed.

GDI+ paint does not require a palette. If the current paint display mode is set to GDI+ using L_SetDisplayMode with the DISPLAYMODE_GDIPLUS flag, then this function will always return NULL for the palette even if the bitmap is 8 bits per pixel or less.

Required DLLs and Libraries

LTDIS

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_GetBitmapColors, L_PutBitmapColors, L_DupPalette,

 

L_PaintDC

Topics:

Raster Image Functions: Displaying Images

 

Handling Palette Changes

Example

For a short example, refer to L_PaintDC. For complete sample code, refer to the COLOR example.

Help Version 20.0.2018.2.25
Products | Support | Contact Us | Copyright Notices
© 1991-2018 LEAD Technologies, Inc. All Rights Reserved.
LEADTOOLS Raster Imaging C API Help