====== zmap_tile_GetTileCoords ======

===== Description =====

Get the //x// and //y// coordinates of of a tile in a mosaic. 

===== Files =====

^ Declaration | ''Zeolite.h'' |
^ Implementation | ''Zeolite.cpp'' |

===== Function prototype =====

<code="C++">
bool zmap_tile_GetTileCoords(void* hTile, long& x, long& y);
</code>

===== Arguments =====

^  Name  ^  Type  ^ Comment ^
|  //hTile//  |  ''void*''  | A handle to a tile, the coordinates of which are to be retrieved. |
|  //x//  |  ''long&''  | A long integer, passed by reference, that is to receive the x coordinate. |
|  //y//  |  ''long&''  | A long integer, passed by reference, that is to receive the y coordinate. |

===== Return value =====

False if an error occurred, and true otherwise (with //x// and //y// set to the correct values.)

===== Comments =====

The //x// and //y// coordinates returned by ''zmap_tile_GetTileCoords'' refer to the coordinates of the south-west corner of the given tile (bottom-left, on screen), as measured from the south-west corner of the map, and are measured in pixels. The coordinate axes are such that //x// increases in the east direction, and //y// increases in the north direction.