QGIS API Documentation 3.27.0-Master (75dc696944)
Public Member Functions | List of all members
QgsRasterDemTerrainProvider Class Reference

A terrain provider where the terrain source is a raster DEM layer. More...

#include <qgsterrainprovider.h>

Inheritance diagram for QgsRasterDemTerrainProvider:
Inheritance graph
[legend]

Public Member Functions

 QgsRasterDemTerrainProvider ()=default
 Constructor for QgsRasterDemTerrainProvider. More...
 
QgsRasterDemTerrainProviderclone () const override
 Creates a clone of the provider and returns the new object. More...
 
QgsCoordinateReferenceSystem crs () const override
 Returns the native coordinate reference system of the terrain provider. More...
 
bool equals (const QgsAbstractTerrainProvider *other) const override
 Returns true if the provider is equal to other. More...
 
double heightAt (double x, double y) const override
 Returns the height at the point (x,y) in the terrain provider's native crs(). More...
 
QgsRasterLayerlayer () const
 Returns the raster layer with elevation model to be used as the terrain source. More...
 
const QgsRasterDemTerrainProvideroperator= (const QgsRasterDemTerrainProvider &other)=delete
 QgsRasterDemTerrainProvider cannot be assigned. More...
 
void prepare () override
 Called on the main thread prior to accessing the provider from a background thread. More...
 
bool readXml (const QDomElement &element, const QgsReadWriteContext &context) override
 Reads the terrain provider state from a DOM element. More...
 
void resolveReferences (const QgsProject *project) override
 Resolves reference to layers from stored layer ID (if it has not been resolved already) More...
 
void setLayer (QgsRasterLayer *layer)
 Sets the raster layer with elevation model to be used as the terrain source. More...
 
QString type () const override
 Returns the unique type ID string for the provider. More...
 
QDomElement writeXml (QDomDocument &document, const QgsReadWriteContext &context) const override
 Returns a DOM element representing the state of the terrain provider. More...
 
- Public Member Functions inherited from QgsAbstractTerrainProvider
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...
 

Additional Inherited Members

- Protected Member Functions inherited from QgsAbstractTerrainProvider
 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 inherited from QgsAbstractTerrainProvider
double mOffset = 0.0
 Offset amount. More...
 
double mScale = 1.0
 Scale factor. More...
 

Detailed Description

A terrain provider where the terrain source is a raster DEM layer.

Since
QGIS 3.26

Definition at line 230 of file qgsterrainprovider.h.

Constructor & Destructor Documentation

◆ QgsRasterDemTerrainProvider()

QgsRasterDemTerrainProvider::QgsRasterDemTerrainProvider ( )
default

Constructor for QgsRasterDemTerrainProvider.

Member Function Documentation

◆ clone()

QgsRasterDemTerrainProvider * QgsRasterDemTerrainProvider::clone ( ) const
overridevirtual

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

Ownership is transferred to the caller.

Implements QgsAbstractTerrainProvider.

Definition at line 180 of file qgsterrainprovider.cpp.

◆ crs()

QgsCoordinateReferenceSystem QgsRasterDemTerrainProvider::crs ( ) const
overridevirtual

Returns the native coordinate reference system of the terrain provider.

Implements QgsAbstractTerrainProvider.

Definition at line 153 of file qgsterrainprovider.cpp.

◆ equals()

bool QgsRasterDemTerrainProvider::equals ( const QgsAbstractTerrainProvider other) const
overridevirtual

Returns true if the provider is equal to other.

Implements QgsAbstractTerrainProvider.

Definition at line 185 of file qgsterrainprovider.cpp.

◆ heightAt()

double QgsRasterDemTerrainProvider::heightAt ( double  x,
double  y 
) const
overridevirtual

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.

Implements QgsAbstractTerrainProvider.

Definition at line 159 of file qgsterrainprovider.cpp.

◆ layer()

QgsRasterLayer * QgsRasterDemTerrainProvider::layer ( ) const

Returns the raster layer with elevation model to be used as the terrain source.

See also
layer()

Definition at line 212 of file qgsterrainprovider.cpp.

◆ operator=()

const QgsRasterDemTerrainProvider * QgsRasterDemTerrainProvider::operator= ( const QgsRasterDemTerrainProvider other)
delete

QgsRasterDemTerrainProvider cannot be assigned.

◆ prepare()

void QgsRasterDemTerrainProvider::prepare ( )
overridevirtual

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.

Implements QgsAbstractTerrainProvider.

Definition at line 199 of file qgsterrainprovider.cpp.

◆ readXml()

bool QgsRasterDemTerrainProvider::readXml ( const QDomElement &  element,
const QgsReadWriteContext context 
)
overridevirtual

Reads the terrain provider state from a DOM element.

See also
writeXml()

Implements QgsAbstractTerrainProvider.

Definition at line 122 of file qgsterrainprovider.cpp.

◆ resolveReferences()

void QgsRasterDemTerrainProvider::resolveReferences ( const QgsProject project)
overridevirtual

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

Reimplemented from QgsAbstractTerrainProvider.

Definition at line 114 of file qgsterrainprovider.cpp.

◆ setLayer()

void QgsRasterDemTerrainProvider::setLayer ( QgsRasterLayer layer)

Sets the raster layer with elevation model to be used as the terrain source.

See also
layer()

Definition at line 207 of file qgsterrainprovider.cpp.

◆ type()

QString QgsRasterDemTerrainProvider::type ( ) const
overridevirtual

Returns the unique type ID string for the provider.

Implements QgsAbstractTerrainProvider.

Definition at line 109 of file qgsterrainprovider.cpp.

◆ writeXml()

QDomElement QgsRasterDemTerrainProvider::writeXml ( QDomDocument &  document,
const QgsReadWriteContext context 
) const
overridevirtual

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

See also
readXml()

Implements QgsAbstractTerrainProvider.

Definition at line 138 of file qgsterrainprovider.cpp.


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