Link programming interface map object

The Link programming interface creates a map object instance from the byte array representing a compiled map file. The hierarchies of map, card and adapter objects are created by this method.

The map object is created when a map is loaded from a compiled map (.mmc) file or from memory. The Link programming interface caches maps. Therefore, if multiple map objects are created for the same map, the map file is read only once.

A map object is reentrant; that is, after a map object has been created, the map can be run an infinite number of times without any need for the map to be reloaded.

Multiple threads cannot reference the same map object concurrently; If multiple threads need to execute the same map concurrently, a separate map object should be obtained for each thread.

The identifier is used to identify the specific map. This might be the name of the map or any other identifier that the application will use. Subsequent calls to this method with the same identifier will not introduce additional processing of the compiled map. Therefore, after the initial call to this method, the memory consumed by compiledMap can be freed.

The are several properties and methods supported by the map object.