Implements a temporal controller based on a frame by frame navigation and animation. More...

#include <qgstemporalnavigationobject.h>

Inheritance diagram for QgsTemporalNavigationObject:

Public Types
enum	AnimationState { Forward , Reverse , Idle }
	Represents the current animation state. More...

enum	NavigationMode { NavigationOff , Animated , FixedRange }
	Represents the current temporal navigation mode. More...

Public Slots
void	next ()
	Advances to the next frame.

void	pause ()
	Pauses the temporal navigation.

void	play ()
	Starts playing the temporal navigation from its current frame, using the direction specified by animationState()

void	playBackward ()
	Starts the animation playing in a reverse direction until the beginning of the time range.

void	playForward ()
	Starts the animation playing in a forward direction up till the end of all frames.

void	previous ()
	Jumps back to the previous frame.

void	rewindToStart ()
	Rewinds the temporal navigation to start of the temporal extent.

void	skipToEnd ()
	Skips the temporal navigation to end of the temporal extent.

Signals
void	navigationModeChanged (QgsTemporalNavigationObject::NavigationMode mode)
	Emitted whenever the navigation mode changes.

void	stateChanged (QgsTemporalNavigationObject::AnimationState state)
	Emitted whenever the animation state changes.

void	temporalExtentsChanged (const QgsDateTimeRange &extent)
	Emitted whenever the temporalExtent extent changes.

void	temporalFrameDurationChanged (const QgsInterval &interval)
	Emitted whenever the frameDuration interval of the controller changes.

Signals inherited from QgsTemporalController
void	updateTemporalRange (const QgsDateTimeRange &range)
	Signals that a temporal range has changed and needs to be updated in all connected objects.

Public Member Functions
	QgsTemporalNavigationObject (QObject *parent=nullptr)
	Constructor for QgsTemporalNavigationObject, with the specified parent object.

AnimationState	animationState () const
	Returns the current animation state.

QList< QgsDateTimeRange >	availableTemporalRanges () const
	Returns the list of all available temporal ranges which have data available.

QgsExpressionContextScope *	createExpressionContextScope () const override
	This method needs to be reimplemented in all classes which implement this interface and return an expression context scope.

long long	currentFrameNumber () const
	Returns the current frame number.

QgsDateTimeRange	dateTimeRangeForFrameNumber (long long frame) const
	Calculates the temporal range associated with a particular animation frame.

long long	findBestFrameNumberForFrameStart (const QDateTime &frameStart) const
	Returns the best suited frame number for the specified datetime, based on the start of the corresponding temporal range.

QgsInterval	frameDuration () const
	Returns the current set frame duration, which dictates the temporal length of each frame in the animation.

double	framesPerSecond () const
	Returns the animation frame rate, in frames per second.

bool	isLooping () const
	Returns `true` if the animation should loop after hitting the end or start frame.

NavigationMode	navigationMode () const
	Returns the current temporal navigation mode.

void	setAnimationState (AnimationState state)
	Sets the current animation state.

void	setAvailableTemporalRanges (const QList< QgsDateTimeRange > &ranges)
	Sets the list of all available temporal ranges which have data available.

void	setCurrentFrameNumber (long long frame)
	Sets the current animation frame number.

void	setFrameDuration (const QgsInterval &duration)
	Sets the frame duration, which dictates the temporal length of each frame in the animation.

void	setFramesPerSecond (double rate)
	Sets the animation frame rate, in frames per second.

void	setLooping (bool loop)
	Sets whether the animation should loop after hitting the end or start frame.

void	setNavigationMode (const NavigationMode mode)
	Sets the temporal navigation mode.

void	setTemporalExtents (const QgsDateTimeRange &extents)
	Sets the navigation temporal extents, which dictate the earliest and latest date time possible in the animation.

void	setTemporalRangeCumulative (bool state)
	Sets the animation temporal range as cumulative.

QgsDateTimeRange	temporalExtents () const
	Returns the navigation temporal extents, which dictate the earliest and latest date time possible in the animation.

bool	temporalRangeCumulative () const
	Returns the animation temporal range cumulative settings.

long long	totalFrameCount () const
	Returns the total number of frames for the navigation.

