L_TranslateBitmapColor

#include "l_bitmap.h"

COLORREF EXT_FUNCTION L_TranslateBitmapColor(pBitmapDst, pBitmapSrc, crColor)

pBITMAPHANDLE pBitmapDst;	/* pointer to the destination bitmap handle */
pBITMAPHANDLE pBitmapSrc;	/* pointer to the source bitmap handle */
COLORREF crColor;	/* color in the source bitmap */

Translates the specified color in the source bitmap, and returns the nearest matching color in the destination bitmap.

Parameter	Description
pBitmapDst	Pointer to the bitmap handle referencing the destination bitmap.
pBitmapSrc	Pointer to the bitmap handle referencing the source bitmap.
crColor	The COLORREF value that specifies the color in the source bitmap to be translated. You can get the value from a palette entry or by using L_GetPixelColor.

Returns

The COLORREF value or the palette index of the nearest matching color in the destination bitmap. If the destination bitmap is 8 bits per pixel or less, this is always the palette index. Otherwise, it is the COLORREF value.

Comments

When creating a target bitmap for animation, you can use this function to ensure that the correct color is specified as the background color.

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 95 / 98 / Me, Windows 2000 / XP, Windows CE.

See Also

Functions:	L_GetBitmapColors, L_PutBitmapColors, L_DupPalette
Topics:	Raster Image Functions: Creating and Maintaining Lists of Images
	Raster Image Functions: Palettes
	Color Resolution and Dithering
	Implementing Animation
	Using Color Values in LEADTOOLS

Example

For a short example, refer to L_GetBitmapListItem. For complete sample code, refer to the CHILD.C module of the DEMO example.