MapGuide API Reference
 All Classes Functions Variables Enumerations Enumerator Friends
virtual MgCoordinateSystemGridSpecification* MgCoordinateSystemFactory::GridSpecification ( double  increment,
double  tickIncrement,
INT32  unitCode,
double  curvePrecision 
) [virtual]

Constructs a grid specification object with all specifications set to the values indicated by the supplied parameters.

Parameters:
incrementThe distance between grid lines of a grid or graticule. This value is used for both the easting and northing grid lines; and the value must be in the units specified by the unitCode parameter.
tickIncrementThe distance between tick marks of a grid or graticule. This value is used for both the easting and northing tick marks; and the value must be in the units specified by the unitCode parameter.
unitCodeOne of the values defined by the MgCoordinateSystemUnitCode object which indicates the units in which the increment, tickIncrement, and curvePrecision parameters are specified.
curvePrecisionIn the units indicated by the unitCode parameter, the desired maximum distance between the true complex curve and the multi-segment approximation of the complex curve of any grid or graticule line generated using this specification.
Returns:
A fully initialized grid specification object.
Exceptions:
std::bad_allocThrown in the event of a heap memory allocation failure.
Remarks:
This particular overload is designed for the most common situations. It presumes the units used are of thelinear type, and thus this particular overload cannot be used to generate a specification object for use in graticule generation.