Collapse all Symbian^3 Product Developer Library

TFrameLayout Class Reference

class TFrameLayout : public TFrameLayoutBase

Class TFrameLayout is a concrete implementation of TFrameLayoutBase class. It serves as a container for parameters that describe the memory organisation of the data encapsulated by a specific CImageFrame object. Image data is stored in planes. Each plane is characterised by the byte offset from the start of the image frame memory, and its maximum size, current length and scanlength.

Inherits from

TFrameLayout
- TFrameLayoutBase

Public Member Functions
	TFrameLayout(TInt)
IMPORT_C TInt	CurrentLength(TInt)
IMPORT_C TFrameLayoutBase *	DuplicateL()
IMPORT_C TInt	Length(TInt)
IMPORT_C TInt	Planes()
IMPORT_C TInt	ScanLength(TInt)
IMPORT_C void	SetCurrentLength(TInt, TInt)
IMPORT_C void	SetLength(TInt, TInt)
IMPORT_C void	SetScanLength(TInt, TInt)
IMPORT_C void	SetStart(TInt, TInt)
IMPORT_C TInt	Start(TInt)

Inherited Functions
	TFrameLayoutBase::TFrameLayoutBase(TUid)
	TFrameLayoutBase::Type()const

Private Attributes
TInt	iCurrentLength
TInt	iLength
TInt	iPlanes
TInt	iScanLength
TInt	iStart

Constructor & Destructor Documentation

TFrameLayout(TInt)

IMPORT_C

TFrameLayout

(

TInt

aPlanes

)

[explicit]

Constructor for the TFrameLayout class.

panic: EInvalidValue if the value of aPlanes is negative or greater than KMaxPlanesInFrame.

imageframeconst.h

Parameters

TInt aPlanes

The number of planes into which the image data is organised. It should be a positive integer less than or equal to KMaxPlanesInFrame (defined in imageframeconst.h).

Member Functions Documentation

CurrentLength(TInt)

IMPORT_C TInt

CurrentLength

(

TInt

aIndex

)

const

Returns the current length in bytes of a specific plane.

panic: EInvalidIndex if the index is not in the allowed range.

Parameters

TInt aIndex

The index of the plane. The value is non negative and must be less than the value returned by TFrameLayout::Planes().

DuplicateL()

IMPORT_C TFrameLayoutBase *

DuplicateL

(

)

const [virtual]

Creates an identical object to itself and places it on the heap.

leave: KErrNoMemory.

Length(TInt)

IMPORT_C TInt

Length

(

TInt

aIndex

)

const

Returns the maximum length in bytes of a specific plane.

panic: EInvalidIndex if the index is not in the allowed range.

Parameters

TInt aIndex

The index of the plane. The value is non negative and must be less than the value returned by TFrameLayout::Planes().

Planes()

IMPORT_C TInt

Planes

(

)

const

Returns the number of planes in the current layout.

ScanLength(TInt)

IMPORT_C TInt

ScanLength

(

TInt

aIndex

)

const

Returns the scan length in bytes of a specific plane.

panic: EInvalidIndex if the index is not in the allowed range.

Parameters

TInt aIndex

The index of the plane. The value is non negative and must be less than the value returned by TFrameLayout::Planes().

SetCurrentLength(TInt, TInt)

IMPORT_C void	SetCurrentLength	(	TInt	aIndex,
			TInt	aCurrentLength
		)

Sets the current length for a specific plane in the current layout.

panic: EInvalidIndex if the index is not in the allowed range.

panic: EInvalidValue if the value of aCurrentLength is negative.

Parameters

TInt aIndex	The index of the plane. The value is non negative and must be less than the value returned by TFrameLayout::Planes().
TInt aCurrentLength	The new value for current length in bytes

SetLength(TInt, TInt)

IMPORT_C void	SetLength	(	TInt	aIndex,
			TInt	aLength
		)

Sets the maximum length of a specific plane in the current layout.

panic: EInvalidIndex if the index is not in the allowed range.

panic: EInvalidValue if the value of aLength is negative.

Parameters

TInt aIndex	The index of the plane. The value is non negative and must be less than the value returned by TFrameLayout::Planes().
TInt aLength	The new length in bytes.

SetScanLength(TInt, TInt)

IMPORT_C void	SetScanLength	(	TInt	aIndex,
			TInt	aScanLength
		)

Set a new value for the scan length for a specific plane in the current layout.

panic: EInvalidIndex if the index is not in the allowed range.

panic: EInvalidValue if the value of aScanLength is negative.

Parameters

TInt aIndex	The index of the plane. The value is non negative and must be less than the value returned by TFrameLayout::Planes().
TInt aScanLength	The new value for the scan length of the plane in bytes.

SetStart(TInt, TInt)

IMPORT_C void	SetStart	(	TInt	aIndex,
			TInt	aStart
		)

Sets the start offset for a specific plane in the current layout.

panic: EInvalidIndex if the index is not in the allowed range.

panic: EInvalidValue if the value of aStart is negative.

Parameters

TInt aIndex	The index of the plane. The value is non negative and must be less than the value returned by TFrameLayout::Planes().
TInt aStart	The new start offset position in bytes.

Start(TInt)

IMPORT_C TInt

Start

(

TInt

aIndex

)

const

Returns the start of a plane identified by its index. The value is the byte offset from the start of the CImageFrame object memory.

panic: EInvalidIndex if the index is not in the allowed range.

Parameters

TInt aIndex

The index of the plane. The value is non negative and must be less than the value returned by TFrameLayout::Planes().

Member Data Documentation

TInt iCurrentLength

TInt

iCurrentLength

[private]

TInt iLength

TInt

iLength

[private]

TInt iPlanes

TInt

iPlanes

[private]

TInt iScanLength

TInt

iScanLength

[private]

TInt iStart

TInt

iStart

[private]