QGIS API Documentation
3.0.2-Girona (307d082)
|
Contains information about the context in which a coordinate transform is executed. More...
#include <qgscoordinatetransformcontext.h>
Public Member Functions | |
QgsCoordinateTransformContext () | |
Constructor for QgsCoordinateTransformContext. More... | |
QgsCoordinateTransformContext (const QgsCoordinateTransformContext &rhs) | |
Copy constructor. More... | |
~QgsCoordinateTransformContext () | |
bool | addSourceDestinationDatumTransform (const QgsCoordinateReferenceSystem &sourceCrs, const QgsCoordinateReferenceSystem &destinationCrs, int sourceTransformId, int destinationTransformId) |
Adds a new sourceTransform and destinationTransform to use when projecting coordinates from the the specified sourceCrs to the specified destinationCrs. More... | |
QgsDatumTransform::TransformPair | calculateDatumTransforms (const QgsCoordinateReferenceSystem &source, const QgsCoordinateReferenceSystem &destination) const |
Returns the pair of source and destination datum transforms to use for a transform from the specified source CRS to destination CRS. More... | |
void | clear () |
Clears all stored transform information from the context. More... | |
bool | hasTransform (const QgsCoordinateReferenceSystem &source, const QgsCoordinateReferenceSystem &destination) const |
Returns true if the context has a valid datum transform to use when transforming from the specified source CRS to destination CRS. More... | |
QgsCoordinateTransformContext & | operator= (const QgsCoordinateTransformContext &rhs) |
Assignment operator. More... | |
void | readSettings () |
Reads the context's state from application settings. More... | |
bool | readXml (const QDomElement &element, const QgsReadWriteContext &context, QStringList &missingTransforms) |
Reads the context's state from a DOM element. More... | |
void | removeSourceDestinationDatumTransform (const QgsCoordinateReferenceSystem &sourceCrs, const QgsCoordinateReferenceSystem &destinationCrs) |
Removes the source to destination datum transform pair for the specified sourceCrs and destinationCrs. More... | |
QMap< QPair< QString, QString >, QgsDatumTransform::TransformPair > | sourceDestinationDatumTransforms () const |
Returns the stored mapping for source to destination CRS pairs to associated datum transforms to use. More... | |
void | writeSettings () |
Write the context's state to application settings. More... | |
void | writeXml (QDomElement &element, const QgsReadWriteContext &context) const |
Writes the context's state to a DOM element. More... | |
Contains information about the context in which a coordinate transform is executed.
The context stores various information regarding which coordinate transforms should be used when transforming points from a source to destination coordinate reference system.
The highest priority transforms are those set using addSourceDestinationDatumTransform() and which the transform has a matching source to destination CRS pair.
Failing this, if the source CRS has a matching transform specified by addSourceDatumTransform() then this datum transform will be used. The same logic applies for destination CRS transforms set using addDestinationDatumTransform().
Definition at line 62 of file qgscoordinatetransformcontext.h.
QgsCoordinateTransformContext::QgsCoordinateTransformContext | ( | ) |
Constructor for QgsCoordinateTransformContext.
Definition at line 23 of file qgscoordinatetransformcontext.cpp.
|
default |
QgsCoordinateTransformContext::QgsCoordinateTransformContext | ( | const QgsCoordinateTransformContext & | rhs | ) |
Copy constructor.
Definition at line 29 of file qgscoordinatetransformcontext.cpp.
bool QgsCoordinateTransformContext::addSourceDestinationDatumTransform | ( | const QgsCoordinateReferenceSystem & | sourceCrs, |
const QgsCoordinateReferenceSystem & | destinationCrs, | ||
int | sourceTransformId, | ||
int | destinationTransformId | ||
) |
Adds a new sourceTransform and destinationTransform to use when projecting coordinates from the the specified sourceCrs to the specified destinationCrs.
If either sourceTransformId or destinationTransformId is -1, then no datum transform is required for transformations for that source or destination.
Returns true if the new transform pair was added successfully.
Definition at line 117 of file qgscoordinatetransformcontext.cpp.
QgsDatumTransform::TransformPair QgsCoordinateTransformContext::calculateDatumTransforms | ( | const QgsCoordinateReferenceSystem & | source, |
const QgsCoordinateReferenceSystem & | destination | ||
) | const |
Returns the pair of source and destination datum transforms to use for a transform from the specified source CRS to destination CRS.
Returns an ID of -1 if a datum transform should not be used for the source or destination.
Definition at line 141 of file qgscoordinatetransformcontext.cpp.
void QgsCoordinateTransformContext::clear | ( | ) |
Clears all stored transform information from the context.
Definition at line 39 of file qgscoordinatetransformcontext.cpp.
bool QgsCoordinateTransformContext::hasTransform | ( | const QgsCoordinateReferenceSystem & | source, |
const QgsCoordinateReferenceSystem & | destination | ||
) | const |
Returns true if the context has a valid datum transform to use when transforming from the specified source CRS to destination CRS.
Definition at line 134 of file qgscoordinatetransformcontext.cpp.
QgsCoordinateTransformContext & QgsCoordinateTransformContext::operator= | ( | const QgsCoordinateTransformContext & | rhs | ) |
Assignment operator.
Definition at line 33 of file qgscoordinatetransformcontext.cpp.
void QgsCoordinateTransformContext::readSettings | ( | ) |
Reads the context's state from application settings.
Definition at line 303 of file qgscoordinatetransformcontext.cpp.
bool QgsCoordinateTransformContext::readXml | ( | const QDomElement & | element, |
const QgsReadWriteContext & | context, | ||
QStringList & | missingTransforms | ||
) |
Reads the context's state from a DOM element.
Returns false if transforms stored in the XML are not available. In this case missingTransforms will be filled with missing datum transform strings.
Definition at line 167 of file qgscoordinatetransformcontext.cpp.
void QgsCoordinateTransformContext::removeSourceDestinationDatumTransform | ( | const QgsCoordinateReferenceSystem & | sourceCrs, |
const QgsCoordinateReferenceSystem & | destinationCrs | ||
) |
Removes the source to destination datum transform pair for the specified sourceCrs and destinationCrs.
Definition at line 129 of file qgscoordinatetransformcontext.cpp.
QMap< QPair< QString, QString >, QgsDatumTransform::TransformPair > QgsCoordinateTransformContext::sourceDestinationDatumTransforms | ( | ) | const |
Returns the stored mapping for source to destination CRS pairs to associated datum transforms to use.
The map keys will be QgsCoordinateReferenceSystems::authid()s.
If either the source transform ID or destination transform ID is -1, then no datum transform is required for transformations for that source or destination.
Definition at line 108 of file qgscoordinatetransformcontext.cpp.
void QgsCoordinateTransformContext::writeSettings | ( | ) |
Write the context's state to application settings.
Definition at line 360 of file qgscoordinatetransformcontext.cpp.
void QgsCoordinateTransformContext::writeXml | ( | QDomElement & | element, |
const QgsReadWriteContext & | context | ||
) | const |
Writes the context's state to a DOM element.
Definition at line 262 of file qgscoordinatetransformcontext.cpp.