LBitmapBase::HasRgn

#include "ltwrappr.h"

virtual L_BOOL LBitmapBase::HasRgn()

Determines whether the bitmap has a region.

Returns

TRUE

The specified bitmap has a region.

FALSE

The specified bitmap does not have a region.

Comments

When a bitmap has a region, the LEADTOOLS functions that modify the pixel values (for example LBitmap::Posterize) act on the region, rather than the whole bitmap. In addition, the LEADTOOLS functions that flip, reverse, rotate, shear, or resize a bitmap also transform the region to match the bitmap. For example, if you were to shear the bitmap that had a rectangular region, the region would become a parallelogram.

To remove a bitmap region, use the LBitmapRgn::Free function.

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.

See Also

Functions:

Class Members

Topics:

Raster Image Functions: Creating and Using a Region

 

Raster Image Functions: Region Processing

 

Defining and Using a Bitmap Region

Example

L_INT LBitmapBase__HasRgnExample()
{
   L_INT nRet;
   LBitmapBase MyBitmap;
   MyBitmap.SetFileName(TEXT("%UserProfile%\\My Documents\\LEADTOOLS Images\\image1.cmp"));
   nRet =MyBitmap.Load(24);
   if(nRet !=SUCCESS)
      return nRet;
   /*……create a region for the bitmap…..*/
   /*……….*/
   if(MyBitmap.HasRgn())
      nRet = MyBitmap.Free();
   return nRet;
}