Collapse all Symbian^3 Product Developer Library

MWsDrawableSourceProvider Class Reference

class MWsDrawableSourceProvider : public MWsObjectProvider

Window server evokes this interface from rendering stage plugin every time client requests resource drawing operations.

Inherits from

MWsDrawableSourceProvider
- MWsObjectProvider

Public Member Functions
void	CloseDrawableSource(TAny *)
TInt	CreateDrawableSource(const TSgDrawableId &, TAny *&)
void	DrawResource(const TAny *, const TPoint &, CWindowGc::TGraphicsRotation)
void	DrawResource(const TAny *, const TRect &, CWindowGc::TGraphicsRotation)
void	DrawResource(const TAny *, const TRect &, const TRect &, CWindowGc::TGraphicsRotation)
void	DrawResource(const TAny *, const TRect &, const TDesC8 &)

Inherited Functions
	MWsObjectProvider::ObjectInterface()
	MWsObjectProvider::ObjectInterface()const
	MWsObjectProvider::ResolveObjectInterface(TUint)

Member Functions Documentation

CloseDrawableSource(TAny *)

void

CloseDrawableSource

(

TAny *

aSource

)

[pure virtual]

Destroy a source object associated with a drawable resource.

Post-condition: Drawing of the associated drawable resource is no longer possible.

Parameters

TAny * aSource

A pointer to a source object created by a previous call to CreateDrawableSource().

CreateDrawableSource(const TSgDrawableId &, TAny *&)

TInt	CreateDrawableSource	(	const TSgDrawableId &	aDrawableId,
			TAny *&	aSource
		)	[pure virtual]

Create a source object for future drawing of the drawable resource with the specified ID.

Post-condition: If successful, a new source object is created and the associated drawable resource is ready to use.

Parameters

const TSgDrawableId & aDrawableId	The ID of the drawable resource.
TAny *& aSource	On output, a pointer to the new source object associated with the drawable resource, which must be passed in calls to DrawResource() and CloseDrawableSource(). After the call to CloseDrawableSource() the source object is destroyed and this pointer becomes invalid. The type of the source object is defined by the implementation of MWsDrawableSourceProvider.

DrawResource(const TAny *, const TPoint &, CWindowGc::TGraphicsRotation)

void	DrawResource	(	const TAny *	aSource,
			const TPoint &	aPos,
			CWindowGc::TGraphicsRotation	aRotation = CWindowGc::EGraphicsRotationNone
		)	[pure virtual]

Draw a graphics resource.

Pre-condition: A source object must have been created for the drawable resource by a previous call to CreateDrawableSource().

Parameters

const TAny * aSource	A pointer to the source object associated with the drawable resource.
const TPoint & aPos	Destination position for the top-left corner of the drawable resource.
CWindowGc::TGraphicsRotation aRotation = CWindowGc::EGraphicsRotationNone	Rotation to be applied to the drawable resource before it is drawn.

DrawResource(const TAny *, const TRect &, CWindowGc::TGraphicsRotation)

void	DrawResource	(	const TAny *	aSource,
			const TRect &	aRect,
			CWindowGc::TGraphicsRotation	aRotation = CWindowGc::EGraphicsRotationNone
		)	[pure virtual]

Draw a graphics resource.

Pre-condition: A source object must have been created for the drawable resource by a previous call to CreateDrawableSource().

Parameters

const TAny * aSource	A pointer to the source object associated with the drawable resource.
const TRect & aRect	Destination rectangle. The drawable resource could be scaled if its size doesn't match the destination rectangle.
CWindowGc::TGraphicsRotation aRotation = CWindowGc::EGraphicsRotationNone	Rotation to be applied to the drawable resource before it is drawn.

DrawResource(const TAny *, const TRect &, const TRect &, CWindowGc::TGraphicsRotation)

void	DrawResource	(	const TAny *	aSource,
			const TRect &	aRectDest,
			const TRect &	aRectSrc,
			CWindowGc::TGraphicsRotation	aRotation = CWindowGc::EGraphicsRotationNone
		)	[pure virtual]

Draw a graphics resource.

Pre-condition: A source object must have been created for the drawable resource by a previous call to CreateDrawableSource().

Parameters

const TAny * aSource	A pointer to the source object associated with the drawable resource.
const TRect & aRectDest	Destination rectangle. The drawable resource could be scaled if its size doesn't match the destination rectangle.
const TRect & aRectSrc	A rectangle defining the piece of the drawable resource to be drawn, in the co-ordinate system of the drawable resource.
CWindowGc::TGraphicsRotation aRotation = CWindowGc::EGraphicsRotationNone	Rotation to be applied to the drawable resource before it is drawn.

DrawResource(const TAny *, const TRect &, const TDesC8 &)

void	DrawResource	(	const TAny *	aSource,
			const TRect &	aRect,
			const TDesC8 &	aParam
		)	[pure virtual]

Draw a graphics resource.

Pre-condition: A source object must have been created for the drawable resource by a previous call to CreateDrawableSource().

Parameters

const TAny * aSource	A pointer to the source object associated with the drawable resource.
const TRect & aRect	Destination rectangle. The drawable resource could be scaled if its size doesn't match the destination rectangle.
const TDesC8 & aParam	Parameters specifying how to draw the drawable resource.