QgsProjectiveGeorefTransform Class Reference

A planar projective transform, expressed by a homography. More...

#include <qgsgcptransformer.h>

Inheritance diagram for QgsProjectiveGeorefTransform:

Public Member Functions
	QgsProjectiveGeorefTransform ()
	Constructor for QgsProjectiveGeorefTransform. More...
QgsGcpTransformerInterface *	clone () const override
	Clones the transformer, returning a new copy of the transformer with the same parameters as this one. More...
GDALTransformerFunc	GDALTransformer () const override
	Returns function pointer to the GDALTransformer function. More...
void *	GDALTransformerArgs () const override
	Returns pointer to the GDALTransformer arguments. More...
TransformMethod	method () const override
	Returns the transformation method. More...
int	minimumGcpCount () const override
	Returns the minimum number of Ground Control Points (GCPs) required for parameter fitting. More...
bool	updateParametersFromGcps (const QVector< QgsPointXY > &sourceCoordinates, const QVector< QgsPointXY > &destinationCoordinates, bool invertYAxis=false) override
	Fits transformation parameters using the specified Ground Control Points (GCPs) lists of source and destination coordinates. More...
Public Member Functions inherited from QgsGcpTransformerInterface
	QgsGcpTransformerInterface ()=default
	Constructor for QgsGcpTransformerInterface. More...
	QgsGcpTransformerInterface (const QgsGcpTransformerInterface &other)=delete
	QgsGcpTransformerInterface cannot be copied - use clone() instead. More...
virtual	~QgsGcpTransformerInterface ()=default
QgsGcpTransformerInterface &	operator= (const QgsGcpTransformerInterface &other)=delete
	QgsGcpTransformerInterface cannot be copied - use clone() instead. More...
bool	transform (double &x, double &y, bool inverseTransform=false) const
	Transforms the point (x, y) from source to destination coordinates. More...

Additional Inherited Members
Public Types inherited from QgsGcpTransformerInterface
enum	TransformMethod : int {   TransformMethod::Linear, TransformMethod::Helmert, TransformMethod::PolynomialOrder1, TransformMethod::PolynomialOrder2,   TransformMethod::PolynomialOrder3, TransformMethod::ThinPlateSpline, TransformMethod::Projective, TransformMethod::InvalidTransform = 65535 }
	Available transformation methods. More...
Static Public Member Functions inherited from QgsGcpTransformerInterface
static QgsGcpTransformerInterface *	create (TransformMethod method)
	Creates a new QgsGcpTransformerInterface subclass representing the specified transform method. More...
static QgsGcpTransformerInterface *	createFromParameters (TransformMethod method, const QVector< QgsPointXY > &sourceCoordinates, const QVector< QgsPointXY > &destinationCoordinates) SIP_THROW(QgsNotSupportedException)
	Creates a new QgsGcpTransformerInterface subclass representing the specified transform method, initialized using the given lists of source and destination coordinates. More...
static QString	methodToString (TransformMethod method)
	Returns a translated string representing the specified transform method. More...

Detailed Description

A planar projective transform, expressed by a homography.

Implements model fitting which minimizes algebraic error using total least squares.

Note

Not available in Python bindings

Since

QGIS 3.20

Definition at line 269 of file qgsgcptransformer.h.

Constructor & Destructor Documentation

QgsProjectiveGeorefTransform()

QgsProjectiveGeorefTransform::QgsProjectiveGeorefTransform

(

)

Constructor for QgsProjectiveGeorefTransform.

Definition at line 435 of file qgsgcptransformer.cpp.

Member Function Documentation

clone()

QgsGcpTransformerInterface * QgsProjectiveGeorefTransform::clone ( ) const

overridevirtual

Clones the transformer, returning a new copy of the transformer with the same parameters as this one.

Caller takes ownership of the returned object.

Implements QgsGcpTransformerInterface.

Definition at line 439 of file qgsgcptransformer.cpp.

GDALTransformer()

GDALTransformerFunc QgsProjectiveGeorefTransform::GDALTransformer ( ) const

overridevirtual

Returns function pointer to the GDALTransformer function.

Implements QgsGcpTransformerInterface.

Definition at line 507 of file qgsgcptransformer.cpp.

GDALTransformerArgs()

void * QgsProjectiveGeorefTransform::GDALTransformerArgs ( ) const

overridevirtual

Returns pointer to the GDALTransformer arguments.

Implements QgsGcpTransformerInterface.

Definition at line 512 of file qgsgcptransformer.cpp.

method()

QgsGcpTransformerInterface::TransformMethod QgsProjectiveGeorefTransform::method ( ) const

overridevirtual

Returns the transformation method.

Implements QgsGcpTransformerInterface.

Definition at line 517 of file qgsgcptransformer.cpp.

minimumGcpCount()

int QgsProjectiveGeorefTransform::minimumGcpCount ( ) const

overridevirtual

Returns the minimum number of Ground Control Points (GCPs) required for parameter fitting.

Implements QgsGcpTransformerInterface.

Definition at line 502 of file qgsgcptransformer.cpp.

updateParametersFromGcps()

bool QgsProjectiveGeorefTransform::updateParametersFromGcps ( const QVector< QgsPointXY > &  sourceCoordinates, const QVector< QgsPointXY > &  destinationCoordinates, bool  invertYAxis = false  )

overridevirtual

Fits transformation parameters using the specified Ground Control Points (GCPs) lists of source and destination coordinates.

If invertYAxis is set to true then the y-axis of source coordinates will be inverted, e.g. to allow for transformation of raster layers with ascending top-to-bottom vertical axis coordinates.

Returns

true on success, false on failure

Implements QgsGcpTransformerInterface.

Definition at line 446 of file qgsgcptransformer.cpp.

---

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

• /build/qgis-3.26.3+32focal/src/analysis/georeferencing/qgsgcptransformer.h
• /build/qgis-3.26.3+32focal/src/analysis/georeferencing/qgsgcptransformer.cpp