globalmapper.LoadLayer
======================

.. currentmodule:: globalmapper
.. py:function:: LoadLayer (str aFilename, GM_LoadFlags_t32 aLoadFlags) -> GM_Error_t32, GM_LayerHandle_t

    Loads the given file and returns the handle to the layer. The layer handle can be used in other calls
    into the library. The layer must be closed by calling :doc:`CloseLayer<globalmapper.CloseLayer>` when the caller is
    done using it.

    This function is deprecated. You should use :doc:`LoadLayerList<globalmapper.LoadLayerList>` as it supports multiple
    layers being loaded from a single file (this is common with archive files like .zip and .tar.gz as well as multi-map
    formats like CADRG).

    :param str aFilename: name of the file you want to load
    :param GM_LoadFlags_t32 aLoadFlags: control flags for loading the layer
    :returns: Error Code
    :rtype: GM_Error_t32
    :returns: The layer that was loaded
    :rtype: GM_LayerHandle_t32