Collapse all Symbian^3 Product Developer Library

CMdaBitmapScaler Class Reference

class CMdaBitmapScaler : public CBase

Re-scales a bitmap.

Replaced by Image Conversion library - see CBitmapScaler

The class offers a simple interface to perform arbitrary re-scaling of a bitmap.

Since: 5.0

CBitmapScaler

Inherits from

CMdaBitmapScaler
- CBase

Public Member Functions
	~CMdaBitmapScaler()
IMPORT_C void	CancelScaling()
IMPORT_C CMdaBitmapScaler *	NewL()
IMPORT_C void	ScaleL(MMdaImageUtilObserver &, CFbsBitmap &, CFbsBitmap &, TBool)
IMPORT_C void	ScaleL(MMdaImageUtilObserver &, CFbsBitmap &, TSize, TBool)

Inherited Functions
	CBase::CBase()
	CBase::Delete(CBase *)
	CBase::Extension_(TUint,TAny &,TAny )
	CBase::operator new(TUint)
	CBase::operator new(TUint,TAny *)
	CBase::operator new(TUint,TLeave)
	CBase::operator new(TUint,TLeave,TUint)
	CBase::operator new(TUint,TUint)
	CBase::~CBase()

Private Attributes
CMdaBitmapScalerPriv *	iProperties

Constructor & Destructor Documentation

~CMdaBitmapScaler()

IMPORT_C

~CMdaBitmapScaler

(

)

[virtual]

Default destructor.

Frees all associated resources.

Member Functions Documentation

CancelScaling()

IMPORT_C void

CancelScaling

(

)

Cancels the bitmap re-scaling operation.

The observer callback function MMdaImageUtilObserver::MiuoConvertComplete() is not called.

NewL()

IMPORT_C CMdaBitmapScaler *

NewL

(

)

[static]

Constructs and initialises a new instance of the image scaler.

The function leaves if the image scaler object cannot be created.

ScaleL(MMdaImageUtilObserver &, CFbsBitmap &, CFbsBitmap &, TBool)

IMPORT_C void	ScaleL	(	MMdaImageUtilObserver &	aObserver,
			CFbsBitmap &	aSrcBitmap,
			CFbsBitmap &	aTgtBitmap,
			TBool	aMaintainAspectRatio = ETrue
		)

Begins the bitmap re-scaling operation.

The scaling factor is based on the relative sizes of the source and target bitmaps. The operation is asynchronous.

When it is completed, successfully or otherwise, the callback function MMdaImageUtilObserver::MiuoConvertComplete() is called, passing the state of the operation.

Parameters

MMdaImageUtilObserver & aObserver	The image utility observer interface.
CFbsBitmap & aSrcBitmap	The bitmap to be re-scaled.
CFbsBitmap & aTgtBitmap	The target location for the re-scaled bitmap.
TBool aMaintainAspectRatio = ETrue	ETrue - the aspect ratio is retained; this is the default. The same scaling factor is applied in both the horizontal and vertical directions. This is the smaller of the horizontal scaling factor and the vertical scaling factor. EFalse - the aspect ratio need not be retained.

ScaleL(MMdaImageUtilObserver &, CFbsBitmap &, TSize, TBool)

IMPORT_C void	ScaleL	(	MMdaImageUtilObserver &	aObserver,
			CFbsBitmap &	aBitmap,
			TSize	aDestSize,
			TBool	aMaintainAspectRatio = ETrue
		)

Begins the bitmap re-scaling operation.

The scaling factor is based on the relative value of the source bitmap size and the explicitly supplied size. The operation is asynchronous. When it is complete, successfully or otherwise, the callback function MMdaImageUtilObserver::MiuoConvertComplete() is called, passing the state of the operation.

Parameters

MMdaImageUtilObserver & aObserver	The image utility observer interface.
CFbsBitmap & aBitmap	The bitmap to be re-scaled. This reference is also the target location for the re-scaled bitmap.
TSize aDestSize	The requested target size for the re-scaled bitmap.
TBool aMaintainAspectRatio = ETrue	ETrue - the aspect ratio is retained; this is the default. The same scaling factor is applied in both the horizontal and vertical directions. This is the smaller of the horizontal scaling factor and the vertical scaling factor. EFalse - the aspect ratio need not be retained.

Member Data Documentation

CMdaBitmapScalerPriv * iProperties

CMdaBitmapScalerPriv *

iProperties

[private]