Symbian
Symbian OS Library

SYMBIAN OS V9.3

[Index] [Spacer] [Previous] [Next]



Location: mdaimageconverter.h
Link against: mediaclientimage.lib

Class CMdaImageBitmapToBitmapUtility

class CMdaImageBitmapToBitmapUtility : public CMdaImageUtility;

Description

Implements bitmap to bitmap copying and colour depth conversion.

Replaced by Image Conversion library - use CImageEncoder::FileNewL()

Derivation

Members

Defined in CMdaImageBitmapToBitmapUtility:
CancelConvertL(), ConvertL(), ConvertL(), DoCancel(), DoClose(), NewL(), OpenL(), RunL(), ~CMdaImageBitmapToBitmapUtility()

Inherited from CActive:
Cancel(), Deque(), EPriorityHigh, EPriorityIdle, EPriorityLow, EPriorityStandard, EPriorityUserInput, Extension_(), IsActive(), IsAdded(), Priority(), RunError(), SetActive(), SetPriority(), TPriority, iStatus

Inherited from CBase:
Delete(), operator new()

Inherited from CMdaImageUtility:
Close(), FrameCount(), FrameInfo(), ImageUtil_Reserved1(), ImageUtil_Reserved2(), ImageUtil_Reserved3(), ImageUtil_Reserved4(), MoscoStateChangeEvent()

See also:


Construction and destruction


NewL()

static IMPORT_C CMdaImageBitmapToBitmapUtility *NewL(MMdaImageUtilObserver &aObserver, CMdaServer *aServer=0);

Description

Constructs and initialises a new instance of the bitmap converter.

The function leaves if the bitmap converter object cannot be created.

Parameters

MMdaImageUtilObserver &aObserver

The image utility observer interface.

CMdaServer *aServer

A pointer to a server object. The default is NULL which means that one is automatically constructed and owned by this conversion utility object. If not NULL, the client must construct, and be responsible for, the server object. This option may be more efficient if a number of conversion utility objects are to be created.

Return value

CMdaImageBitmapToBitmapUtility *

A pointer to the new bitmap converter object.


~CMdaImageBitmapToBitmapUtility()

IMPORT_C ~CMdaImageBitmapToBitmapUtility();

Description

Destructor.

[Top]


Member functions


OpenL()

IMPORT_C void OpenL(CFbsBitmap &aBitmap);

Description

Opens the bitmap converter utility.

The function is asynchronous. When the open operation is complete, successfully or otherwise, the callback function MMdaImageUtilObserver::MiuoOpenComplete() is called.

The source bitmap must be open before any conversion operation can start.

Parameters

CFbsBitmap &aBitmap

The bitmap to be used as the source for subsequent conversions.


ConvertL()

virtual IMPORT_C void ConvertL(CFbsBitmap &aBitmap, TInt aFrameNumber=0);

Description

Converts a bitmap.

The operation is asynchronous. When the conversion operation is complete, successfully or otherwise, the callback function MMdaImageUtilObserver::MiuoConvertComplete() is called.

Parameters

CFbsBitmap &aBitmap

The destination bitmap.

TInt aFrameNumber

The frame number. This value is relative to zero.


ConvertL()

virtual IMPORT_C void ConvertL(CFbsBitmap &aBitmap, CFbsBitmap &aMaskBitmap, TInt aFrameNumber=0);

Description

Converts a bitmap with a mask. Not supported

Parameters

CFbsBitmap &aBitmap

A reference to the bitmap which is the target of the conversion operation.

CFbsBitmap &aMaskBitmap

The overloaded variant which takes this argument is not supported for bitmap to bitmap conversion. This variant leaves with KErrNotSupported.

TInt aFrameNumber

The frame number. This value is relative to zero.


CancelConvertL()

virtual IMPORT_C void CancelConvertL();

Description

Cancels any conversion in progress.

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


RunL()

virtual void RunL();

Description

Handles an active object's request completion event.

A derived class must provide an implementation to handle the completed request. If appropriate, it may issue another request.

The function is called by the active scheduler when a request completion event occurs, i.e. after the active scheduler's WaitForAnyRequest() function completes.

Before calling this active object's RunL() function, the active scheduler has:

1. decided that this is the highest priority active object with a completed request

2. marked this active object's request as complete (i.e. the request is no longer outstanding)

RunL() runs under a trap harness in the active scheduler. If it leaves, then the active scheduler calls RunError() to handle the leave.

Note that once the active scheduler's Start() function has been called, all user code is run under one of the program's active object's RunL() or RunError() functions.


DoCancel()

virtual void DoCancel();

Description

Implements cancellation of an outstanding request.


DoClose()

protected: virtual void DoClose();

Description