Implementation of map layer temporal properties for mesh layers. More...

#include <qgsmeshlayertemporalproperties.h>

Inheritance diagram for QgsMeshLayerTemporalProperties:

Public Member Functions
	QgsMeshLayerTemporalProperties (QObject *parent=nullptr, bool enabled=true)
	Constructor for QgsMeshLayerTemporalProperties. More...

QgsDateTimeRange	calculateTemporalExtent (QgsMapLayer *layer) const override
	Attempts to calculate the overall temporal extent for the specified layer, using the settings defined by the temporal properties object. More...

bool	isValid () const
	Returns whether the instance is valid. More...

QgsMeshDataProviderTemporalCapabilities::MatchingTemporalDatasetMethod	matchingMethod () const
	Returns the method used to match dataset from temporal capabilities. More...

bool	readXml (const QDomElement &element, const QgsReadWriteContext &context) override
	Reads temporal properties from a DOM element previously written by writeXml(). More...

QDateTime	referenceTime () const
	Returns the reference time. More...

void	setDefaultsFromDataProviderTemporalCapabilities (const QgsDataProviderTemporalCapabilities *capabilities) override
	Sets the layers temporal settings to appropriate defaults based on a provider's temporal capabilities. More...

void	setIsValid (bool isValid)
	Sets whether the instance is valid. More...

void	setMatchingMethod (const QgsMeshDataProviderTemporalCapabilities::MatchingTemporalDatasetMethod &matchingMethod)
	Sets the method used to match dataset from temporal capabilities. More...

void	setReferenceTime (const QDateTime &referenceTime, const QgsDataProviderTemporalCapabilities *capabilities)
	Sets the reference time and update the time extent from the temporal capabilities, if the temporal capabilities is null, set a void time extent (reference time to reference time) More...

QgsDateTimeRange	timeExtent () const
	Returns the time extent. More...

QDomElement	writeXml (QDomElement &element, QDomDocument &doc, const QgsReadWriteContext &context) override
	Writes the properties to a DOM element, to be used later with readXml(). More...

Public Member Functions inherited from QgsMapLayerTemporalProperties
	QgsMapLayerTemporalProperties (QObject *parent, bool enabled=false)
	Constructor for QgsMapLayerTemporalProperties, with the specified parent object. More...

virtual QList< QgsDateTimeRange >	allTemporalRanges (QgsMapLayer *layer) const
	Attempts to calculate the overall list of all temporal extents which are contained in the specified layer, using the settings defined by the temporal properties object. More...

virtual bool	isVisibleInTemporalRange (const QgsDateTimeRange &range) const
	Returns `true` if the layer should be visible and rendered for the specified time range. More...

Public Member Functions inherited from QgsTemporalProperty
	QgsTemporalProperty (QObject *parent=nullptr, bool enabled=false)
	Constructor for QgsTemporalProperty, with the specified parent object. More...

virtual QgsTemporalProperty::Flags	flags () const
	Returns flags associated to the temporal property. More...

bool	isActive () const
	Returns `true` if the temporal property is active. More...

void	setIsActive (bool active)
	Sets whether the temporal property is active. More...

Additional Inherited Members
Public Types inherited from QgsTemporalProperty
enum	Flag { FlagDontInvalidateCachedRendersWhenRangeChanges = 1 }
	Flags attached to the temporal property. More...

Signals inherited from QgsTemporalProperty
void	changed ()
	Emitted when the temporal properties have changed. More...

Detailed Description

Implementation of map layer temporal properties for mesh layers.

The time in a mesh layer is defined by :

a reference time provided by the data, the project or the user
each dataset is associated with a relative times
time extent is defined by the first time and the last time of all dataset

Reference time :          AT
Dataset 1 time            o-----RT------RT-----RT-----------RT
Dataset 2 time            o---------RT------RT--------RT
Dataset 3 time            o------------------------------RT-------RT----------RT
Time extent of layer      o-----<--------------------------------------------->
 
AT : absolute time (QDateTime)
RT : relative time (qint64)

Since: QGIS 3.14

Definition at line 51 of file qgsmeshlayertemporalproperties.h.

Constructor & Destructor Documentation

◆ QgsMeshLayerTemporalProperties()

QgsMeshLayerTemporalProperties::QgsMeshLayerTemporalProperties	(	QObject *	parent = `nullptr`,
		bool	enabled = `true`
	)

Constructor for QgsMeshLayerTemporalProperties.

Parameters

parent	pointer to the parent object
enabled	argument specifies whether the temporal properties are initially enabled or not (see isActive()).

Definition at line 23 of file qgsmeshlayertemporalproperties.cpp.

Member Function Documentation

◆ calculateTemporalExtent()

QgsDateTimeRange QgsMeshLayerTemporalProperties::calculateTemporalExtent ( QgsMapLayer * layer ) const

overridevirtual

Attempts to calculate the overall temporal extent for the specified layer, using the settings defined by the temporal properties object.

May return an infinite range if the extent could not be calculated.

Note: Not available in Python bindings

Reimplemented from QgsMapLayerTemporalProperties.

Definition at line 82 of file qgsmeshlayertemporalproperties.cpp.

◆ isValid()

bool QgsMeshLayerTemporalProperties::isValid ( ) const

Returns whether the instance is valid.

Since: QGIS 3.22

Definition at line 119 of file qgsmeshlayertemporalproperties.cpp.

◆ matchingMethod()

QgsMeshDataProviderTemporalCapabilities::MatchingTemporalDatasetMethod QgsMeshLayerTemporalProperties::matchingMethod ( ) const

Returns the method used to match dataset from temporal capabilities.

Definition at line 109 of file qgsmeshlayertemporalproperties.cpp.

◆ readXml()

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

overridevirtual

Reads temporal properties from a DOM element previously written by writeXml().

See also: writeXml()

Implements QgsMapLayerTemporalProperties.

Definition at line 43 of file qgsmeshlayertemporalproperties.cpp.

◆ referenceTime()

QDateTime QgsMeshLayerTemporalProperties::referenceTime ( ) const

Returns the reference time.

Definition at line 92 of file qgsmeshlayertemporalproperties.cpp.

◆ setDefaultsFromDataProviderTemporalCapabilities()

void QgsMeshLayerTemporalProperties::setDefaultsFromDataProviderTemporalCapabilities ( const QgsDataProviderTemporalCapabilities * capabilities )

overridevirtual

Sets the layers temporal settings to appropriate defaults based on a provider's temporal capabilities.

Implements QgsMapLayerTemporalProperties.

Definition at line 68 of file qgsmeshlayertemporalproperties.cpp.

◆ setIsValid()

void QgsMeshLayerTemporalProperties::setIsValid ( bool isValid )

Sets whether the instance is valid.

Parameters

isValid whether the instance is valid

Since: QGIS 3.22

Definition at line 124 of file qgsmeshlayertemporalproperties.cpp.

◆ setMatchingMethod()

void QgsMeshLayerTemporalProperties::setMatchingMethod ( const QgsMeshDataProviderTemporalCapabilities::MatchingTemporalDatasetMethod & matchingMethod )

Sets the method used to match dataset from temporal capabilities.

Parameters

matchingMethod the matching method

Definition at line 114 of file qgsmeshlayertemporalproperties.cpp.

◆ setReferenceTime()

void QgsMeshLayerTemporalProperties::setReferenceTime	(	const QDateTime &	referenceTime,
		const QgsDataProviderTemporalCapabilities *	capabilities
	)

Sets the reference time and update the time extent from the temporal capabilities, if the temporal capabilities is null, set a void time extent (reference time to reference time)

Parameters