MapGuide API Reference
 All Classes Functions Variables Enumerations Enumerator Friends
MgCoordinateSystemTransform Class Reference

Provides operations for transforming coordinates from one coordinate system to another. More...

+ Inheritance diagram for MgCoordinateSystemTransform:

List of all members.

Public Member Functions

virtual INT32 GetdatumWarningCount (void)=0
 Gets the datum warning count.
virtual
MgCoordinateSystemGeodeticPath * 
GetExplicitGeodeticPath ()=0
 Returns the definition of the geodetic path used to build the transformation, but only if the path was explicitly obtained from the Geodetic Path dictionary.
virtual
MgCoordinateSystemGeodeticTransformDef * 
GetGeodeticTransformation (INT32 index)=0
 Returns a pointer to the catalog-resident(!) geodetic transformation definition indicated by the index parameter.
virtual INT32 GetGeodeticTransformationCount ()=0
 Returns the number of geodetic transformations used in the implicit or explicit path used to convert the source to the target coordinate system. For a geodetic transformation to take place, both the source and the target coordinate systems have to be referenced to a datum.
virtual INT32 GetGeodeticTransformationDirection (INT32 index)=0
 Returns the direction of the transformation definition indicated by the index parameter.
virtual INT32 GetLastTransformStatus ()=0
 Gets the last transformation status.
virtual MgCoordinateSystem * GetSource ()=0
 Gets the source coordinate system (MgCoordinateSystem)
virtual INT32 GetSourceWarningCount (void)=0
 Gets the source warning count.
virtual MgCoordinateSystem * GetTarget ()=0
 Gets the target coordinate system (MgCoordinateSystem)
virtual INT32 GetTargetWarningCount (void)=0
 Gets the target warning count.
virtual MgLineString * GridLine (MgCoordinate *fromPnt, MgCoordinate *toPnt, double curvePrecision, UINT32 maxPoints)=0
 Generates a MgLineString which represents, in the target coordinate system, the linear line segment provided in the source coordinate system.
virtual void IgnoreDatumShiftWarning (bool bIgnoreDatumShiftWarning)=0
 Sets whether datum shift warnings will be ignored.
virtual void IgnoreOutsideDomainWarning (bool bIgnoreOutsideDomainWarning)=0
 Sets whether outside domain warnings will be ignored.
virtual bool IsIgnoreDatumShiftWarning ()=0
 Gets whether datum shift warnings will be ignored.
virtual bool IsIgnoreOutsideDomainWarning ()=0
 Gets whether outside domain warnings will be ignored.
virtual bool IsValidSourcePoint (double x, double y)=0
 Gets whether the given source point is valid.
virtual bool IsValidSourcePoint (double x, double y, double z)=0
 Gets whether the given source point is valid.
virtual bool IsValidTargetPoint (double x, double y)=0
 Gets whether the given target point is valid.
virtual bool IsValidTargetPoint (double x, double y, double z)=0
 Gets whether the given target point is valid.
virtual void ResetLastTransformStatus ()=0
 Resets the last transformation status.
virtual void SetSourceAndTarget (MgCoordinateSystem *pSource, MgCoordinateSystem *pTarget)=0
 Sets the source and target coordinate systems.
virtual MgCoordinate * Transform (double x, double y)=0
 Transforms the given X and Y values whose frame of reference is the source coordinate system into an XY coordinate whose frame of reference is the target coordinate system.
virtual MgCoordinate * Transform (double x, double y, double z)=0
 Transforms the given X, Y and Z values whose frame of reference is the source coordinate system into a coordinate whose frame of reference is the target coordinate system.
virtual MgCoordinate * Transform (MgCoordinate *coordinate)=0
 Transforms the given coordinate whose frame of reference is the source coordinate system into a coordinate whose frame of reference is the target coordinate system.
virtual MgEnvelope * Transform (MgEnvelope *envelope)=0
 Transforms an MgEnvelope instance for the source coordinate system into an MgEnvelope instance for target coordinate system.
virtual void TransformCoordinate (MgCoordinate *coordinate)=0
 Transforms the specified coordinate in-place.
virtual MgCoordinate * TransformM (double x, double y, double m)=0
 Transforms the given X, Y, and M values whose frame of reference is the source coordinate system into a coordinate whose frame of reference is the target coordinate system.
virtual MgCoordinate * TransformM (double x, double y, double z, double m)=0
 Transforms the given X, Y, Z, and M values whose frame of reference is the source coordinate system into a coordinate whose frame of reference is the target coordinate system.

Static Public Attributes

static const INT32 DatumShiftError = 4
 Status Accumulation Status bit map: Datum shift error.
static const INT32 DatumShiftFallback = 2
 Status Accumulation Status bit map: Datum shift fallback.
static const INT32 SourceCrsError = 1
 Status Accumulation Status bit map: Source CRS error.
static const INT32 TargetCrsError = 8
 Status Accumulation Status bit map: Target CRS error.
static const INT32 TransformDatumShiftWarning = 2
 Transformation status: resulted in a datum shift warning.
static const INT32 TransformOk = 0
 Transformation status: ok.
static const INT32 TransformOutsideDomainWarning = 1
 Transformation status: resulted in being outside the domain warning.
static const INT32 TransformTotalFailure = 3
 Transformation status: was a total failure.

Detailed Description

Provides operations for transforming coordinates from one coordinate system to another.