QGIS API Documentation  3.26.3-Buenos Aires (65e4edfdad)
Public Member Functions | Protected Member Functions | Protected Attributes | List of all members
QgsAbstractTerrainProvider Class Referenceabstract

Abstract base class for terrain providers. More...

#include <qgsterrainprovider.h>

Inheritance diagram for QgsAbstractTerrainProvider:
Inheritance graph
[legend]

Public Member Functions

virtual ~QgsAbstractTerrainProvider ()
 
virtual QgsAbstractTerrainProviderclone () const =0
 Creates a clone of the provider and returns the new object. More...
 
virtual QgsCoordinateReferenceSystem crs () const =0
 Returns the native coordinate reference system of the terrain provider. More...
 
virtual bool equals (const QgsAbstractTerrainProvider *other) const =0
 Returns true if the provider is equal to other. More...
 
virtual double heightAt (double x, double y) const =0
 Returns the height at the point (x,y) in the terrain provider's native crs(). More...
 
double offset () const
 Returns the vertical offset value, used for adjusting the heights from the terrain provider. More...
 
QgsAbstractTerrainProvideroperator= (const QgsAbstractTerrainProvider &other)=delete
 QgsAbstractTerrainProvider cannot be assigned. More...
 
virtual void prepare ()=0
 Called on the main thread prior to accessing the provider from a background thread. More...
 
virtual bool readXml (const QDomElement &element, const QgsReadWriteContext &context)=0
 Reads the terrain provider state from a DOM element. More...
 
virtual void resolveReferences (const QgsProject *project)
 Resolves reference to layers from stored layer ID (if it has not been resolved already) More...
 
double scale () const
 Returns the vertical scale factor, which can be used to exaggerate vertical heights. More...
 
void setOffset (double offset)
 Returns the vertical offset value, used for adjusting the heights from the terrain provider. More...
 
void setScale (double scale)
 Sets the vertical scale factor, which can be used to exaggerate vertical heights. More...
 
virtual QString type () const =0
 Returns the unique type ID string for the provider. More...
 
virtual QDomElement writeXml (QDomDocument &document, const QgsReadWriteContext &context) const =0
 Returns a DOM element representing the state of the terrain provider. More...
 

Protected Member Functions

 QgsAbstractTerrainProvider ()=default
 Constructor for QgsAbstractTerrainProvider. More...
 
 QgsAbstractTerrainProvider (const QgsAbstractTerrainProvider &other)
 Copy constructor. More...
 
void readCommonProperties (const QDomElement &element, const QgsReadWriteContext &context)
 Reads common properties from a DOM element. More...
 
void writeCommonProperties (QDomElement &element, const QgsReadWriteContext &context) const
 Writes common properties to a DOM element. More...
 

Protected Attributes

double mOffset = 0.0
 Offset amount. More...
 
double mScale = 1.0
 Scale factor. More...
 

Detailed Description

Abstract base class for terrain providers.

Since
QGIS 3.26

Definition at line 40 of file qgsterrainprovider.h.

Constructor & Destructor Documentation

◆ ~QgsAbstractTerrainProvider()

QgsAbstractTerrainProvider::~QgsAbstractTerrainProvider ( )
virtualdefault

◆ QgsAbstractTerrainProvider() [1/2]

QgsAbstractTerrainProvider::QgsAbstractTerrainProvider ( )
protecteddefault

Constructor for QgsAbstractTerrainProvider.

◆ QgsAbstractTerrainProvider() [2/2]

QgsAbstractTerrainProvider::QgsAbstractTerrainProvider ( const QgsAbstractTerrainProvider other)
protected

Copy constructor.

Definition at line 28 of file qgsterrainprovider.cpp.

Member Function Documentation

◆ clone()

virtual QgsAbstractTerrainProvider* QgsAbstractTerrainProvider::clone ( ) const
pure virtual

Creates a clone of the provider and returns the new object.

Ownership is transferred to the caller.

Implemented in QgsMeshTerrainProvider, QgsRasterDemTerrainProvider, and QgsFlatTerrainProvider.

◆ crs()

virtual QgsCoordinateReferenceSystem QgsAbstractTerrainProvider::crs ( ) const
pure virtual

Returns the native coordinate reference system of the terrain provider.

Implemented in QgsMeshTerrainProvider, QgsRasterDemTerrainProvider, and QgsFlatTerrainProvider.

◆ equals()

virtual bool QgsAbstractTerrainProvider::equals ( const QgsAbstractTerrainProvider other) const
pure virtual

