= !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 [wiki:MapGuideRfcs 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 which return a bool value to indicate the tile generation is successful 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.