MapCatalogAddFile
=================

.. currentmodule:: globalmapper
.. py:function:: MapCatalogAddFile (GM_LayerHandle_t32 aCatalogLayer, string aFilename, GM_LoadFlags_t32 aAdditionalLoadFlags) -> GM_Error_t32

    Adds a new map to the map catalog from a file on disk. The *aCatalogLayer* parameter should have either been created
    using :doc:`MapCatalogCreate<globalmapper.MapCatalogCreate>` or loaded with one of the LoadLayer* functions.

    :param GM_LayerHandle_t32 aCatalogLayer: Handle to map catalog layer (either from loading or CreateMapCatalog)
    :param str aFilename: Filename of map to add to the catalog
    :param GM_LoadFlags_t32 aAdditionalLoadFlags: Additional load flags. Note that GM_LoadFlags_LoadMetadataOnly, GM_LoadFlags_DisableSplit and GM_LoadFlags_HideUnknownPrompt already have special processing. Adding these here would turn them on unconditionally.
    :returns: Error Code
    :rtype: GM_Error_t32

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

    gm.MapCatalogAddFile(catalog_handle, resource_dir + file, gm.GM_LoadFlags_UseDefaultLoadOpts)

For more context refer to :doc:`the map catalog sample scripts<../sampleCode/DemoMapCatalog>`.