CFrameImageData Class Reference

#include <icl/imagedata.h>

Link against: imageconversion.lib

class CFrameImageData : public CBase

Inherits from

CFrameImageData

Public Member Functions
	~CFrameImageData()
IMPORT_C CFrameImageData *	AllocL()
IMPORT_C TInt	AppendFrameData(const TFrameDataBlock *)
IMPORT_C TInt	AppendImageBuffer(const HBufC8 *)
IMPORT_C TInt	AppendImageData(const TImageDataBlock *)
IMPORT_C TInt	FrameDataCount()
IMPORT_C const TFrameDataBlock *	GetFrameData(TInt)
IMPORT_C TFrameDataBlock *	GetFrameData(TInt)
IMPORT_C const TImageDataBlock *	GetImageData(TInt)
IMPORT_C TImageDataBlock *	GetImageData(TInt)
IMPORT_C TInt	ImageDataCount()
IMPORT_C TInt	InsertFrameData(const TFrameDataBlock *, TInt)
IMPORT_C TInt	InsertImageData(const TImageDataBlock *, TInt)
IMPORT_C CFrameImageData *	NewL()
IMPORT_C CFrameImageData *	NewL(CImageDataArray &, TBool)
IMPORT_C void	RemoveFrameData(TInt)
IMPORT_C void	RemoveImageData(TInt)

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

Class to manage lists of frame and image block data.

Constructor & Destructor Documentation

~CFrameImageData ( )

IMPORT_C

~CFrameImageData

(

)

Destructor for this class.

If ownership of the image data was transfered, it is now destroyed.

Member Function Documentation

AllocL ( )

IMPORT_C CFrameImageData *

AllocL

(

)

const

Creates a full copy of the objects data. Ownership is transferred to the caller.

Returns: A pointer to the new copy of the frame data.

AppendFrameData ( const TFrameDataBlock * )

IMPORT_C TInt

AppendFrameData

(

const TFrameDataBlock *

aEntry

)

Adds a pointer to a frame data block to the end of the internally held list.

Parameter	Description
aEntry	The frame data block pointer to be inserted.

Returns: An error code indicating if the function call was successful. KErrNone on success, otherwise another of the system-wide error codes.

AppendImageBuffer ( const HBufC8 * )

IMPORT_C TInt

AppendImageBuffer

(

const HBufC8 *

aImageBuffer

)

Stores the supplied image data in a newly allocated entry in the image buffer array.

Parameter	Description
aImageBuffer	The HBufC8 pointer to take ownership of.

Returns: An error code indicating if the function call was successful. KErrNone on success, otherwise another of the system-wide error codes.

AppendImageData ( const TImageDataBlock * )

IMPORT_C TInt

AppendImageData

(

const TImageDataBlock *

aEntry

)

Adds a pointer to an image data block to the end of the internally held list.

Parameter	Description
aEntry	The image data block pointer to be inserted.

Returns: An error code indicating if the function call was successful. KErrNone on success, otherwise another of the system-wide error codes.

FrameDataCount ( )

IMPORT_C TInt

FrameDataCount

(

)

const

Returns the number of frame data blocks in the internally held list.

Returns: The number of image data blocks.

GetFrameData ( TInt )

IMPORT_C const TFrameDataBlock *

GetFrameData

(

TInt

aIndex

)

const

Const version.

Returns the frame data block at the given position from the internally held list.

Parameter	Description
aIndex	The position of the frame data block to retrieve. Must be in the range 0 to FrameDataCount().

Returns: A pointer to the image data block.

GetFrameData ( TInt )

IMPORT_C TFrameDataBlock *

GetFrameData

(

TInt

aIndex

)

Non const version.

Returns the frame data block at the given position from the internally held list.

Parameter	Description
aIndex	The position of the frame data block to retrieve. Must be in the range 0 to FrameDataCount().

Returns: A pointer to the image data block.

GetImageData ( TInt )

IMPORT_C const TImageDataBlock *

GetImageData

(

TInt

aIndex

)

const

Returns the image data block at the given position from the internally held list.

Parameter	Description
aIndex	The position of the image data block to retrieve. Must be in the range 0 to ImageDataCount().

Returns: A pointer to the image data block.

GetImageData ( TInt )

IMPORT_C TImageDataBlock *

GetImageData

(

TInt

aIndex

)

Returns the image data block at the given position from the internally held list.

Parameter	Description
aIndex	The position of the image data block to retrieve. Must be in the range 0 to ImageDataCount().

Returns: A pointer to the image data block.

ImageDataCount ( )

IMPORT_C TInt

ImageDataCount

(

)

const

Returns the number of image data blocks in the internally held list.

Returns: The number of image data blocks.

InsertFrameData ( const TFrameDataBlock *, TInt )

IMPORT_C TInt	InsertFrameData	(	const TFrameDataBlock *	aEntry,
			TInt	aPos
		)

Inserts a pointer to a frame data block into the internally held list in front of the item at position aPos.

Parameter	Description
aEntry	The frame data block pointer to be inserted.
aPos	The position at which to insert the pointer into the internal list. Must not be less than 0 or greater than the value returned by CFrameImageData::FrameDataCount().

Returns: An error code indicating if the function call was successful. KErrNone on success, otherwise another of the system-wide error codes.

InsertImageData ( const TImageDataBlock *, TInt )

IMPORT_C TInt	InsertImageData	(	const TImageDataBlock *	aEntry,
			TInt	aPos
		)

Inserts a pointer to an image data block into the internally held list in front of the item at position aPos.

Parameter	Description
aEntry	The image data block pointer to be inserted.
aPos	The position at which to insert the pointer into the internal list. Must not be less than 0 or greater than the value returned by CFrameImageData::ImageDataCount().

Returns: An error code indicating if the function call was successful. KErrNone on success, otherwise another of the system-wide error codes.

NewL ( )

IMPORT_C CFrameImageData *

NewL

(

)

[static]

Static factory function for creating instances of CFrameImageData. The managed list of image data is created/destroyed internally.

Returns: A pointer to a fully constructed CFrameImageData.

NewL ( CImageDataArray &, TBool )

IMPORT_C CFrameImageData *	NewL	(	CImageDataArray &	aImageData,
			TBool	aImageDataOwner = EFalse
		)	[static]

Static factory function for creating instances of CFrameImageData.

The managed list of image data is created internally. If a data owner is specified then the responsibility for destroying the managed list is that of the owner. If no owner is specified the managed list is destroyed internally.

Parameter	Description
aImageData	A reference to an externally created CImageDataArray.
aImageDataOwner	If set to true, responsibility for deleting CImageDataArray is passed to the CFrameImageData object.

Returns: A pointer to a fully constructed CFrameImageData.

RemoveFrameData ( TInt )

IMPORT_C void

RemoveFrameData

(

TInt

aIndex

)

Removes a pointer to a frame data block at position aIndex from the internally held list.

Parameter	Description
aIndex	Position of the pointer to delete. Must not be less than 0 or greater than the value returned by CFrameImageData::ImageDataCount().

RemoveImageData ( TInt )

IMPORT_C void

RemoveImageData

(

TInt

aIndex

)

Removes a pointer to an image data block at position aIndex from the internally held list.

Parameter	Description
aIndex	The index into the list. Must not be less than 0 or greater than the value returned by CFrameImageData::ImageDataCount().