Skip To Content ArcGIS for Developers Sign In Dashboard

DatumTransformation Class

(Esri::ArcGISRuntime::DatumTransformation)

Base class for classes used to transform coordinates between spatial references that have different datums. More...

Header: #include <DatumTransformation>
Since: Esri::ArcGISRuntime 100.2
Inherits: Object
Inherited By:

Esri::ArcGISRuntime::GeographicTransformation

Public Functions

~DatumTransformation()
DatumTransformationType datumTransformationType() const
SpatialReference inputSpatialReference() const
DatumTransformation *inverse() const
bool isMissingProjectionEngineFiles() const
QString name() const
SpatialReference outputSpatialReference() const
bool operator!=(const DatumTransformation *other) const
bool operator==(const DatumTransformation *other) const
  • 31 public functions inherited from QObject

Additional Inherited Members

Detailed Description

Base class for classes used to transform coordinates between spatial references that have different datums.

The inverse of the DatumTransformation, used to transform in the opposite direction, may be accessed using a member function.

A DatumTransformation has a name property intended to be suitable for display, such as when displaying a list of available transformations to an end user.

You can get a list of suitable transformations for a given input and output spatial reference using one of the TransformationCatalog::transformationsBySuitability functions.

Some transformations require that certain Projection Engine data files be present on the local file system. The property isMissingProjectionEngineFiles indicates whether any of the files are missing. The list of necessary files is available as a property of the GeographicTransformationStep class. In order for any files to be found, the data location must be set first using TransformationCatalog::setProjectionEngineDirectory.

A DatumTransformation object is immutable.

Member Function Documentation

DatumTransformation::~DatumTransformation()

Destructor.

DatumTransformationType DatumTransformation::datumTransformationType() const

Returns the type of this datum transformation.

SpatialReference DatumTransformation::inputSpatialReference() const

Returns the input SpatialReference of the DatumTransformation.

Returns the spatial reference of the coordinates to be projected.

DatumTransformation *DatumTransformation::inverse() const

Returns the datum transformation that is the inverse of this datum transformation.

Returns nullptr if there is no inverse transformation.

bool DatumTransformation::isMissingProjectionEngineFiles() const

Returns whether any files needed by the Projection Engine for this datum transformation are missing from the local file system.

QString DatumTransformation::name() const

Returns the name of the DatumTransformation.

For multi-step transformations, the name contains the concatenated names of each step's transformation, separated by plus signs (+). If the transformation is inverted, the name starts with a tilde (~).

SpatialReference DatumTransformation::outputSpatialReference() const

Returns the output SpatialReference of the DatumTransformation.

Returns the spatial reference of the destination coordinates.

bool DatumTransformation::operator!=(const DatumTransformation *other) const

Inequality operator.

Returns whether this object and other are not equivalent.

bool DatumTransformation::operator==(const DatumTransformation *other) const

Equivalency operator.

Returns whether this object and other are equivalent.


Feedback on this topic?