C++ constructor

Destructor

This method must be called from derived class' ConstructL to allow internal initialization of this class.

Must be called by client when rendering is successfully completed. (If there were an error, then CMnServiceBase::CompleteRequest() should be called instead.)

Before completion, actual type of image drawn should be set in MapImageParams() in case original value was TMnMapImageParams::ETypeUnspecified .

Handles client's request for rendering map image.

Derived class must implement this method if KMnSvcFeatureRender feature is specified in SERVICE_INFO.

Implementation should draw map image to bitmap object returned by TargetBitmap() . Drawing must be done to the area of the bitmap, specified by TargetRect() .

Map image parameters are specified in object of TMnMapImageParams and can be accessed via MapImageOptions() . Center of the drawing must correspond to world point given by TMnMapImageParams::GetCentralPoint() , scale must be as specified by TMnMapImageParams::Scale() . Image must be oriented as required by TMnMapImageParams::Direction() . Image type requested is defined in TMnMapImageParams::ImageType() . Additional options defined by ShowOptions() must also be obeyed (if possible).

If any of those requirements can not be satisfied, rendering must be completed with KErrNotSupported. If any of arguments are considered generally invalid, then error code should be KErrArgument.

This is asynchronous request. Implementation should complete this request by calling CompleteRendering() if rendering ended successfully or by calling CMnServiceBase::CompleteRequest() in case of error.

This request can be canceled by client, in which case base method DoCancel() will be called.

If this function leaves then client's request is automatically completed with error.

Returns drawing parameters of map image.

Returns drawing parameters of map image.

Override of CSession2::ServiceL() . If further overridden, this function must be base-called.

Returns rendering options set by client. Rendering process must obey these options. If it is not possible, it should complete rendering with KErrNotSupported.

Returns reference to target bitmap object. This is the bitmap, which the map image should be rendered to. It is guaranteed that bitmap's size in pixels is sufficient for drawing. This method should be called only during processing of rendering request, i.e. not before HandleRenderingL() or after CompleteRendering()

Returns origin and size of needed image in pixels. Size part of that rectangle is the same as specified in MapImageParams() .