====== zmap_GetMosaicTile ======

===== Description =====

Retrieve a handle to a tile in a mosaic map.

===== Files =====

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

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

<code="C++">
void* zmap_GetMosaicTile(ZMAP hMap, long tx, long ty);
</code>

===== Arguments =====

^  Name  ^  Type  ^ Comment ^
|  //hMap//  |  ''ZMAP''  | A [[zeolite:types:ZMAP]] handle to a map, a tile of which is to be retrieved. |
|  //tx//  |  ''long''  | The x-coordinate of the tile. |
|  //ty//  |  ''long''  | The y-coordinate of the tile. |


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

A null handle if:
  * The map is not a mosaic,
  * The tile coordinates are invalid, or;
  * An unspecified error occurred.
A valid (non-null) tile handle otherwise.

===== Comments =====

<note important>
The handle returned by map_GetMosaicTile is //not// a handle to the raw memory buffer of the tile. Use [[zeolite:functions:ztile_GetDataPtr]] for this.
</note>