Collapse all Symbian^3 Application Developer Library

COverlayTransformExtension Class Reference

class COverlayTransformExtension : public CImageTransformPluginExtension

Overlay/Replace Extension to the ImageTransform plugin

The class provides the methods to set the overlay/replace parameters and is intended to be implemented by the plugins supporting the blending of the images. The client can set the overlay image, the overlay position and the transparency of the overlay image. The plugin supporting this extension must use the opaque_data v2 format in RSS file and also the overlay flag must be set in the opaque_data. The client must retrieve this extension implementation from the plugin using its extension UID.

Inherits from

COverlayTransformExtension
- CImageTransformPluginExtension
  - CBase

Public Member Functions
IMPORT_C void	SetOverlayDataL (const TDesC8 &, const TUid &)
IMPORT_C void	SetOverlayFileL (const TDesC &, const TUid &)
IMPORT_C void	SetOverlayImageL (const CFbsBitmap &)
IMPORT_C void	SetOverlayImageL (const CImageFrame &)
IMPORT_C void	SetPosition (const TPoint &)
IMPORT_C void	SetTransparencyLevelL ( TUint )
IMPORT_C void	SupportedOverlayInputFormatsL ( RArray < TUid > &)
IMPORT_C void	SupportedOverlayInputSubFormatsL ( TUid , RArray < TUid > &)

Protected Member Functions
void	DoSetOverlayDataL (const TDesC8 &, const TUid &)
void	DoSetOverlayFileL (const TDesC &, const TUid &)
void	DoSetOverlayImageL (const CFbsBitmap &)
void	DoSetOverlayImageL (const CImageFrame &)
void	DoSetPosition (const TPoint &)
void	DoSetTransparencyLevelL ( TUint )
void	DoSupportedOverlayInputFormatsL ( RArray < TUid > &)
void	DoSupportedOverlayInputSubFormatsL ( TUid , RArray < TUid > &)

Private Member Functions
IMPORT_C void	ReservedVirtual5 ()

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()
	CImageTransformPluginExtension::Uid()const

Private Attributes
TAny *	iPad

Member Functions Documentation

DoSetOverlayDataL(const TDesC8 &, const TUid &)

void	DoSetOverlayDataL	(	const TDesC8 &	aData,
			const TUid &	aOverlayImageUid
		)	[protected, pure virtual]

Parameters

const TDesC8 & aData
const TUid & aOverlayImageUid

DoSetOverlayFileL(const TDesC &, const TUid &)

void	DoSetOverlayFileL	(	const TDesC &	aFilename,
			const TUid &	aOverlayImageUid
		)	[protected, pure virtual]

Parameters

const TDesC & aFilename
const TUid & aOverlayImageUid

DoSetOverlayImageL(const CFbsBitmap &)

void

DoSetOverlayImageL

(

const CFbsBitmap &

aBitmap

)

[protected, pure virtual]

Parameters

const CFbsBitmap & aBitmap

DoSetOverlayImageL(const CImageFrame &)

void

DoSetOverlayImageL

(

const CImageFrame &

aImageFrame

)

[protected, pure virtual]

Parameters

const CImageFrame & aImageFrame

DoSetPosition(const TPoint &)

void

DoSetPosition

(

const TPoint &

aPosition

)

[protected, pure virtual]

Parameters

const TPoint & aPosition

DoSetTransparencyLevelL(TUint)

void

DoSetTransparencyLevelL

(

TUint

aLevel

)

[protected, pure virtual]

Parameters

TUint aLevel

DoSupportedOverlayInputFormatsL(RArray< TUid > &)

void

DoSupportedOverlayInputFormatsL

(

RArray < TUid > &

aFormats

)

const [protected, pure virtual]

Parameters

RArray < TUid > & aFormats

DoSupportedOverlayInputSubFormatsL(TUid, RArray< TUid > &)

void	DoSupportedOverlayInputSubFormatsL	(	TUid	aFormat,
			RArray < TUid > &	aSubFormats
		)	const [protected, pure virtual]

Parameters

TUid aFormat
RArray < TUid > & aSubFormats

ReservedVirtual5()

IMPORT_C void

ReservedVirtual5

(

)

[private, virtual]

Reserved for future-proofing

SetOverlayDataL(const TDesC8 &, const TUid &)

IMPORT_C void	SetOverlayDataL	(	const TDesC8 &	aData,
			const TUid &	aOverlayImageUid
		)

Sets the Overlay image in the descriptor

leave: KErrNotSupported The plugin does not support this format of the the overlay image file

Parameters

const TDesC8 & aData	The descriptor containing overlay image
const TUid & aOverlayImageUid	The format of the overlay image

SetOverlayFileL(const TDesC &, const TUid &)

IMPORT_C void	SetOverlayFileL	(	const TDesC &	aFilename,
			const TUid &	aOverlayImageUid
		)

Sets the Overlay image in the file

leave: KErrNotSupported The plugin does not support this format of the the overlay image file

Parameters

const TDesC & aFilename	The overlay image filename
const TUid & aOverlayImageUid	The format of the overlay image

SetOverlayImageL(const CFbsBitmap &)

IMPORT_C void

SetOverlayImageL

(

const CFbsBitmap &

aBitmap

)

Sets the Overlay image in the bitmap

leave: KErrNotSupported The plugin does not support this format of the the overlay image file

Parameters

const CFbsBitmap & aBitmap

The bitmap containing overlay image

SetOverlayImageL(const CImageFrame &)

IMPORT_C void

SetOverlayImageL

(

const CImageFrame &

aImageFrame

)

Sets the Overlay image in the image frame

leave: KErrNotSupported The plugin does not support this format of the the overlay image file

Parameters

const CImageFrame & aImageFrame

The image frame containing the overlay image

SetPosition(const TPoint &)

IMPORT_C void

SetPosition

(

const TPoint &

aPosition

)

This function sets the position, where overlay image is to be placed

Parameters

const TPoint & aPosition

The position for overlay image

SetTransparencyLevelL(TUint)

IMPORT_C void

SetTransparencyLevelL

(

TUint

aLevel

)

Sets the transparency level of the overlay image. Its value can be 0-100 where 0 for no transparency and 100 for fully transparent. If overlay image is CFbsBitmap/CImageFrame then it can have alpha value. In this case when the application sets the transparency level using this function then the alpha value must be ignored.

leave: KErrNotSupported The plugin does not support this.

Parameters

TUint aLevel

The transparency level

SupportedOverlayInputFormatsL(RArray< TUid > &)

IMPORT_C void

SupportedOverlayInputFormatsL

(

RArray < TUid > &

aFormats

)

const

Gets the formats of the overlay image that are supported

leave: The function leaves with one of the system wide error codes, if the operation fails

Parameters

RArray < TUid > & aFormats

On return, contains the supported overlay image formats

SupportedOverlayInputSubFormatsL(TUid, RArray< TUid > &)

IMPORT_C void	SupportedOverlayInputSubFormatsL	(	TUid	aFormat,
			RArray < TUid > &	aSubFormats
		)	const

Gets the sub-formats of Overlay image that are supported

leave: The function leaves with one of the system wide error codes, if the operation fails

Parameters

TUid aFormat	The image format for which supported sub-format list is required
RArray < TUid > & aSubFormats	On return, contains the supported overlay image sub-formats

Member Data Documentation

TAny * iPad

TAny *

iPad

[private]