Collapse all Symbian^3 Application Developer Library

CMnCoordinateConverterBase Class Reference

class CMnCoordinateConverterBase : public CBase

This is the base service interface to access coordinate conversion functionality of MapImage service capable provider applications.

This interface must be implemented by Map and Navigation provider applications, which support KMnAppServiceMapImage service.

mnclientlib.lib

Since: 5.0

Inherits from

CMnCoordinateConverterBase
- CBase

Public Member Functions
	~CMnCoordinateConverterBase ()
TInt	GetImageCoordinate (const TCoordinate &, TPoint &)
TInt	GetWorldCoordinate (const TPoint &, TCoordinate &)
IMPORT_C const TMnMapImageParams &	MapImageParams ()
CMnCoordinateConverterBase *	NewL ( TUid )
void	SetMapImageParams (const TMnMapImageParams &)

Protected Member Functions
	CMnCoordinateConverterBase ()

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()

Private Attributes
TUid	iDtorIdKey
TMnMapImageParams	iImageParams

Constructor & Destructor Documentation

CMnCoordinateConverterBase()

IMPORT_C

CMnCoordinateConverterBase

(

)

[protected]

~CMnCoordinateConverterBase()

IMPORT_C

~CMnCoordinateConverterBase

(

)

Base destructor

Member Functions Documentation

GetImageCoordinate(const TCoordinate &, TPoint &)

TInt	GetImageCoordinate	(	const TCoordinate &	aWorldCoordinate,
			TPoint &	aImagePoint
		)	[pure virtual]

Calculates coordinate in pixels of the point corresponding to given world coordinate.

Given world coordinate is allowed to be beyond image borders. In that case negative values in result value describe point to the left of left border and/or above top border of the image and values bigger than width or height describe point to the right of right image border or below its bottom border.

If such calculation is not possible (e.e given world coordinate is not part of the image) this function must return KErrUnknown .

Parameters

const TCoordinate & aWorldCoordinate	World coordinate (in WGS-84)
TPoint & aImagePoint	Coordinate of corresponding pixel in image relative to image top left corner.

GetWorldCoordinate(const TPoint &, TCoordinate &)

TInt	GetWorldCoordinate	(	const TPoint &	aImagePoint,
			TCoordinate &	aWorldCoordinate
		)	[pure virtual]

Calculates world coordinate of the given image point.

Given image point coordinate must be within the rectangle ( TPoint( 0, 0 ), Size() ).

If such calculation is not possible (e.g. given image coordinate does not match any world coordinate) this function must return KErrUnknown .

Parameters

const TPoint & aImagePoint	Coordinate of a point on map image in pixels, relative to image top left corner.
TCoordinate & aWorldCoordinate	On successful return, corresponding world coordinate (in WGS-84).

MapImageParams()

IMPORT_C const TMnMapImageParams &

MapImageParams

(

)

const

Returns drawing parameters of map image.

NewL(TUid)

CMnCoordinateConverterBase *

NewL

(

TUid

aProviderUid

)

[static]

Parameters

TUid aProviderUid

SetMapImageParams(const TMnMapImageParams &)

void

SetMapImageParams

(

const TMnMapImageParams &

aImageParams

)

Parameters

const TMnMapImageParams & aImageParams

Member Data Documentation

TUid iDtorIdKey

TUid

iDtorIdKey

[private]

TMnMapImageParams iImageParams

TMnMapImageParams

iImageParams

[private]