LBitmapBase::LBitmapBase

Summary

Constructs and initializes the member variables of the class object.

Syntax

LBitmapBase::LBitmapBase()

LBitmapBase::LBitmapBase(uWidth, uHeight, uBitsPerPixel=24, uOrder=ORDER_BGR, pPalette=NULL, uViewPerspective=TOP_LEFT, crFill=0, uMemory=TYPE_CONV, pData=NULL, dwSize=0)

LBitmapBase::LBitmapBase(pInfo, pBits)

LBitmapBase::LBitmapBase(hDC, hBitmap, hPalette)

LBitmapBase::LBitmapBase(pBitmapHandle)

Parameters

L_UINT uWidth

The desired initial bitmap width.

L_UINT uHeight

The desired initial bitmap height.

L_UINT uBitsPerPixel

The number of bits per pixel. Valid values are 0, 1, 4, 8, 12, 16, 24, and 32. Use 0 to create an 8-bit grayscale bitmap. If uBitsPerPixel is 0, the function ignores the uOrder and pPalette parameters.

L_UINT uOrder

Color order for 16-, 24-, and 32-bit bitmaps. If the resultant bitmap is less than 16 bits per pixel, this will have no effect since palletized images have no order. Possible values are:

LPRGBQUAD pPalette

Pointer to the palette that the bitmap will use. You can specify your own palette, or use NULL to use LEAD's fixed palette.

L_UINT uViewPerspective

The desired view perspective for the bitmap. Possible values are:

COLORREF crFill

The color value to use to fill the bitmap after creating it.

L_UINT uMemory

Flag that indicates the type of memory to allocate. Possible values are:

BITMAPINFO * pInfo

Pointer to a BITMAPINFO structure that describes the bitmap data.

L_UCHAR * pBits

Pointer to the bitmap data to be used in initializing the bitmap.

HDC hDC

Handle to a windows DC.

HBITMAP hBitmap

Handle to a device dependent bitmap (DDB) of type HBITMAP.

HPALETTE hPalette

Handle of the palette to be used for the bitmap or NULL if the bitmap does not have a palette.

pBITMAPHANDLE pBitmapHandle

Pointer to a LEAD bitmap handle that describes an allocated bitmap.

L_UCHAR *pData

Data pointer that will contain the bitmap data when uMemory is TYPE_USER. If pData is NULL, the data pointer must be passed later, by calling LBitmapBase::SetDataPointer, before the bitmap can be used.

L_UINT32 dwSize

Size of the data buffer pointed to by pData. This should be at least pBitmap->Size. This parameter is only valid when uMemory is set to TYPE_USER.

Returns

None.

Comments

These are the constructors for the LBitmapBase class. They construct and initialize the member variables of the class object.

LBitmapBase::LBitmapBase(void) will initialize the bitmap width, height, and bits per pixel to 0.

LBitmapBase::LBitmapBase(uWidth, uHeight, uBitsPerPixel, uOrder, pPalette, uViewPerspective, crFill, uMemory) constructs an LBitmapBase object and allocates a bitmap with the desired width, height, bits per pixel, color order, view perspective and memory type. You can check for successful allocation by calling the LBitmapBase::IsAllocated() member function. Even if the allocation fails, the class object is still constructed.

LBitmapBase::LBitmapBase(pInfo, pBits) constructs an LBitmapBase object and allocates a bitmap using the passed bitmap info and data (DIB). You can check for successful allocation by calling the LBitmapBase::IsAllocated() member function. Even if the allocation fails, the class object is still constructed.

LBitmapBase::LBitmapBase(hDC, hBitmap, hPalette) constructs an LBitmapBase object and allocates a bitmap using the passed hBitmap (DDB). You can check for successful allocation by calling the LBitmapBase::IsAllocated() member function. Even if the allocation fails, the class object is still constructed.

LBitmapBase::LBitmapBase(pBitmapHandle) constructs an LBitmapBase object and allocates a bitmap from another LEAD bitmap handle. You can check for successful allocation by calling the LBitmapBase::IsAllocated() member function. Even if the allocation fails, the class object is still constructed.

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.

