SetProjectionEx

globalmapper.SetProjectionEx(GM_Projection_t aProj, GM_Rectangle_t aLatLonRect, uint32 aReserved=0) → GM_Error_t32[source]

Set the new projection. This is the projection that all draws and exports will be done in. It is also the projection that all world bound rectangles will be in. This version allows providing a lat/lon bounding rectangle for automatic selection of the best zone for zoned projections.

If you pass in a zoned projection, like UTM, with no ZONE attribute or a ZONE of 0, the lat/lon rectangle (if provided) will be used to automatically select the best zone for the provided bounds. If no rectangle is provided, the last drawn rectangle will be used.

Parameters:

  • aProj (GM_Projection_t) – The new projection

  • aLatLonRect (GM_Rectangle_t) – Optional lat/lon/degrees rectangle for automatic selection of zone for zoned projections

  • aReserved (int) – Reserved for future use; defaults to 0

Returns:

Error Code

Return type:

GM_Error_t32

Example

The following is an example of SetProjectionEx.:

gm.SetProjectionEx(utm_proj, latlon_bounds_rect, 0)

For more context refer to the tutorial page on setting projections.