In This Topic ▼

L_ConvertFromDDB

Summary

Converts a Windows device dependent bitmap (DDB) into a LEAD Technologies bitmap. When this function is completed, there are two copies of the image in memory: the original DDB and the LEAD bitmap. Freeing one will not affect the other.

Syntax

#include "l_bitmap.h"

L_LTDIS_API L_INT L_ConvertFromDDB(hDC, pBitmap, uStructSize, hBitmap, hPalette)

Parameters

L_HDC hDC

Handle to the device responsible for the conversion. The mapping mode of the device context must be MM_TEXT.

pBITMAPHANDLE pBitmap

Pointer to the bitmap handle referencing the target LEAD bitmap.

L_UINT uStructSize

Size in bytes, of the structure pointed to by pBitmap, for versioning. Use sizeof(BITMAPHANDLE).

L_HBITMAP hBitmap

Handle to the DDB to be converted.

L_HPALETTE hPalette

Handle to the palette. This value can be NULL if the hDC parameter refers to a device that is greater than 8 bits, or if the bitmap will use the system palette.

Returns

Value	Meaning
SUCCESS	The function was successful.
< 1	An error occurred. Refer to Return Codes.

Comments

This function updates information in the bitmap handle and copies the DDB image data into the LEAD bitmap.

Before calling this function, you must declare the LEAD bitmap handle and initialize it, specifying a height and width of 0. However, you should not allocate the bitmap. (If the bitmap is already allocated, you must free it and initialize the bitmap handle again.)