====== hfzWriteTile ======

===== Description =====

Write a map data tile to an open HF2/HFZ file.

===== Function prototype =====
<code>
long hfzWriteTile(hfzFile* fs, hfzHeader& fh, long TileX, long TileY, float* pMapData);
</code>

===== Arguments =====
^ Name ^ Type ^ Description ^
| fs | hfzFile* | A handle to an open hfzFile struct (see [[#hfzOpen]]). |
| fh | hfzHeader& | The hfzHeader struct for the file. |
| TileX | long| The x-coordinate of the map tile. |
| TileY | long| The y-coordinate of the map tile. |
| pMapData | float* | A handle to the user-supplied map array (see comments). |


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

LIBHFZ_STATUS_OK if the tile was written successfully, and otherwise an error code. Use [[libhfz:functions:hfzGetErrorStr]] to retrieve the error description. 

===== Comments =====

==== Tile order ====

Please refer to the [[:l3dt:formats:specs:hf2#map_data|HF2 file specification]] for the required tile order.


==== Regarding pMapData ====

Please refer to [[libhfz:functions:hfzLoad#initialising_memory|hfzLoad comments]] for information regarding the correct initialisation of //pMapData//.