Returns true if the provider is equal to other.

Implemented in QgsMeshTerrainProvider, QgsRasterDemTerrainProvider, and QgsFlatTerrainProvider.

◆ heightAt()

virtual double QgsAbstractTerrainProvider::heightAt ( double  x,
double  y 
) const
pure virtual

Returns the height at the point (x,y) in the terrain provider's native crs().

Returns NaN if the height could not be obtained at the specified point.

Implemented in QgsMeshTerrainProvider, QgsRasterDemTerrainProvider, and QgsFlatTerrainProvider.

◆ offset()

double QgsAbstractTerrainProvider::offset ( ) const
inline

Returns the vertical offset value, used for adjusting the heights from the terrain provider.

See also
setOffset()
scale()

Definition at line 149 of file qgsterrainprovider.h.

◆ operator=()

QgsAbstractTerrainProvider& QgsAbstractTerrainProvider::operator= ( const QgsAbstractTerrainProvider other)
delete

QgsAbstractTerrainProvider cannot be assigned.

◆ prepare()

virtual void QgsAbstractTerrainProvider::prepare ( )
pure virtual

Called on the main thread prior to accessing the provider from a background thread.

Subclasses must implement suitable logic in order to prepare for thread-safe calculation of terrain heights on background threads.

Implemented in QgsMeshTerrainProvider, QgsRasterDemTerrainProvider, and QgsFlatTerrainProvider.

◆ readCommonProperties()

void QgsAbstractTerrainProvider::readCommonProperties ( const QDomElement &  element,
const QgsReadWriteContext context 
)
protected

Reads common properties from a DOM element.

Definition at line 41 of file qgsterrainprovider.cpp.

◆ readXml()

virtual bool QgsAbstractTerrainProvider::readXml ( const QDomElement &  element,
const QgsReadWriteContext context 
)
pure virtual

Reads the terrain provider state from a DOM element.

See also
writeXml()

Implemented in QgsMeshTerrainProvider, QgsRasterDemTerrainProvider, and QgsFlatTerrainProvider.

◆ resolveReferences()

void QgsAbstractTerrainProvider::resolveReferences ( const QgsProject project)
virtual

Resolves reference to layers from stored layer ID (if it has not been resolved already)

Reimplemented in QgsMeshTerrainProvider, and QgsRasterDemTerrainProvider.

Definition at line 23 of file qgsterrainprovider.cpp.

◆ scale()

double QgsAbstractTerrainProvider::scale ( ) const
inline

Returns the vertical scale factor, which can be used to exaggerate vertical heights.

See also
setScale()
offset()

Definition at line 133 of file qgsterrainprovider.h.

◆ setOffset()

void QgsAbstractTerrainProvider::setOffset ( double  offset)
inline

Returns the vertical offset value, used for adjusting the heights from the terrain provider.

See also
offset()
setScale()

Definition at line 157 of file qgsterrainprovider.h.

◆ setScale()

void QgsAbstractTerrainProvider::setScale ( double  scale)
inline

Sets the vertical scale factor, which can be used to exaggerate vertical heights.

See also
scale()
setOffset()

Definition at line 141 of file qgsterrainprovider.h.

◆ type()

virtual QString QgsAbstractTerrainProvider::type ( ) const
pure virtual

Returns the unique type ID string for the provider.

Implemented in QgsMeshTerrainProvider, QgsRasterDemTerrainProvider, and QgsFlatTerrainProvider.

◆ writeCommonProperties()

void QgsAbstractTerrainProvider::writeCommonProperties ( QDomElement &  element,
const QgsReadWriteContext context 
) const
protected

Writes common properties to a DOM element.

Definition at line 35 of file qgsterrainprovider.cpp.

◆ writeXml()

virtual QDomElement QgsAbstractTerrainProvider::writeXml ( QDomDocument &  document,
const QgsReadWriteContext context 
) const
pure virtual

Returns a DOM element representing the state of the terrain provider.

See also
readXml()

Implemented in QgsMeshTerrainProvider, QgsRasterDemTerrainProvider, and QgsFlatTerrainProvider.

Member Data Documentation

◆ mOffset

double QgsAbstractTerrainProvider::mOffset = 0.0
protected

Offset amount.

Definition at line 188 of file qgsterrainprovider.h.

◆ mScale

double QgsAbstractTerrainProvider::mScale = 1.0
protected

Scale factor.

Definition at line 185 of file qgsterrainprovider.h.


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