Class CMdaBitmapScaler

Interface status:

deprecated

class CMdaBitmapScaler : public CBase;

Description

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.

Derivation

• CBase - Base class for all classes to be instantiated on the heap.

• CMdaBitmapScaler - Re-scales a bitmap.

Members

Defined in CMdaBitmapScaler:

• CancelScaling()Cancels the bitmap re-scaling operation.
• NewL()Constructs and initialises a new instance of the image scaler.
• ScaleL(MMdaImageUtilObserver &,CFbsBitmap &,CFbsBitmap &,TBool)Begins the bitmap re-scaling operation.
• ScaleL(MMdaImageUtilObserver &,CFbsBitmap &,TSize,TBool)Begins the bitmap re-scaling operation.
• ~CMdaBitmapScaler()Default destructor.

Inherited from CBase:

• Delete(CBase *)Deletes the specified object.
• Extension_(TUint,TAny *&,TAny *)Extension function
• operator new(TUint)Allocates the object from the heap and then initialises its contents to binary z...
• operator new(TUint,TAny *)Initialises the object to binary zeroes.
• operator new(TUint,TLeave)Allocates the object from the heap and then initialises its contents to binary z...
• operator new(TUint,TLeave,TUint)Allocates the object from the heap and then initialises its contents to binary z...
• operator new(TUint,TUint)Allocates the object from the heap and then initialises its contents to binary z...

See also:

• CBitmapScalerThe public API for clients to call the BitmapTransforms Library bitmap scaling.

Interface status:

deprecated

Inherited from: CMdaBitmapScaler

IMPORT_C static CMdaBitmapScaler* NewL();

Description

Constructs and initialises a new instance of the image scaler.

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

Return value

CMdaBitmapScaler * A pointer to the new image scaler object.

Interface status:

deprecated

Inherited from: CMdaBitmapScaler

IMPORT_C virtual ~CMdaBitmapScaler();

Description

Default destructor.

Frees all associated resources.

Interface status:

deprecated

Inherited from: CMdaBitmapScaler

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

Description

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(TInt) 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 - 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.

Interface status:

deprecated

Inherited from: CMdaBitmapScaler

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

Description

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(TInt) 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 - 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.

Interface status:

deprecated

Inherited from: CMdaBitmapScaler

IMPORT_C void CancelScaling();

Description

Cancels the bitmap re-scaling operation.

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