Symbian Developer Library

SYMBIAN OS V6.1 EDITION FOR C++

[Index] [Glossary] [Previous] [Next]



Location: MdaImageConverter.h
Link against: MediaClientImage.lib

Class CMdaImageBitmapToDescUtility

CMdaImageBitmapToDescUtility

Support

Supported from 5.0

Description

Implements format conversion of a bitmap to a descriptor-based image.

The class provides functions to create an instance of this conversion utility and to initialise the descriptor.

Conversion is performed using the image conversion utility interface.

Derivation

CActiveThe core class of the active object abstraction
CBaseBase class for all classes to be instantiated on the heap
CMdaImageBitmapToDescUtilityImplements format conversion of a bitmap to a descriptor-based image
CMdaImageDataWriteUtilityBase class used in the derivation of CMdaImageBitmapToDescUtility and CMdaImageBitmapToFileUtility
CMdaImageUtilityThe abstract base class for the image conversion utilities
CMdaResourceBase class used in the derivation of CMdaImageUtility
MMdaObjectStateChangeObserverAn interface class for handling the change of state of an audio data sample object

Defined in CMdaImageBitmapToDescUtility:
CreateL(), NewL()

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

Inherited from CBase:
operator new()

Inherited from CMdaImageUtility:
CancelConvertL(), Close(), ConvertL(), FrameCount(), FrameInfo()

Inherited from MMdaObjectStateChangeObserver:
MoscoStateChangeEvent()


Construction


NewL()

static CMdaImageBitmapToFileUtility* NewL(MMdaImageUtilObserver& aObserver,CMdaServer* aServer = NULL);

Description

Constructs a new instance of the bitmap to descriptor-based image conversion utility.

The function leaves if this object cannot be created.

Parameters

MMdaImageUtilObserver& aObserver

The image utility observer interface

CMdaServer* aServer = NULL

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

CMdaImageBitmapToFileUtility*

Pointer to the new instance of the bitmap to descriptor-based image conversion utility.

[Top]


Creating


CreateL()

void CreateL(TDes8& aDescriptor,TMdaClipFormat* aFormat,TMdaPackage* aCodec,TMdaPackage* aExtra);

Description

Initialises the supplied descriptor to receive the descriptor-based image.

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

The descriptor must have been successfully initialised before any conversion operation can start.

Parameters

TDes8& aDescriptor

A descriptor to contain the image.

TMdaClipFormat* aFormat

The data format. This is optional.

TMdaPackage* aCodec

The codec to use. This is optional.

TMdaPackage* aExtra

Additional information which the Media Server may need to recognise the data format. This is optional.