====== zview_ShowMap ======

===== Description =====

Set the map displayed in the main window of L3DT.

===== Files =====

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

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

<code="C">bool zview_ShowMap(const char* lpProjMapName);</code>

===== Arguments =====

^ Name ^ Type ^ Comment ^
| lpProjMapName | const char* | A pointer to a C-style string containing the name of the map layer to be displayed. |

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

''true'', pretty much all the time. 

===== Comments =====

==== Values of lpProjMapName ====

The following values of //lpProjMapName// are valid:

^ //lpProjMapName// ^ Which map is it? ^
| "DM" | The design map. |
| "HF" | The heightfield. |
| "WM" | The water map. |
| "WS" | The water salinity map. |
| "AM" | The attributes map. |
| "TN" | The terrain normals map. |
| "LM" | The light map. |
| "TX" | The texture map. |

If other custom map layers are present in the project, their names may be used also.

==== Function is asynchronous ====

view_ShowMap will return before the map is actually re-drawn. This is because L3DT draws the map in another thread.