See Also

Functions

• LBitmapBase::~LBitmapBase
• LBitmapBase::IsAllocated
• Class Members

Topics

• Using Color Values in LEADTOOLS

Example

This is the example for LBitmapBase::LBitmapBase():
this will call the default constructor and destructor when it is out of scope

L_INT LBitmapBase__LBitmapBaseFirstExample() 
{ 
    
   LBitmapBase MyBitmap; 
 
   return SUCCESS; 
} 
 
/*This is the example for LBitmapBase::LBitmapBase(uWidth, uHeight, uBitsPerPixel, uOrde, pPalette, uViewPerspective, crFill, uMemory, pData, dwSize):*/ 
L_INT LBitmapBase__LBitmapBaseSecondExample() 
{ 
   LBitmapBase      MyBitmap(100, 200, 24, ORDER_BGR, NULL, TOP_LEFT, 0, TYPE_CONV); 
   if(MyBitmap.IsAllocated()) 
   { 
      //   Do something 
   } 
 
   return SUCCESS; 
} 
 
/*This is the example for LBitmapBase::LBitmapBase(pInfo, pBits):*/ 
L_INT LBitmapBase__LBitmapBaseThirdExample() 
{ 
   LBitmapBase TmpBitmap;     
   HGLOBAL hDIB; 
   BITMAPINFO   *pInfo; 
   L_UCHAR  *pBits;      
   L_INT nColorData;   
   L_INT nRet; 
 
   // Load a bitmap at 8 bits per pixel so that we can demonstrate palette handling  
   nRet =TmpBitmap.Load (MAKE_IMAGE_PATH(TEXT("ImageProcessingDemo\\Image3.cmp")), 8, ORDER_BGR); 
   if(nRet !=SUCCESS) 
      return nRet; 
   hDIB = TmpBitmap.ConvertToDIB(DIB_BITMAPV5HEADER); 
 
   pInfo = (BITMAPINFO  *) GlobalLock( hDIB ); 
   if(pInfo->bmiHeader.biBitCount <= 8) 
      nColorData = 1 << pInfo->bmiHeader.biBitCount; 
   else 
      nColorData = 0; 
 
   pBits = (L_UCHAR  *) pInfo + sizeof(BITMAPINFOHEADER) + (nColorData * sizeof(RGBQUAD)); 
 
   LBitmapBase MyBitmap(pInfo, pBits); 
 
   GlobalUnlock(hDIB) ; 
   GlobalFree(hDIB); 
   nRet =TmpBitmap.Free(); 
   if(nRet !=SUCCESS) 
      return nRet; 
 
   return SUCCESS; 
} 
 
/*This is the example for LBitmapBase::LBitmapBase(hDC, hBitmap, hPalette):*/ 
L_INT LBitmapBase__LBitmapBaseForthExample(HINSTANCE hAppInstance) 
{ 
   HBITMAP    hBitmap=LoadBitmap(hAppInstance,MAKE_IMAGE_PATH(TEXT("ULAY1.BMP"))); 
   HDC       hDC=GetDC(0); 
   LBitmapBase    MyBitmap(hDC, hBitmap, 0); 
   ReleaseDC(0,hDC); 
 
   return SUCCESS; 
} 
 
/*This is the example for LBitmapBase::LBitmapBase(pBitmapHandle):*/ 
L_INT LBitmapBase__LBitmapBaseFifthExample() 
{ 
   L_INT nRet; 
   BITMAPHANDLE hBitmap; 
    
   nRet = L_LoadBitmap(MAKE_IMAGE_PATH(TEXT("image1.cmp")), &hBitmap,sizeof(hBitmap), 0, ORDER_RGB,NULL,NULL); 
   if(nRet !=SUCCESS) 
      return nRet; 
   LBitmapBase MyBitmap(&hBitmap); 
 
   return SUCCESS; 
}