Public Member Functions inherited from QgsTemporalController
	QgsTemporalController (QObject *parent=nullptr)
	Constructor for QgsTemporalController, with the specified parent object.

Public Member Functions inherited from QgsExpressionContextScopeGenerator
virtual	~QgsExpressionContextScopeGenerator ()=default

Detailed Description

Implements a temporal controller based on a frame by frame navigation and animation.

Since: QGIS 3.14

Definition at line 39 of file qgstemporalnavigationobject.h.

Member Enumeration Documentation

◆ AnimationState

enum QgsTemporalNavigationObject::AnimationState

Represents the current animation state.

Enumerator
Forward	Animation is playing forward.
Reverse	Animation is playing in reverse.
Idle	Animation is paused.

Definition at line 59 of file qgstemporalnavigationobject.h.

◆ NavigationMode

enum QgsTemporalNavigationObject::NavigationMode

Represents the current temporal navigation mode.

Enumerator
NavigationOff	Temporal navigation is disabled.
Animated	Temporal navigation relies on frames within a datetime range.
FixedRange	Temporal navigation relies on a fixed datetime range.

Definition at line 51 of file qgstemporalnavigationobject.h.

Constructor & Destructor Documentation

◆ QgsTemporalNavigationObject()

QgsTemporalNavigationObject::QgsTemporalNavigationObject ( QObject * parent = nullptr )

Constructor for QgsTemporalNavigationObject, with the specified parent object.

Definition at line 23 of file qgstemporalnavigationobject.cpp.

Member Function Documentation

◆ animationState()

QgsTemporalNavigationObject::AnimationState QgsTemporalNavigationObject::animationState ( ) const

Returns the current animation state.

See also: setAnimationState()

Definition at line 340 of file qgstemporalnavigationobject.cpp.

◆ availableTemporalRanges()

QList< QgsDateTimeRange > QgsTemporalNavigationObject::availableTemporalRanges ( ) const

Returns the list of all available temporal ranges which have data available.

The ranges list can be a list of non-contiguous ranges (i.e. containing gaps) which together describe the complete range of times which contain data.

See also: setAvailableTemporalRanges()

Since: QGIS 3.20

Definition at line 191 of file qgstemporalnavigationobject.cpp.

◆ createExpressionContextScope()

QgsExpressionContextScope * QgsTemporalNavigationObject::createExpressionContextScope ( ) const

overridevirtual

This method needs to be reimplemented in all classes which implement this interface and return an expression context scope.

Since: QGIS 3.0

Implements QgsExpressionContextScopeGenerator.

Definition at line 74 of file qgstemporalnavigationobject.cpp.

◆ currentFrameNumber()

long long QgsTemporalNavigationObject::currentFrameNumber ( ) const

Returns the current frame number.

See also: setCurrentFrameNumber()

Definition at line 208 of file qgstemporalnavigationobject.cpp.

◆ dateTimeRangeForFrameNumber()

QgsDateTimeRange QgsTemporalNavigationObject::dateTimeRangeForFrameNumber ( long long frame ) const

Calculates the temporal range associated with a particular animation frame.

This is calculated from the navigation start time (taken from temporalExtents()), the specified frame number, and the frame duration (see frameDuration()).

Definition at line 92 of file qgstemporalnavigationobject.cpp.

◆ findBestFrameNumberForFrameStart()

long long QgsTemporalNavigationObject::findBestFrameNumberForFrameStart ( const QDateTime & frameStart ) const

Returns the best suited frame number for the specified datetime, based on the start of the corresponding temporal range.

Definition at line 345 of file qgstemporalnavigationobject.cpp.

◆ frameDuration()

QgsInterval QgsTemporalNavigationObject::frameDuration ( ) const

Returns the current set frame duration, which dictates the temporal length of each frame in the animation.

See also: setFrameDuration()

Definition at line 233 of file qgstemporalnavigationobject.cpp.

◆ framesPerSecond()

double QgsTemporalNavigationObject::framesPerSecond ( ) const

Returns the animation frame rate, in frames per second.

This setting controls the overall playback speed of the animation, i.e. how quickly a playing animation will advance to the next frame.

See also: setFramesPerSecond()

Definition at line 247 of file qgstemporalnavigationobject.cpp.

