====== zmap_SetFormat ======

===== Description =====

Change the file format used to save a map to disk. This function will re-save the map in the new format, and change the file extension if necessary.

===== Files =====

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

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

<code="C++">
bool zmap_SetFormat(ZMAP hMap, ZFORMAT hFormat);
</code>

===== Arguments =====

^  Name  ^  Type  ^ Comment ^
|  //hMap//  |  ''ZMAP''  | A [[zeolite:types:ZMAP]] handle to a map variable, the saved file format of which is to be changed. |
|  //hFormat//  |  ''ZFORMAT''  | A [[zeolite:types:ZFORMAT]] handle to the file format variable that shall be used to save the map. |

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

False if an error occurred, and true otherwise.

===== Comments =====

This function will fail if the map has not yet been saved (use [[zeolite:functions:zmap_SaveFile]] in this case). This condition does not apply to mosaic maps, which are //always// saved to disk.