OGR
Public Member Functions | Static Public Member Functions | List of all members
OGRCoordinateTransformation Class Referenceabstract

#include <ogr_spatialref.h>

Inheritance diagram for OGRCoordinateTransformation:
OGRProj4CT

Public Member Functions

virtual OGRSpatialReferenceGetSourceCS ()=0
 
virtual OGRSpatialReferenceGetTargetCS ()=0
 
virtual bool GetEmitErrors ()
 
virtual void SetEmitErrors (bool)
 
virtual int Transform (int nCount, double *x, double *y, double *z=NULL)=0
 
virtual int TransformEx (int nCount, double *x, double *y, double *z=NULL, int *pabSuccess=NULL)=0
 

Static Public Member Functions

static void DestroyCT (OGRCoordinateTransformation *poCT)
 OGRCoordinateTransformation destructor. More...
 

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

void OGRCoordinateTransformation::DestroyCT ( OGRCoordinateTransformation poCT)
static

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
virtual bool OGRCoordinateTransformation::GetEmitErrors ( )
inlinevirtual

Whether the transformer will emit CPLError

Reimplemented in OGRProj4CT.

virtual OGRSpatialReference* OGRCoordinateTransformation::GetSourceCS ( )
pure virtual

Fetch internal source coordinate system.

Implemented in OGRProj4CT.

Referenced by OGRGeometryFactory::transformWithOptions().

virtual OGRSpatialReference* OGRCoordinateTransformation::GetTargetCS ( )
pure virtual
virtual void OGRCoordinateTransformation::SetEmitErrors ( bool  )
inlinevirtual

Set if the transformer must emit CPLError

Reimplemented in OGRProj4CT.

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.

Implemented in OGRProj4CT.

Referenced by OGRPoint::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.

Implemented in OGRProj4CT.

Referenced by OGRSimpleCurve::transform().


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

Generated for GDAL by doxygen 1.8.5.