◆ isLooping()

bool QgsTemporalNavigationObject::isLooping ( ) const

Returns true if the animation should loop after hitting the end or start frame.

See also: setLooping()

Definition at line 64 of file qgstemporalnavigationobject.cpp.

◆ navigationMode()

NavigationMode QgsTemporalNavigationObject::navigationMode ( ) const

inline

Returns the current temporal navigation mode.

See also: setNavigationMode()

Definition at line 92 of file qgstemporalnavigationobject.h.

◆ navigationModeChanged

void QgsTemporalNavigationObject::navigationModeChanged ( QgsTemporalNavigationObject::NavigationMode mode )

signal

Emitted whenever the navigation mode changes.

◆ next

void QgsTemporalNavigationObject::next ( )

slot

Advances to the next frame.

Note: Calling this slot does not change the current animation state, i.e. a paused animation will remain paused.

Definition at line 297 of file qgstemporalnavigationobject.cpp.

◆ pause

void QgsTemporalNavigationObject::pause ( )

slot

Pauses the temporal navigation.

Calling this slot changes the animation state to idle, preventing automatic advancement of frames.

It does not affect the current animation frame number or the current temporal range of the controller.

Definition at line 267 of file qgstemporalnavigationobject.cpp.

◆ play

void QgsTemporalNavigationObject::play ( )

slot

Starts playing the temporal navigation from its current frame, using the direction specified by animationState()

Definition at line 262 of file qgstemporalnavigationobject.cpp.

◆ playBackward

void QgsTemporalNavigationObject::playBackward ( )

slot

Starts the animation playing in a reverse direction until the beginning of the time range.

Definition at line 285 of file qgstemporalnavigationobject.cpp.

◆ playForward

void QgsTemporalNavigationObject::playForward ( )

slot

Starts the animation playing in a forward direction up till the end of all frames.

Definition at line 273 of file qgstemporalnavigationobject.cpp.

◆ previous

void QgsTemporalNavigationObject::previous ( )

slot

Jumps back to the previous frame.

Note: Calling this slot does not change the current animation state, i.e. a paused animation will remain paused.

Definition at line 302 of file qgstemporalnavigationobject.cpp.

◆ rewindToStart

void QgsTemporalNavigationObject::rewindToStart ( )

slot

Rewinds the temporal navigation to start of the temporal extent.

Definition at line 307 of file qgstemporalnavigationobject.cpp.

◆ setAnimationState()

void QgsTemporalNavigationObject::setAnimationState ( AnimationState state )

Sets the current animation state.

See also: animationState()

Definition at line 331 of file qgstemporalnavigationobject.cpp.

◆ setAvailableTemporalRanges()

void QgsTemporalNavigationObject::setAvailableTemporalRanges ( const QList< QgsDateTimeRange > & ranges )

Sets the list of all available temporal ranges which have data available.

The ranges list can be a list of non-contiguous ranges (i.e. containing gaps) which together describe the complete range of times which contain data.

See also: availableTemporalRanges()

Since: QGIS 3.20

Definition at line 186 of file qgstemporalnavigationobject.cpp.

◆ setCurrentFrameNumber()

void QgsTemporalNavigationObject::setCurrentFrameNumber ( long long frame )

Sets the current animation frame number.

Calling this method will change the controllers current datetime range to match, based on the temporalExtents() and frameDuration() values.

See also: currentFrameNumber()

Definition at line 196 of file qgstemporalnavigationobject.cpp.

◆ setFrameDuration()

void QgsTemporalNavigationObject::setFrameDuration ( const QgsInterval & duration )

Sets the frame duration, which dictates the temporal length of each frame in the animation.

Note: Calling this will reset the currentFrameNumber() to the closest temporal match for the previous temporal range.

See also: frameDuration()

Definition at line 213 of file qgstemporalnavigationobject.cpp.

◆ setFramesPerSecond()

void QgsTemporalNavigationObject::setFramesPerSecond ( double rate )

Sets the animation frame rate, in frames per second.

This setting controls the overall playback speed of the animation, i.e. how quickly a playing animation will advance to the next frame.

See also: framesPerSecond()

Definition at line 238 of file qgstemporalnavigationobject.cpp.

