====== zmap_ExportMap ======

===== Description =====

Export a map as a file, optionally with a different map size.

===== Files =====

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

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

<code="C++">
bool zmap_ExportMap(ZMAP hMap, const char* lpFileName, ZFORMAT hFormat, long nx, long ny);
</code>

===== Arguments =====

^  Name  ^  Type  ^ Comment ^
|  //hMap//  |  ''ZMAP''  | A [[zeolite:types:ZMAP]] handle to the map to be exported. |
|  //lpFileName//  |  ''const char*''  | A C-style string containing the name of the output file. |
|  //hFormat//  |  ''ZFORMAT''  | A [[zeolite:types:ZFORMAT]] handle to the format to be used to save the file. If null, the format is guessed from the file extension. |
|  //nx//  |  ''long''  | The desired width of the exported file (in pixels). |
|  //ny//  |  ''long''  | The desired height of the exported file (in pixels). |

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

False if an error occurred, and true otherwise.

===== Comments =====

==== Difference with zmap_SaveFile ====

[[zeolite:functions:zmap_SaveFile]] stores the filename and format and sets saved/modified flags, whereas ''zmap_ExportMap'' does no such thing. Furthermore, ''zmap_ExportMap'' can export at a different map size, and may also be used to save mosaics as a single map file.