globalmapper.ConvertCoordPixelToGroundWithOrientation
=====================================================

.. currentmodule:: globalmapper
.. py:function:: ConvertCoordPixelToGroundWithOrientation (sint32 aPixelX, sint32 aPixelY, GM_Rectangle_t aWorldBounds, GM_PixelRect_t aPixelRect, float aOrientation) -> GM_Error_t32, float, float

    Convert a coordinate between pixel space and the current projection. The conversion space can be either the last
    drawn coordinate space or the caller can provide the coordinate space to work in. You also need to supply an
    orientation (rotation angle) at which to do the conversion.

    Note that the input pixel coordinates are sint32's. If you want to use floats instead, use the function
    :doc:`ConvertCoordPixelToGroundWithOrientationDouble<globalmapper.ConvertCoordPixelToGroundWithOrientationDouble>`.

    Note: The only time that you should need to call this function is if you want to do a coordinate conversion in a
    different orientation than what has been set globally with :doc:`SetOrientation<../display/globalmapper.SetOrientation>`.

    :param sint32 aPixelX: X Coord in pixel space
    :param sint32 aPixelY: Y Coord in pixel space
    :param GM_Rectangle_t aWorldBounds: World bounds to convert from or None for last drawn
    :param GM_PixelRect_t aPixelRect: Pixel bounds to convert from or None for last drawn
    :param float aOrientation: Orientation of coordinate space to use (0 is north up, 90 is east up, 180 is south up, 270 is west up)
    :returns: Error Code
    :rtype: GM_Error_t32
    :return: X Coord in current projection
    :rtype: float
    :return: Y Coord in current projection
    :rtype: float