MapGuide API Reference
 All Classes Functions Variables Enumerations Enumerator Friends
virtual MgCoordinateSystemMgrs* MgCoordinateSystemFactory::GetMgrsDatum ( CREFSTRING  sDatumCode,
INT8  nLetteringScheme,
bool  bSetExceptionsOn 
) [virtual]

Manufactures an MGRS grid object. The returned object is suitable only for use in simple coordinate <-> MGRS string calculations.

Parameters:
sDatumCodeDictionary code name of the datum whose referenced ellipsoid is to be used for all conversions to and from MGRS strings.
nLetteringSchemeA value as defined in the MgCoordinateSystemMgrsLetteringScheme object which specifies the lettering scheme to be used on MGRS string conversions.
bSetExceptionsOntrue indicates that exceptions are to be thrown on coordinate conversions which fail for any reason.
Returns:
Returns a disposable pointer to an MgCoordinateSystemMgrs object which is suitable only for MGRS string conversions.
Exceptions:
MgOutOfMemoryExceptionThrown on heap memory allocation failure.
Remarks:
The datum specification is simply a means of specifying the ellipsoid upon which the calculations are to be based. It does not mean that any datum shift calculations will be performed.