◆ setLooping()

void QgsTemporalNavigationObject::setLooping ( bool loop )

Sets whether the animation should loop after hitting the end or start frame.

See also: isLooping()

Definition at line 69 of file qgstemporalnavigationobject.cpp.

◆ setNavigationMode()

void QgsTemporalNavigationObject::setNavigationMode ( const NavigationMode mode )

Sets the temporal navigation mode.

See also: navigationMode()

Definition at line 124 of file qgstemporalnavigationobject.cpp.

◆ setTemporalExtents()

void QgsTemporalNavigationObject::setTemporalExtents ( const QgsDateTimeRange & extents )

Sets the navigation temporal extents, which dictate the earliest and latest date time possible in the animation.

Note: Calling this will reset the currentFrameNumber() to the first frame.

See also: temporalExtents()

Definition at line 149 of file qgstemporalnavigationobject.cpp.

◆ setTemporalRangeCumulative()

void QgsTemporalNavigationObject::setTemporalRangeCumulative ( bool state )

Sets the animation temporal range as cumulative.

See also: temporalRangeCumulative()

Definition at line 252 of file qgstemporalnavigationobject.cpp.

◆ skipToEnd

void QgsTemporalNavigationObject::skipToEnd ( )

slot

Skips the temporal navigation to end of the temporal extent.

Definition at line 312 of file qgstemporalnavigationobject.cpp.

◆ stateChanged

void QgsTemporalNavigationObject::stateChanged ( QgsTemporalNavigationObject::AnimationState state )

signal

Emitted whenever the animation state changes.

◆ temporalExtents()

QgsDateTimeRange QgsTemporalNavigationObject::temporalExtents ( ) const

Returns the navigation temporal extents, which dictate the earliest and latest date time possible in the animation.

See also: setTemporalExtents()

Definition at line 181 of file qgstemporalnavigationobject.cpp.

◆ temporalExtentsChanged

void QgsTemporalNavigationObject::temporalExtentsChanged ( const QgsDateTimeRange & extent )

signal

Emitted whenever the temporalExtent extent changes.

◆ temporalFrameDurationChanged

void QgsTemporalNavigationObject::temporalFrameDurationChanged ( const QgsInterval & interval )

signal

Emitted whenever the frameDuration interval of the controller changes.

◆ temporalRangeCumulative()

bool QgsTemporalNavigationObject::temporalRangeCumulative ( ) const

Returns the animation temporal range cumulative settings.

See also: setTemporalRangeCumulative()

Definition at line 257 of file qgstemporalnavigationobject.cpp.

◆ totalFrameCount()

long long QgsTemporalNavigationObject::totalFrameCount ( ) const

Returns the total number of frames for the navigation.

Definition at line 318 of file qgstemporalnavigationobject.cpp.

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

/build/qgis-3.34.0+99sid/src/core/qgstemporalnavigationobject.h
/build/qgis-3.34.0+99sid/src/core/qgstemporalnavigationobject.cpp

Public Types

Public Slots

Signals

Public Member Functions

Detailed Description

Member Enumeration Documentation

◆ AnimationState

◆ NavigationMode

Constructor & Destructor Documentation

◆ QgsTemporalNavigationObject()

Member Function Documentation

◆ animationState()

◆ availableTemporalRanges()

◆ createExpressionContextScope()

◆ currentFrameNumber()

◆ dateTimeRangeForFrameNumber()

◆ findBestFrameNumberForFrameStart()

◆ frameDuration()

◆ framesPerSecond()

◆ isLooping()

◆ navigationMode()

◆ navigationModeChanged

◆ next

◆ pause

◆ play

◆ playBackward

◆ playForward

◆ previous

◆ rewindToStart

◆ setAnimationState()

◆ setAvailableTemporalRanges()

◆ setCurrentFrameNumber()

◆ setFrameDuration()

◆ setFramesPerSecond()

◆ setLooping()

◆ setNavigationMode()

◆ setTemporalExtents()

◆ setTemporalRangeCumulative()

◆ skipToEnd

◆ stateChanged

◆ temporalExtents()

◆ temporalExtentsChanged

◆ temporalFrameDurationChanged

◆ temporalRangeCumulative()

◆ totalFrameCount()