In This Topic ▼

LBitmapBase::TranslateColor

Summary

Translates the specified color in the source class object's bitmap, and returns the nearest matching color in the calling object's bitmap.

Syntax

#include "ltwrappr.h"

virtual COLORREF LBitmapBase::TranslateColor(LBitmapSrc, crColor)

Parameters

LBitmapBase& LBitmapSrc

The source bitmap object.

COLORREF 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 LBitmapBase::GetPixelColor.

Returns

The COLORREF value or the palette index of the nearest matching color in calling object's bitmap. If the calling object's 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.

Note: The LBitmapSrc parameter is passed by reference, and is a required parameter.

Required DLLs and Libraries

LTDIS
LTFIL
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.

Example

L_INT LBitmapBase__TranslateColorExample() 
{ 
   L_INT nRet; 
 
   LBitmapBase MyBitmap, Bitmap2; 
   MyBitmap.SetFileName(MAKE_IMAGE_PATH(TEXT("image1.cmp"))); 
   nRet =MyBitmap.Load(32);  //load at 32 bit per pixel 
   if(nRet != SUCCESS ) 
      return nRet; 
 
   COLORREF Color=MyBitmap.GetPixelColor(100,200); 
   nRet =Bitmap2.Load(MAKE_IMAGE_PATH(TEXT("image2.cmp"))); 
   if(nRet !=SUCCESS) 
      return nRet; 
 
   Color=MyBitmap.TranslateColor(Bitmap2, Color); 
 
 
   return SUCCESS; 
}