Class: QgsTemporalNavigationObject

class qgis.core.QgsTemporalNavigationObject

Bases: QgsTemporalController, QgsExpressionContextScopeGenerator

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

New in version 3.14.

QgsTemporalNavigationObject(parent: QObject = None) Constructor for QgsTemporalNavigationObject, with the specified parent object.

Methods

animationState

Returns the current animation state.

availableTemporalRanges

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

childEvent

connectNotify

createExpressionContextScope

rtype:

QgsExpressionContextScope

currentFrameNumber

Returns the current frame number.

customEvent

dateTimeRangeForFrameNumber

Calculates the temporal range associated with a particular animation frame.

disconnectNotify

findBestFrameNumberForFrameStart

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

frameDuration

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

framesPerSecond

Returns the animation frame rate, in frames per second.

isLooping

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

isSignalConnected

navigationMode

Returns the current temporal navigation mode.

next

Advances to the next frame.

pause

Pauses the temporal navigation.

play

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

playBackward

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

playForward

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

previous

Jumps back to the previous frame.

receivers

rewindToStart

Rewinds the temporal navigation to start of the temporal extent.

sender

senderSignalIndex

setAnimationState

Sets the current animation state.

setAvailableTemporalRanges

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

setCurrentFrameNumber

Sets the current animation frame number.

setFrameDuration

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

setFramesPerSecond

Sets the animation frame rate, in frames per second.

setLooping

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

setNavigationMode

Sets the temporal navigation mode.

setTemporalExtents

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

setTemporalRangeCumulative

Sets the animation temporal range as cumulative.

skipToEnd

Skips the temporal navigation to end of the temporal extent.

temporalExtents

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

temporalRangeCumulative

Returns the animation temporal range cumulative settings.

timerEvent

totalFrameCount

Returns the total number of frames for the navigation.

Signals

navigationModeChanged

pyqtSignal(*types, name: str = ..., revision: int = ..., arguments: Sequence = ...) -> PYQT_SIGNAL

stateChanged

pyqtSignal(*types, name: str = ..., revision: int = ..., arguments: Sequence = ...) -> PYQT_SIGNAL

temporalExtentsChanged

pyqtSignal(*types, name: str = ..., revision: int = ..., arguments: Sequence = ...) -> PYQT_SIGNAL

temporalFrameDurationChanged

pyqtSignal(*types, name: str = ..., revision: int = ..., arguments: Sequence = ...) -> PYQT_SIGNAL

Attributes

Animated

FixedRange

Forward

Idle

NavigationOff

Reverse

Animated = 1
class AnimationState

Bases: int

FixedRange = 2
Forward = 0
Idle = 2
class NavigationMode

Bases: int

NavigationOff = 0
Reverse = 1
animationState(self) QgsTemporalNavigationObject.AnimationState

Returns the current animation state.

Return type:

QgsTemporalNavigationObject.AnimationState

availableTemporalRanges(self) List[QgsDateTimeRange]

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.

New in version 3.20.

Return type:

List[QgsDateTimeRange]

childEvent(self, QChildEvent)
connectNotify(self, QMetaMethod)
createExpressionContextScope(self) QgsExpressionContextScope
Return type:

QgsExpressionContextScope

currentFrameNumber(self) int

Returns the current frame number.

Return type:

int

customEvent(self, QEvent)
dateTimeRangeForFrameNumber(self, frame: int) QgsDateTimeRange

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()).

Parameters:

frame (int) –

Return type:

QgsDateTimeRange

disconnectNotify(self, QMetaMethod)
findBestFrameNumberForFrameStart(self, frameStart: QDateTime | datetime.datetime) int

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

Parameters:

frameStart (Union[QDateTime) –

Return type:

int

frameDuration(self) QgsInterval

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

Return type:

QgsInterval

framesPerSecond(self) float

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.

Return type:

float

isLooping(self) bool

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

See also

setLooping()

Return type:

bool

isSignalConnected(self, QMetaMethod) bool
navigationMode(self) QgsTemporalNavigationObject.NavigationMode

Returns the current temporal navigation mode.

Return type:

QgsTemporalNavigationObject.NavigationMode

navigationModeChanged

pyqtSignal(*types, name: str = …, revision: int = …, arguments: Sequence = …) -> PYQT_SIGNAL

types is normally a sequence of individual types. Each type is either a type object or a string that is the name of a C++ type. Alternatively each type could itself be a sequence of types each describing a different overloaded signal. name is the optional C++ name of the signal. If it is not specified then the name of the class attribute that is bound to the signal is used. revision is the optional revision of the signal that is exported to QML. If it is not specified then 0 is used. arguments is the optional sequence of the names of the signal’s arguments.

Parameters:
  • name (str = ...) –

  • revision (int = ...) –

  • arguments (Sequence = ...) –

Return type:

PYQT_SIGNAL

next(self)

Advances to the next frame.

Note

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

pause(self)

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.

play(self)

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

playBackward(self)

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

playForward(self)

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

previous(self)

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.

receivers(self, PYQT_SIGNAL) int
rewindToStart(self)

Rewinds the temporal navigation to start of the temporal extent.

sender(self) QObject
senderSignalIndex(self) int
setAnimationState(self, state: QgsTemporalNavigationObject.AnimationState)

Sets the current animation state.

See also

animationState()

Parameters:

state (QgsTemporalNavigationObject.AnimationState) –

setAvailableTemporalRanges(self, ranges: Iterable[QgsDateTimeRange])

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.

New in version 3.20.

Parameters:

ranges (Iterable[QgsDateTimeRange]) –

setCurrentFrameNumber(self, frame: int)

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.

Parameters:

frame (int) –

setFrameDuration(self, duration: QgsInterval)

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()

Parameters:

duration (QgsInterval) –

setFramesPerSecond(self, rate: float)

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.

Parameters:

rate (float) –

setLooping(self, loop: bool)

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

See also

isLooping()

Parameters:

loop (bool) –

setNavigationMode(self, mode: QgsTemporalNavigationObject.NavigationMode)

Sets the temporal navigation mode.

See also

navigationMode()

Parameters:

mode (QgsTemporalNavigationObject.NavigationMode) –

setTemporalExtents(self, extents: QgsDateTimeRange)

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.

Parameters:

extents (QgsDateTimeRange) –

setTemporalRangeCumulative(self, state: bool)

Sets the animation temporal range as cumulative.

Parameters:

state (bool) –

skipToEnd(self)

Skips the temporal navigation to end of the temporal extent.

stateChanged

pyqtSignal(*types, name: str = …, revision: int = …, arguments: Sequence = …) -> PYQT_SIGNAL

types is normally a sequence of individual types. Each type is either a type object or a string that is the name of a C++ type. Alternatively each type could itself be a sequence of types each describing a different overloaded signal. name is the optional C++ name of the signal. If it is not specified then the name of the class attribute that is bound to the signal is used. revision is the optional revision of the signal that is exported to QML. If it is not specified then 0 is used. arguments is the optional sequence of the names of the signal’s arguments.

Parameters:
  • name (str = ...) –

  • revision (int = ...) –

  • arguments (Sequence = ...) –

Return type:

PYQT_SIGNAL

temporalExtents(self) QgsDateTimeRange

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

Return type:

QgsDateTimeRange

temporalExtentsChanged

pyqtSignal(*types, name: str = …, revision: int = …, arguments: Sequence = …) -> PYQT_SIGNAL

types is normally a sequence of individual types. Each type is either a type object or a string that is the name of a C++ type. Alternatively each type could itself be a sequence of types each describing a different overloaded signal. name is the optional C++ name of the signal. If it is not specified then the name of the class attribute that is bound to the signal is used. revision is the optional revision of the signal that is exported to QML. If it is not specified then 0 is used. arguments is the optional sequence of the names of the signal’s arguments.

Parameters:
  • name (str = ...) –

  • revision (int = ...) –

  • arguments (Sequence = ...) –

Return type:

PYQT_SIGNAL

temporalFrameDurationChanged

pyqtSignal(*types, name: str = …, revision: int = …, arguments: Sequence = …) -> PYQT_SIGNAL

types is normally a sequence of individual types. Each type is either a type object or a string that is the name of a C++ type. Alternatively each type could itself be a sequence of types each describing a different overloaded signal. name is the optional C++ name of the signal. If it is not specified then the name of the class attribute that is bound to the signal is used. revision is the optional revision of the signal that is exported to QML. If it is not specified then 0 is used. arguments is the optional sequence of the names of the signal’s arguments.

Parameters:
  • name (str = ...) –

  • revision (int = ...) –

  • arguments (Sequence = ...) –

Return type:

PYQT_SIGNAL

temporalRangeCumulative(self) bool

Returns the animation temporal range cumulative settings.

Return type:

bool

timerEvent(self, QTimerEvent)
totalFrameCount(self) int

Returns the total number of frames for the navigation.

Return type:

int