QgsProjectiveGeorefTransform Class Reference

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

#include <qgsgcptransformer.h>

Inheritance diagram for QgsProjectiveGeorefTransform:

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

Additional Inherited Members
Public Types inherited from QgsGcpTransformerInterface
enum class	TransformMethod : int {   Linear , Helmert , PolynomialOrder1 , PolynomialOrder2 ,   PolynomialOrder3 , ThinPlateSpline , Projective , 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.
static QgsGcpTransformerInterface *	createFromParameters (TransformMethod method, const QVector< QgsPointXY > &sourceCoordinates, const QVector< QgsPointXY > &destinationCoordinates)
	Creates a new QgsGcpTransformerInterface subclass representing the specified transform method, initialized using the given lists of source and destination coordinates.
static QString	methodToString (TransformMethod method)
	Returns a translated string representing the specified transform method.

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 256 of file qgsgcptransformer.h.

Constructor & Destructor Documentation

QgsProjectiveGeorefTransform()

QgsProjectiveGeorefTransform::QgsProjectiveGeorefTransform

(

)

Definition at line 433 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 437 of file qgsgcptransformer.cpp.

GDALTransformer()

GDALTransformerFunc QgsProjectiveGeorefTransform::GDALTransformer ( ) const

overridevirtual

Returns function pointer to the GDALTransformer function.

Implements QgsGcpTransformerInterface.

Definition at line 505 of file qgsgcptransformer.cpp.

GDALTransformerArgs()

void * QgsProjectiveGeorefTransform::GDALTransformerArgs ( ) const

overridevirtual

Returns pointer to the GDALTransformer arguments.

Implements QgsGcpTransformerInterface.

Definition at line 510 of file qgsgcptransformer.cpp.

method()

QgsGcpTransformerInterface::TransformMethod QgsProjectiveGeorefTransform::method ( ) const

overridevirtual

Returns the transformation method.

Implements QgsGcpTransformerInterface.

Definition at line 515 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 500 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 444 of file qgsgcptransformer.cpp.

---

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

• /build/qgis-3.99.0+git20250718+f78f5286a64+99sid/src/analysis/georeferencing/qgsgcptransformer.h
• /build/qgis-3.99.0+git20250718+f78f5286a64+99sid/src/analysis/georeferencing/qgsgcptransformer.cpp