GDAL
Public Member Functions | Static Public Member Functions
OGRCoordinateTransformation Class Reference

Interface for transforming between coordinate systems. More...

#include <ogr_spatialref.h>

Inherited by CompositeCT, CutlineTransformer, GCPCoordTransformation, and OGRProj4CT.

List of all members.

Public Member Functions

virtual OGRSpatialReferenceGetSourceCS ()=0
 Fetch internal source coordinate system.
virtual OGRSpatialReferenceGetTargetCS ()=0
 Fetch internal target coordinate system.
virtual int Transform (int nCount, double *x, double *y, double *z=NULL)=0
 Transform points from source to destination space.
virtual int TransformEx (int nCount, double *x, double *y, double *z=NULL, int *pabSuccess=NULL)=0
 Transform points from source to destination space.

Static Public Member Functions

static void DestroyCT (OGRCoordinateTransformation *poCT)
 OGRCoordinateTransformation destructor.

Detailed Description

Interface for transforming between coordinate systems.

Currently, the only implementation within OGR is OGRProj4CT, which requires the PROJ.4 library to be available at run-time.

Also, see OGRCreateCoordinateTransformation() for creating transformations.


Member Function Documentation

OGRCoordinateTransformation destructor.

This function is the same as OGRCoordinateTransformation::~OGRCoordinateTransformation() and OCTDestroyCoordinateTransformation()

This static method will destroy a OGRCoordinateTransformation. It is equivalent to calling delete on the object, but it ensures that the deallocation is properly executed within the OGR libraries heap on platforms where this can matter (win32).

Parameters:
poCTthe object to delete
Since:
GDAL 1.7.0

Fetch internal source coordinate system.

Fetch internal target coordinate system.

virtual int OGRCoordinateTransformation::Transform ( int  nCount,
double *  x,
double *  y,
double *  z = NULL 
) [pure virtual]

Transform points from source to destination space.

This method is the same as the C function OCTTransform().

The method TransformEx() allows extended success information to be captured indicating which points failed to transform.

Parameters:
nCountnumber of points to transform.
xarray of nCount X vertices, modified in place.
yarray of nCount Y vertices, modified in place.
zarray of nCount Z vertices, modified in place.
Returns:
TRUE on success, or FALSE if some or all points fail to transform.
virtual int OGRCoordinateTransformation::TransformEx ( int  nCount,
double *  x,
double *  y,
double *  z = NULL,
int *  pabSuccess = NULL 
) [pure virtual]

Transform points from source to destination space.

This method is the same as the C function OCTTransformEx().

Parameters:
nCountnumber of points to transform.
xarray of nCount X vertices, modified in place.
yarray of nCount Y vertices, modified in place.
zarray of nCount Z vertices, modified in place.
pabSuccessarray of per-point flags set to TRUE if that point transforms, or FALSE if it does not.
Returns:
TRUE if some or all points transform successfully, or FALSE if if none transform.

The documentation for this class was generated from the following files:

Generated for GDAL by doxygen 1.7.6.1.