QgsRasterProjector implements approximate projection support for it calculates grid of points in source CRS for target CRS + extent which are used to calculate affine transformation matrices. More...

#include <qgsrasterprojector.h>

Inheritance diagram for QgsRasterProjector:

[legend]

Public Types
enum	Precision { Approximate = 0, Exact = 1 }
	Precision defines if each pixel is reprojected or approximate reprojection based on an approximation matrix of reprojected points is used. More...

Public Types inherited from QgsRasterInterface
enum	Capability { NoCapabilities = 0, Size = 1 << 1, Create = 1 << 2, Remove = 1 << 3, BuildPyramids = 1 << 4, Identify = 1 << 5, IdentifyValue = 1 << 6, IdentifyText = 1 << 7, IdentifyHtml = 1 << 8, IdentifyFeature = 1 << 9 }
	If you add to this, please also add to capabilitiesString() More...

Public Member Functions
Q_DECL_DEPRECATED	QgsRasterProjector (const QgsCoordinateReferenceSystem &theSrcCRS, const QgsCoordinateReferenceSystem &theDestCRS, int theSrcDatumTransform, int theDestDatumTransform, const QgsRectangle &theDestExtent, int theDestRows, int theDestCols, double theMaxSrcXRes, double theMaxSrcYRes, const QgsRectangle &theExtent)

Q_DECL_DEPRECATED	QgsRasterProjector (const QgsCoordinateReferenceSystem &theSrcCRS, const QgsCoordinateReferenceSystem &theDestCRS, const QgsRectangle &theDestExtent, int theDestRows, int theDestCols, double theMaxSrcXRes, double theMaxSrcYRes, const QgsRectangle &theExtent)

Q_DECL_DEPRECATED	QgsRasterProjector (const QgsCoordinateReferenceSystem &theSrcCRS, const QgsCoordinateReferenceSystem &theDestCRS, double theMaxSrcXRes, double theMaxSrcYRes, const QgsRectangle &theExtent)

	QgsRasterProjector ()

Q_DECL_DEPRECATED	QgsRasterProjector (const QgsRasterProjector &projector)
	Copy constructor. More...

	~QgsRasterProjector ()
	The destructor. More...

int	bandCount () const override
	Get number of bands. More...

QgsRasterBlock *	block (int bandNo, const QgsRectangle &extent, int width, int height) override
	Read block of data using given extent and size. More...

QgsRasterBlock *	block2 (int bandNo, const QgsRectangle &extent, int width, int height, QgsRasterBlockFeedback *feedback=nullptr) override
	Read block of data using given extent and size. More...

QgsRasterProjector *	clone () const override
	Clone itself, create deep copy. More...

QGis::DataType	dataType (int bandNo) const override
	Returns data type for the band specified by number. More...

QgsCoordinateReferenceSystem	destCrs () const
	Get destination CRS. More...

bool	destExtentSize (const QgsRectangle &theSrcExtent, int theSrcXSize, int theSrcYSize, QgsRectangle &theDestExtent, int &theDestXSize, int &theDestYSize)
	Calculate destination extent and size from source extent and size. More...

QgsRasterProjector &	operator= (const QgsRasterProjector &projector)

Precision	precision () const

void	setCRS (const QgsCoordinateReferenceSystem &theSrcCRS, const QgsCoordinateReferenceSystem &theDestCRS, int srcDatumTransform=-1, int destDatumTransform=-1)
	set source and destination CRS More...

Q_DECL_DEPRECATED void	setMaxSrcRes (double theMaxSrcXRes, double theMaxSrcYRes)

void	setPrecision (Precision precision)

QgsCoordinateReferenceSystem	srcCrs () const
	Get source CRS. More...

Public Member Functions inherited from QgsRasterInterface
	QgsRasterInterface (QgsRasterInterface *input=nullptr)

virtual	~QgsRasterInterface ()

virtual QgsRasterBandStats	bandStatistics (int theBandNo, int theStats=QgsRasterBandStats::All, const QgsRectangle &theExtent=QgsRectangle(), int theSampleSize=0)
	Get band statistics. More...

virtual int	capabilities () const
	Returns a bitmask containing the supported capabilities. More...

