====== zproj_GetMap ======

===== Description =====

Retrieve a handle to a map layer from the application's project.

===== Files =====

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

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

<code="C">ZMAP zproj_GetMap(const char* lpMapName);</code>

===== Arguments =====

^ Name ^ Type ^ Comment ^
| //lpMapName// | const char* | A handle to a C-style string containing the name of the map to be retrieved. See comments for legal values. |

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

Null if an error occurred, and a valid non-null ZMAP handle otherwise.

===== Comments =====

The following values of //lpMapName// are supported:

^ //lpMapName// ^ 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. |
| "SpecLM" | The specular light map. |
| "TX" | The texture map. |

The names of any custom map layers in the project are also supported.