LBitmapBase::Size

#include "ltwrappr.h"

virtual L_INT LBitmapBase::Size(nWidth, nHeight, uFlags=SIZE_NORMAL)

L_INT nWidth;

/* new width of the bitmap in pixels */

L_INT nHeight;

/* new height of the bitmap in pixels */

L_UINT32 uFlags;

/* flag that indicates how to resize */

Resizes the class object's bitmap to a new width and height.

Parameter

Description

nWidth

New width of the bitmap in pixels.

nHeight

New height of the bitmap in pixels.

uFlags

Flag that indicates how to resize the bitmap. Possible values are:

 

Value

Meaning

 

SIZE_NORMAL

[0x0000] Resize normally.

 

SIZE_FAVORBLACK

[0x0001] (Document/Medical only) Preserve black objects when making the image smaller. This option affects only 1-bit, black-and-white images, where it prevents the disappearance of thin lines. You can use a bitwise OR ( | ) to combine this flag with another one. For example, SIZE_RESAMPLE | SIZE_FAVORBLACK causes color images to be resampled, but applies the favor-black option to 1-bit, black-and-white images.

 

SIZE_RESAMPLE

[0x0002] Use interpolation and averaging to produce a higher quality image.

 

SIZE_BICUBIC

[0x0004] Use bicubic interpolation and averaging to produce a higher quality image. This is slower than SIZE_RESAMPLE.

Returns

SUCCESS

The function was successful.

< 1

An error occurred. Refer to Return Codes.

Comments

Call this function to change the size of the class object's bitmap.

This function keeps the same bitmap handle and resizes the bitmap that it references. If you want to keep the original-size bitmap along with the resized bitmap, use the LBitmapBase::Resize function.

To update a status bar or detect a user interrupt during execution of this function, refer to LBase::EnableStatusCallBack.

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:

LBitmapBase::Resize, LBuffer::StartResize, LBuffer::Resize, LBuffer::StopResize, LBitmapBase::SizeInterpolate, Class Members

Topics:

Raster Image Functions: Doing Geometric Transformations

 

Resizing Considerations

 

Processing an Image

 

Raster Image Functions: Processing an Image

Example

L_INT LBitmapBase__SizeExample()
{
   L_INT nRet;
   LBitmapBase MyBitmap;
   nRet =MyBitmap.Load(TEXT("%UserProfile%\\My Documents\\LEADTOOLS Images\\Image1.cmp"));
   if(nRet !=SUCCESS)
      return nRet;
   nRet =MyBitmap.Size(100,100);
   if(nRet !=SUCCESS)
      return nRet;/*change the size of the bitmap object to 100x100  */
   
   nRet =MyBitmap.Free();
   if(nRet !=SUCCESS)
      return nRet;
   return SUCCESS;
}