Terrain settings for a terrain generator that uses an online DEM to build terrain. More...

#include <qgsonlinedemterrainsettings.h>

Inheritance diagram for QgsOnlineDemTerrainSettings:

Public Member Functions
QgsOnlineDemTerrainSettings *	clone () const final
	Returns a copy of the terrain settings.

std::unique_ptr< QgsTerrainGenerator >	createTerrainGenerator (const Qgs3DRenderContext &context) const override
	Creates a new instance of a terrain generator which matches the terrain settings.

bool	equals (const QgsAbstractTerrainSettings *other) const final
	Returns `true` if this settings is exactly equal to another other settings.

void	readXml (const QDomElement &element, const QgsReadWriteContext &context) final
	Reads settings from a DOM element.

int	resolution () const
	Returns the resolution of the terrain (how many elevation samples are taken on one side of a terrain tile).

void	setResolution (int resolution)
	Sets the resolution of the terrain (how many elevation samples are taken on one side of a terrain tile).

void	setSkirtHeight (double height)
	Sets the skirt height (in world units).

double	skirtHeight () const
	Returns the skirt height (in world units).

QString	type () const final
	Returns the unique type name for the terrain generator.

void	writeXml (QDomElement &element, const QgsReadWriteContext &context) const final
	Writes settings to a DOM element.

Public Member Functions inherited from QgsAbstractTerrainSettings
virtual	~QgsAbstractTerrainSettings ()

double	elevationOffset () const
	Returns the elevation offset of the terrain (used to move the terrain up or down).

int	mapTileResolution () const
	Returns the resolution (in pixels) of the texture of a terrain tile.

double	maximumGroundError () const
	Returns the maximum ground error of terrain tiles in world units.

double	maximumScreenError () const
	Returns the maximum allowed screen error of terrain tiles in pixels.

virtual void	resolveReferences (const QgsProject *project)
	After reading settings from XML, resolves references to any layers in a project that have been read as layer IDs.

void	setElevationOffset (double offset)
	Sets the terrain elevation offset (used to move the terrain up or down).

void	setMapTileResolution (int resolution)
	Sets the resolution (in pixels) of the texture of a terrain tile.

void	setMaximumGroundError (double error)
	Sets the maximum ground error of terrain tiles in world units.

void	setMaximumScreenError (double error)
	Sets the maximum allowed screen error of terrain tiles in pixels.

void	setVerticalScale (double scale)
	Sets the vertical scale (exaggeration) for terrain.

double	verticalScale () const
	Returns the vertical scale (exaggeration) for terrain.

Static Public Member Functions
static QgsAbstractTerrainSettings *	create ()
	Creates a new instance of a QgsOnlineDemTerrainSettings object.

Additional Inherited Members
Protected Member Functions inherited from QgsAbstractTerrainSettings
void	copyCommonProperties (const QgsAbstractTerrainSettings *source)
	Copies common properties from a source object.

bool	equalsCommon (const QgsAbstractTerrainSettings *other) const
	Returns `true` if common base class settings from other match this object.

void	readCommonProperties (const QDomElement &element, const QgsReadWriteContext &context)
	Reads common properties from the base class from the given DOM element.

void	writeCommonProperties (QDomElement &element, const QgsReadWriteContext &context) const
	Writes common properties from the base class into an XML element.

Detailed Description

Terrain settings for a terrain generator that uses an online DEM to build terrain.

Warning: This is not considered stable API, and may change in future QGIS releases. It is exposed to the Python bindings as a tech preview only.

Since: QGIS 3.42

Definition at line 33 of file qgsonlinedemterrainsettings.h.

Member Function Documentation

◆ clone()

QgsOnlineDemTerrainSettings * QgsOnlineDemTerrainSettings::clone ( ) const

finalvirtual

Returns a copy of the terrain settings.

Implements QgsAbstractTerrainSettings.

Definition at line 28 of file qgsonlinedemterrainsettings.cpp.

◆ create()

