Symbian Developer Library

SYMBIAN OS V6.1 EDITION FOR C++

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



Location: MdaImageConverter.h
Link against: MediaClientImage.lib

Class CMdaImageBitmapToFileUtility

CMdaImageBitmapToFileUtility

Support

Supported from 5.0

Description

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

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

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
CMdaImageBitmapToFileUtilityImplements format conversion of a bitmap to a file-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 CMdaImageBitmapToFileUtility:
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 file-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 file-based image conversion utility.

[Top]


Creating


CreateL()

void CreateL(const TDesC& aFileName,TMdaClipFormat* aFormat, TMdaPackage* aCodec, TMdaPackage* aExtra);

Description

Creates a new file to receive the file-based image.

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

The file must be have been created before any conversion operation can start. Note, however, that the file will expand to accommodate the data; i.e. image data is not truncated if the original size of the file is too small.

Parameters

const TDesC& aFileName

The full path name of the file to be created.

TMdaClipFormat* aFormat

The data format.

TMdaPackage* aCodec

The codec to use.

TMdaPackage* aExtra

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