CMdaBitmapScaler Class Reference

#include <mdaimageconverter.h>

Link against: mediaclientimage.lib

class CMdaBitmapScaler : public CBase

Inherits from

CMdaBitmapScaler

Public Member Functions
virtual	~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()

Detailed Description

Deprecated

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

Constructor & Destructor Documentation

~CMdaBitmapScaler ( )

IMPORT_C

~CMdaBitmapScaler

(

)

[virtual]

Default destructor.

Frees all associated resources.

Member Function 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.

Returns: A pointer to the new image scaler object.

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.

Parameter	Description
aObserver	The image utility observer interface.
aSrcBitmap	The bitmap to be re-scaled.
aTgtBitmap	The target location for the re-scaled bitmap.
aMaintainAspectRatio	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.

Parameter	Description
aObserver	The image utility observer interface.
aBitmap	The bitmap to be re-scaled. This reference is also the target location for the re-scaled bitmap.
aDestSize	The requested target size for the re-scaled bitmap.
aMaintainAspectRatio	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.