globalmapper.ExportMapLayoutComponent
=====================================

.. currentmodule:: globalmapper
.. py:function:: ExportMapLayoutComponent (str aFilename, GM_MapLayoutPiece_t8 aPiece, GM_Rectangle_t aWorldBounds, sint32 aPixelWidth, sint32 aPixelHeight, int aReserved) -> GM_Error_t32

    Exports a component of the currently setup map layout (use :doc:`LoadMapLayoutFile<../load/globalmapper.LoadMapLayoutFile>`
    to load a layout definition) to a bitmap (BMP) file. The bounding box and pixel dimensions that you specify are the
    same as you would provide to the :doc:`DrawLayerList<../display/globalmapper.DrawLayerList>` function and are used to determine
    the pixel size that the BMP file will use. If you always call this after a draw, just pass in None for the world
    bounds and 0 for both pixel dimensions.

    :param str aFilename: name of bitmap file to save to
    :param GM_MapLayoutPiece_t8 aPiece: which piece of the map layout to save
    :param GM_Rectangle_t aWorldBounds: World bounds to use for rendering layout or None for last drawn
    :param sint32 aPixelWidth: Width in pixels of FULL RENDER SCREEN (NOT LAYOUT PIECE) to use for generating map layout. Use 0 for last drawn.
    :param sint32 aPixelHeight: Height in pixels of FULL RENDER SCREEN (NOT LAYOUT PIECE) to use for generating map layout. Use 0 for last drawn.
    :param int aReserved: reserved for later use, must be 0.
    :returns: Error Code
    :rtype: GM_Error_t32