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 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
|
Elements: |
LBitmapBase::Resample, LBitmapBase::Resize, LBuffer::StartResize, LBuffer::Resize, LBuffer::StopResize, Class Members |
|
Topics: |
|
|
|
|
|
|
|
|
|
Example
LBitmapBase MyBitmap;
MyBitmap.Load(TEXT("Image1.cmp"));
MyBitmap.Size(100,100); /*change the size of the bitmap object to 100x100 */
MyBitmap.Free();