QString	capabilitiesString () const
	Returns the above in friendly format. More...

virtual void	cumulativeCut (int theBandNo, double theLowerCount, double theUpperCount, double &theLowerValue, double &theUpperValue, const QgsRectangle &theExtent=QgsRectangle(), int theSampleSize=0)
	Find values for cumulative pixel count cut. More...

int	dataTypeSize (int bandNo)

virtual QgsRectangle	extent ()
	Get the extent of the interface. More...

virtual QString	generateBandName (int theBandNumber) const
	helper function to create zero padded band names More...

virtual bool	hasHistogram (int theBandNo, int theBinCount, double theMinimum=std::numeric_limits< double >::quiet_NaN(), double theMaximum=std::numeric_limits< double >::quiet_NaN(), const QgsRectangle &theExtent=QgsRectangle(), int theSampleSize=0, bool theIncludeOutOfRange=false)
	Returns true if histogram is available (cached, already calculated), the parameters are the same as in histogram() More...

virtual bool	hasStatistics (int theBandNo, int theStats=QgsRasterBandStats::All, const QgsRectangle &theExtent=QgsRectangle(), int theSampleSize=0)
	Returns true if histogram is available (cached, already calculated). More...

virtual QgsRasterHistogram	histogram (int theBandNo, int theBinCount=0, double theMinimum=std::numeric_limits< double >::quiet_NaN(), double theMaximum=std::numeric_limits< double >::quiet_NaN(), const QgsRectangle &theExtent=QgsRectangle(), int theSampleSize=0, bool theIncludeOutOfRange=false)
	Get histogram. More...

virtual QgsRasterInterface *	input () const
	Current input. More...

virtual bool	on () const
	Is on/off. More...

virtual void	readXML (const QDomElement &filterElem)
	Sets base class members from xml. More...

virtual bool	setInput (QgsRasterInterface *input)
	Set input. More...

virtual void	setOn (bool on)
	Set on/off. More...

virtual QGis::DataType	srcDataType (int bandNo) const
	Returns source data type for the band specified by number, source data type may be shorter than dataType. More...

virtual const QgsRasterInterface *	srcInput () const
	Get source / raw input, the first in pipe, usually provider. More...

virtual QgsRasterInterface *	srcInput ()

virtual void	writeXML (QDomDocument &doc, QDomElement &parentElem) const
	Write base class members to xml. More...

virtual int	xBlockSize () const
	Get block size. More...

virtual int	xSize () const
	Get raster size. More...

virtual int	yBlockSize () const

virtual int	ySize () const

Static Public Member Functions
static bool	extentSize (const QgsCoordinateTransform *ct, const QgsRectangle &theSrcExtent, int theSrcXSize, int theSrcYSize, QgsRectangle &theDestExtent, int &theDestXSize, int &theDestYSize)
	Calculate destination extent and size from source extent and size. More...

static QString	precisionLabel (Precision precision)

Additional Inherited Members
Protected Member Functions inherited from QgsRasterInterface
void	initHistogram (QgsRasterHistogram &theHistogram, int theBandNo, int theBinCount=0, double theMinimum=std::numeric_limits< double >::quiet_NaN(), double theMaximum=std::numeric_limits< double >::quiet_NaN(), const QgsRectangle &theExtent=QgsRectangle(), int theSampleSize=0, bool theIncludeOutOfRange=false)
	Fill in histogram defaults if not specified. More...

void	initStatistics (QgsRasterBandStats &theStatistics, int theBandNo, int theStats=QgsRasterBandStats::All, const QgsRectangle &theExtent=QgsRectangle(), int theBinCount=0)
	Fill in statistics defaults if not specified. More...

Protected Attributes inherited from QgsRasterInterface
QList< QgsRasterHistogram >	mHistograms
	List of cached histograms, all bands mixed. More...

QgsRasterInterface *	mInput

bool	mOn

QList< QgsRasterBandStats >	mStatistics
	List of cached statistics, all bands mixed. More...

Detailed Description

QgsRasterProjector implements approximate projection support for it calculates grid of points in source CRS for target CRS + extent which are used to calculate affine transformation matrices.

