LoadLayerList
=============

.. currentmodule:: globalmapper
.. py:function:: LoadLayerList (str aFilename, GM_LoadFlags_t32 aLoadFlags) -> GM_Error_t32, GM_LayerHandle_t32, unint32

    Loads the given file and returns a pointer to an array containing handles for the opened layers. The number of
    layers in the array is returned as a uint32. Even when only one layer is opened, the handle will still be returned
    in an array.

    The layer handles can be used in other calls into the library. Each layer handle must be closed by calling
    :doc:`CloseLayer<globalmapper.CloseLayer>` when the caller is done using it.

    :param str aFilename: the file to load
    :param GM_LoadFlags_t32 aLoadFlags: control flags for loading the file
    :returns: Error Code
    :rtype: GM_Error_t32
    :returns: An array of handles for the loaded layers
    :rtype: GM_LayerHandle_t32
    :returns: The number of layers that were loaded
    :rtype: uint32

Example
-------
The following is an example of LoadLayerListLayer.::

    err, array_ptr, array_size = gm.LoadLayerList(file_path, gm.GM_LoadFlags_UseDefaultLoadOpts)

For a more context refer to :doc:`the tutorial page on working with layer handles<../sampleCode/DemoLayers>`.