QgsAbstractTerrainSettings * QgsOnlineDemTerrainSettings::create ( )

static

Creates a new instance of a QgsOnlineDemTerrainSettings object.

Definition at line 23 of file qgsonlinedemterrainsettings.cpp.

◆ createTerrainGenerator()

std::unique_ptr< QgsTerrainGenerator > QgsOnlineDemTerrainSettings::createTerrainGenerator ( const Qgs3DRenderContext & context ) const

overridevirtual

Creates a new instance of a terrain generator which matches the terrain settings.

Note: Not available in Python bindings

Implements QgsAbstractTerrainSettings.

Definition at line 77 of file qgsonlinedemterrainsettings.cpp.

◆ equals()

bool QgsOnlineDemTerrainSettings::equals ( const QgsAbstractTerrainSettings * other ) const

finalvirtual

Returns true if this settings is exactly equal to another other settings.

Implements QgsAbstractTerrainSettings.

Definition at line 64 of file qgsonlinedemterrainsettings.cpp.

◆ readXml()

void QgsOnlineDemTerrainSettings::readXml	(	const QDomElement &	element,
		const QgsReadWriteContext &	context
	)

finalvirtual

Reads settings from a DOM element.

Subclasses should take care to call readCommonProperties() to read common properties from the element.

See also: resolveReferences(); writeXml()

Implements QgsAbstractTerrainSettings.

Definition at line 38 of file qgsonlinedemterrainsettings.cpp.

◆ resolution()

int QgsOnlineDemTerrainSettings::resolution ( ) const

inline

Returns the resolution of the terrain (how many elevation samples are taken on one side of a terrain tile).

See also: resolution()

Definition at line 60 of file qgsonlinedemterrainsettings.h.

◆ setResolution()

void QgsOnlineDemTerrainSettings::setResolution ( int resolution )

inline

Sets the resolution of the terrain (how many elevation samples are taken on one side of a terrain tile).

See also: resolution()

Definition at line 53 of file qgsonlinedemterrainsettings.h.

◆ setSkirtHeight()

void QgsOnlineDemTerrainSettings::setSkirtHeight ( double height )

inline

Sets the skirt height (in world units).

Skirts at the edges of terrain tiles help hide cracks between adjacent tiles.

See also: skirtHeight()

Definition at line 69 of file qgsonlinedemterrainsettings.h.

◆ skirtHeight()

double QgsOnlineDemTerrainSettings::skirtHeight ( ) const

inline

Returns the skirt height (in world units).

Skirts at the edges of terrain tiles help hide cracks between adjacent tiles.

See also: setSkirtHeight()

Definition at line 78 of file qgsonlinedemterrainsettings.h.

◆ type()

QString QgsOnlineDemTerrainSettings::type ( ) const

finalvirtual

Returns the unique type name for the terrain generator.

Implements QgsAbstractTerrainSettings.

Definition at line 33 of file qgsonlinedemterrainsettings.cpp.

◆ writeXml()

void QgsOnlineDemTerrainSettings::writeXml	(	QDomElement &	element,
		const QgsReadWriteContext &	context
	)		const

finalvirtual

Writes settings to a DOM element.

Subclasses should take care to call writeCommonProperties() to write common properties to the element.

See also: readXml()

Implements QgsAbstractTerrainSettings.

Definition at line 56 of file qgsonlinedemterrainsettings.cpp.

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

/build/qgis-3.99.0+git20250718+f78f5286a64+99sid/src/3d/terrain/qgsonlinedemterrainsettings.h
/build/qgis-3.99.0+git20250718+f78f5286a64+99sid/src/3d/terrain/qgsonlinedemterrainsettings.cpp

Public Member Functions

Static Public Member Functions

Additional Inherited Members

Detailed Description

Member Function Documentation

◆ clone()

◆ create()

◆ createTerrainGenerator()

◆ equals()

◆ readXml()

◆ resolution()

◆ setResolution()

◆ setSkirtHeight()

◆ skirtHeight()

◆ type()

◆ writeXml()