Definition at line 44 of file qgsrasterprojector.h.

Member Enumeration Documentation

◆ Precision

enum QgsRasterProjector::Precision

Precision defines if each pixel is reprojected or approximate reprojection based on an approximation matrix of reprojected points is used.

Enumerator
Approximate	Approximate (default), fast but possibly inaccurate.
Exact	Exact, precise but slow.

Definition at line 50 of file qgsrasterprojector.h.

Constructor & Destructor Documentation

◆ QgsRasterProjector() [1/5]

QgsRasterProjector::QgsRasterProjector	(	const QgsCoordinateReferenceSystem &	theSrcCRS,
		const QgsCoordinateReferenceSystem &	theDestCRS,
		int	theSrcDatumTransform,
		int	theDestDatumTransform,
		const QgsRectangle &	theDestExtent,
		int	theDestRows,
		int	theDestCols,
		double	theMaxSrcXRes,
		double	theMaxSrcYRes,
		const QgsRectangle &	theExtent
	)

Deprecated:: since 2.18: use default constructor

Definition at line 25 of file qgsrasterprojector.cpp.

◆ QgsRasterProjector() [2/5]

QgsRasterProjector::QgsRasterProjector	(	const QgsCoordinateReferenceSystem &	theSrcCRS,
		const QgsCoordinateReferenceSystem &	theDestCRS,
		const QgsRectangle &	theDestExtent,
		int	theDestRows,
		int	theDestCols,
		double	theMaxSrcXRes,
		double	theMaxSrcYRes,
		const QgsRectangle &	theExtent
	)

Deprecated:: since 2.18: use default constructor

Definition at line 50 of file qgsrasterprojector.cpp.

◆ QgsRasterProjector() [3/5]

QgsRasterProjector::QgsRasterProjector	(	const QgsCoordinateReferenceSystem &	theSrcCRS,
		const QgsCoordinateReferenceSystem &	theDestCRS,
		double	theMaxSrcXRes,
		double	theMaxSrcYRes,
		const QgsRectangle &	theExtent
	)

Deprecated:: since 2.18: use default constructor

Definition at line 73 of file qgsrasterprojector.cpp.

◆ QgsRasterProjector() [4/5]

QgsRasterProjector::QgsRasterProjector ( )

Definition at line 91 of file qgsrasterprojector.cpp.

◆ QgsRasterProjector() [5/5]

QgsRasterProjector::QgsRasterProjector ( const QgsRasterProjector & projector )

Copy constructor.

Deprecated:: since 2.18: use clone()

Definition at line 100 of file qgsrasterprojector.cpp.

◆ ~QgsRasterProjector()

QgsRasterProjector::~QgsRasterProjector ( )

The destructor.

Definition at line 136 of file qgsrasterprojector.cpp.

Member Function Documentation

◆ bandCount()

int QgsRasterProjector::bandCount ( ) const

overridevirtual

Get number of bands.

Implements QgsRasterInterface.

Definition at line 140 of file qgsrasterprojector.cpp.

◆ block()

QgsRasterBlock * QgsRasterProjector::block	(	int	bandNo,
		const QgsRectangle &	extent,
		int	width,
		int	height
	)

overridevirtual

Read block of data using given extent and size.

Returns pointer to data. Caller is responsible to free the memory returned.

Parameters

bandNo	band number
extent	extent of block
width	pixel width of block
height	pixel height of block

Implements QgsRasterInterface.

Definition at line 834 of file qgsrasterprojector.cpp.

◆ block2()

QgsRasterBlock * QgsRasterProjector::block2	(	int	bandNo,
		const QgsRectangle &	extent,
		int	width,
		int	height,
		QgsRasterBlockFeedback *	feedback = `nullptr`
	)

overridevirtual

Read block of data using given extent and size.

Returns pointer to data. Caller is responsible to free the memory returned.

Parameters

bandNo	band number
extent	extent of block
width	pixel width of block
height	pixel height of block
feedback	optional raster feedback object for cancellation/preview

Note: This is extended version of block() method. Default implementation falls back to calling block().; Added in QGIS 2.18

Reimplemented from QgsRasterInterface.

