MapGuide RFC 107 - Enhance Tile service to add a new API GenerateTile

This page contains a change request (RFC) for the MapGuide Open Source project. More MapGuide RFCs can be found on the RFCs page.

Status

RFC Template Version	(1.0)
Submission Date	July 23, 2010
Last Modified	Ted Yang July 23, 2010
Author	Ted Yang
RFC Status	draft
Implementation Status	incomplete
Proposed Milestone	2.3
Assigned PSC guide(s)
Voting History
+1
+0
-0
-1
Abstained

Overview

This RFC proposes to add a NEW GenerateTile() API to the tile service which return a bool value to indicate the tile generate success or not. This function will generate the tile on the server but not get the image from server. This function will allow user to pre-cache tiles on the server but elimate the cost of image transfer.

Motivation

Proposed Solution

Create a NEW GenerateTile() API that return a bool value to indicate the tile generate success or not.

Existing API:

    MgByteReader* GetTile(MgResourceIdentifier* mapDefinition,CREFSTRING baseMapLayerGroupName,INT32 tileColumn,INT32 tileRow,INT32 scaleIndex);

Proposed NEW API:

    bool GenerateTile(MgResourceIdentifier* mapDefinition,CREFSTRING baseMapLayerGroupName,INT32 tileColumn,INT32 tileRow,INT32 scaleIndex);

Implications

This change will NOT break existing API compatibility.

Test Plan

• Build/Run on Windows/Linux
• New Unit test for GenerateTile will be added

Funding/Resources

Supplied by Autodesk.