====== map_GetMosaicTile ======

===== Description =====

Retrieve a mosaic tile handle.

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

<code>void* CExtAPI::map_GetMosaicTile(ZMAP hMap, long tx, long ty);</code>

===== Arguments =====

^ Name ^ Type ^ Comment ^
| hMap | ZMAP | A 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.
  * 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:tile_GetDataPtr]] for this.
</note>