MapGuide API Reference
 All Classes Functions Variables Enumerations Enumerator Friends
virtual MgLineString* MgCoordinateSystemTransform::GridLine ( MgCoordinate fromPnt,
MgCoordinate toPnt,
double  curvePrecision,
UINT32  maxPoints 
) [pure virtual]

Generates a MgLineString which represents, in the target coordinate system, the linear line segment provided in the source coordinate system.

Parameters:
fromPntThe starting point of the linear segment in source system coordinates.
toPntThe end point of the linear segment in source system coordinates.
curvePrecisionThe returned line string is segmented to the degree necessary such that the distance between the LineString approximation of the true curve and the true curve istself is never more than this value. Units must be the same as the target coordinate system.
maxPointsThe generation algorithm will always quit after generating this number of points in result. A typical value is 500. DO NOIT rely on the algorithm stopping at exactly this value. The typical value of 500 can and will produce a LineString with as many of 750 points before terminating.
Returns:
The result of the transformation is returned in the form of a disposable LineString object. While the result can be as simple as a single straight line segment, more often it will be a multi-segment approximation of a complex curve.