1 | | =Overview= |
| 1 | = !MapGuide RFC 13 - Configurable tile size = |
| 2 | |
| 3 | This page contains an change request (RFC) for the !MapGuide Open Source project. |
| 4 | More !MapGuide RFCs can be found on the [wiki:MapGuideRfcs RFCs] page. |
| 5 | |
| 6 | |
| 7 | == Status == |
| 8 | |
| 9 | ||RFC Template Version||(1.0)|| |
| 10 | ||Submission Date||Jan 24 17:07:00 2007 || |
| 11 | ||Last Modified||Trevor Wekel [[Timestamp]]|| |
| 12 | ||Author||Trevor Wekel|| |
| 13 | ||RFC Status||draft|| |
| 14 | ||Implementation Status||pending|| |
| 15 | ||Proposed Milestone||1.2|| |
| 16 | ||Assigned PSC guide(s)||(when determined)|| |
| 17 | ||'''Voting History'''||(vote date)|| |
| 18 | ||+1|| || |
| 19 | ||+0|| || |
| 20 | ||-0|| || |
| 21 | ||-1|| || |
| 22 | |
| 23 | == Overview == |
| 26 | |
| 27 | == Motivation == |
| 28 | |
| 29 | Currently, the MapGuide tile size is hard coded in the Server code and Ajax script as 300x300 pixels. For the purposes of performance tuning and to allow for alignment with 3rd party tile sets, it would be useful to set the tile size as a Server configuration parameter. However, this parameter would need to be exposed through the Web Extensions API so that the Ajax viewer is aware of the custom tile size. |
| 30 | |
| 31 | Ideally, tile sizes should be associated with the map. However that will require changes to both the map definition and any authoring tools used to edit the map definition. Due to the impact of such a change, map definition based tile size is beyond the scope of this RFC. It would be appropriate to consider it in future work. |
| 32 | |
| 33 | == Proposed Solution == |
| 34 | |
| 35 | Add two parameters to the TileService section in serverconfig.ini |
| 36 | TileSizeX = 300 |
| 37 | TileSizeY = 300 |
| 38 | |
| 39 | If not specified, the Server will default to 300x300. |
| 40 | |
| 41 | Add two additional APIs to MgTileService |
| 42 | INT32 GetTileSizeX(); |
| 43 | INT32 GetTileSizeY(); |
| 44 | |
| 45 | Modify mapframe.php, mapframe.jsp, mapframe.aspx, and ajaxmappane.templ to pull the tile size from the MgTileService instead of simply hard coding the value. |
| 46 | |
| 47 | == Implications == |
| 48 | |
| 49 | Previous Ajax viewer scripts will only function correctly with an updated Server if the tile size is set to 300x300. |
| 50 | |
| 51 | == Test Plan == |
| 52 | |
| 53 | Modify the tile size on the server and view the Sheboygan tiled map to visually verify that the tiles are georeferenced correctly in the Ajax viewer. The regular (non-tiled) map can be used as a reference. |
| 54 | |
| 55 | == Funding/Resources == |
| 56 | |
| 57 | Autodesk |