====== map_ExportMap ======

===== Description =====

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

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

<code>bool CExtAPI::map_ExportMap(ZMAP hMap, const char* lpFileName, ZFORMAT hFormat, long nx, long ny);</code>

===== Arguments =====

^ Name ^ Type ^ Comment ^
| hMap | ZMAP | A handle to the map to be exported. |
| lpFileName | const char* | A C-style string containing the name of the output file. |
| hFormat | ZFORMAT | A 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 map_SaveFile ====

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