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

A terrain provider where the terrain is a simple flat surface. More...

#include <qgsterrainprovider.h>

Inheritance diagram for QgsFlatTerrainProvider:
Inheritance graph
[legend]

Public Member Functions

 QgsFlatTerrainProvider ()=default
 Constructor for QgsFlatTerrainProvider. More...
 
QgsFlatTerrainProviderclone () 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...
 
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...
 
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 is a simple flat surface.

Since
QGIS 3.26

Definition at line 205 of file qgsterrainprovider.h.

Constructor & Destructor Documentation

◆ QgsFlatTerrainProvider()

QgsFlatTerrainProvider::QgsFlatTerrainProvider ( )
default

Constructor for QgsFlatTerrainProvider.

Member Function Documentation

◆ clone()

QgsFlatTerrainProvider * QgsFlatTerrainProvider::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 83 of file qgsterrainprovider.cpp.

◆ crs()

QgsCoordinateReferenceSystem QgsFlatTerrainProvider::crs ( ) const
overridevirtual

Returns the native coordinate reference system of the terrain provider.

Implements QgsAbstractTerrainProvider.

Definition at line 73 of file qgsterrainprovider.cpp.

◆ equals()

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

Returns true if the provider is equal to other.

Implements QgsAbstractTerrainProvider.

Definition at line 94 of file qgsterrainprovider.cpp.

◆ heightAt()

double QgsFlatTerrainProvider::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 78 of file qgsterrainprovider.cpp.

◆ prepare()

void QgsFlatTerrainProvider::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 88 of file qgsterrainprovider.cpp.

◆ readXml()

bool QgsFlatTerrainProvider::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 56 of file qgsterrainprovider.cpp.

◆ type()

QString QgsFlatTerrainProvider::type ( ) const
overridevirtual

Returns the unique type ID string for the provider.

Implements QgsAbstractTerrainProvider.

Definition at line 51 of file qgsterrainprovider.cpp.

◆ writeXml()

QDomElement QgsFlatTerrainProvider::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 66 of file qgsterrainprovider.cpp.


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