Definition at line 839 of file qgsrasterprojector.cpp.

◆ clone()

QgsRasterProjector * QgsRasterProjector::clone ( ) const

overridevirtual

Clone itself, create deep copy.

Implements QgsRasterInterface.

Definition at line 124 of file qgsrasterprojector.cpp.

◆ dataType()

QGis::DataType QgsRasterProjector::dataType ( int bandNo ) const

overridevirtual

Returns data type for the band specified by number.

Implements QgsRasterInterface.

Definition at line 147 of file qgsrasterprojector.cpp.

◆ destCrs()

QgsCoordinateReferenceSystem QgsRasterProjector::destCrs ( ) const

inline

Get destination CRS.

Definition at line 111 of file qgsrasterprojector.h.

◆ destExtentSize()

bool QgsRasterProjector::destExtentSize	(	const QgsRectangle &	theSrcExtent,
		int	theSrcXSize,
		int	theSrcYSize,
		QgsRectangle &	theDestExtent,
		int &	theDestXSize,
		int &	theDestYSize
	)

Calculate destination extent and size from source extent and size.

Definition at line 952 of file qgsrasterprojector.cpp.

◆ extentSize()

bool QgsRasterProjector::extentSize	(	const QgsCoordinateTransform *	ct,
		const QgsRectangle &	theSrcExtent,
		int	theSrcXSize,
		int	theSrcYSize,
		QgsRectangle &	theDestExtent,
		int &	theDestXSize,
		int &	theDestYSize
	)

static

Calculate destination extent and size from source extent and size.

Definition at line 964 of file qgsrasterprojector.cpp.

◆ operator=()

QgsRasterProjector & QgsRasterProjector::operator= ( const QgsRasterProjector & projector )

Definition at line 110 of file qgsrasterprojector.cpp.

◆ precision()

Precision QgsRasterProjector::precision ( ) const

inline

Definition at line 116 of file qgsrasterprojector.h.

◆ precisionLabel()

QString QgsRasterProjector::precisionLabel ( Precision precision )

static

Definition at line 822 of file qgsrasterprojector.cpp.

◆ setCRS()

void QgsRasterProjector::setCRS	(	const QgsCoordinateReferenceSystem &	theSrcCRS,
		const QgsCoordinateReferenceSystem &	theDestCRS,
		int	srcDatumTransform = `-1`,
		int	destDatumTransform = `-1`
	)

set source and destination CRS

◆ setMaxSrcRes()

Q_DECL_DEPRECATED void QgsRasterProjector::setMaxSrcRes	(	double	theMaxSrcXRes,
		double	theMaxSrcYRes
	)

inline

Deprecated:: since 2.18, does nothing

Definition at line 114 of file qgsrasterprojector.h.

◆ setPrecision()

void QgsRasterProjector::setPrecision ( Precision precision )

inline

Definition at line 117 of file qgsrasterprojector.h.

◆ srcCrs()

QgsCoordinateReferenceSystem QgsRasterProjector::srcCrs ( ) const

inline

Get source CRS.

Definition at line 108 of file qgsrasterprojector.h.

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

/tmp/buildd/qgis-2.18.21+99unstable/src/core/raster/qgsrasterprojector.h
/tmp/buildd/qgis-2.18.21+99unstable/src/core/raster/qgsrasterprojector.cpp

Public Types

Public Member Functions

Static Public Member Functions

Additional Inherited Members

Detailed Description

Member Enumeration Documentation

◆ Precision

Constructor & Destructor Documentation

◆ QgsRasterProjector() [1/5]

◆ QgsRasterProjector() [2/5]

◆ QgsRasterProjector() [3/5]

◆ QgsRasterProjector() [4/5]

◆ QgsRasterProjector() [5/5]

◆ ~QgsRasterProjector()

Member Function Documentation

◆ bandCount()

◆ block()

◆ block2()

◆ clone()

◆ dataType()

◆ destCrs()

◆ destExtentSize()

◆ extentSize()

◆ operator=()

◆ precision()

◆ precisionLabel()

◆ setCRS()

◆ setMaxSrcRes()

◆ setPrecision()

◆ srcCrs()