globalmapper.ProjectRectangle
=============================

.. currentmodule:: globalmapper
.. py:function:: ProjectRectangle (GM_Rectangle_t aRectIn, GM_Projection_t aProjIn, GM_Projection_t aProjOut) -> GM_Error_t32, GM_Rectangle_t

    Projects a rectangle from one coordinate system to another. If None is passed for either projection parameter, the
    current view projection will be used.

    Note that this should be used rather than simply calling :doc:`ProjectPoint<globalmapper.ProjectPoint>` on the
    corners of a rectangle because many rectangles will NOT be rectangular in other projections, resulting in min/max
    values along on edge, or in some cases, like polar stereographic, the min/max values may be interior to the rectangle.

    :param GM_Rectangle_t aRectIn: Rectangle to convert in input projection
    :param GM_Projection_t aProjIn: projection to convert from (None for current)
    :param GM_Projection_t aProjTo: projection to convert to (None for current)
    :returns: Error Code
    :rtype: GM_Error_t32
    :return: Rectangle in output projection
    :rtype: GM_Rectangle_t