QGIS API Documentation 3.28.0-Firenze (ed3ad0430f)
Classes | Public Member Functions | List of all members
QgsProjectiveGeorefTransform Class Reference

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

#include <qgsgcptransformer.h>

Inheritance diagram for QgsProjectiveGeorefTransform:
Inheritance graph
[legend]

Public Member Functions

 QgsProjectiveGeorefTransform ()
 Constructor for QgsProjectiveGeorefTransform. More...
 
QgsGcpTransformerInterfaceclone () 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
 
virtual QgsGcpTransformerInterfaceclone () const =0
 Clones the transformer, returning a new copy of the transformer with the same parameters as this one. More...
 
virtual GDALTransformerFunc GDALTransformer () const =0
 Returns function pointer to the GDALTransformer function. More...
 
virtual void * GDALTransformerArgs () const =0
 Returns pointer to the GDALTransformer arguments. More...
 
virtual TransformMethod method () const =0
 Returns the transformation method. More...
 
virtual int minimumGcpCount () const =0
 Returns the minimum number of Ground Control Points (GCPs) required for parameter fitting. More...
 
QgsGcpTransformerInterfaceoperator= (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...
 
virtual bool updateParametersFromGcps (const QVector< QgsPointXY > &sourceCoordinates, const QVector< QgsPointXY > &destinationCoordinates, bool invertYAxis=false) SIP_THROW(QgsNotSupportedException)=0
 Fits transformation parameters using the specified Ground Control Points (GCPs) lists of source and destination coordinates. More...
 

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 QgsGcpTransformerInterfacecreate (TransformMethod method)
 Creates a new QgsGcpTransformerInterface subclass representing the specified transform method. More...
 
static QgsGcpTransformerInterfacecreateFromParameters (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: