QGIS API Documentation 3.41.0-Master (3440c17df1d)
Loading...
Searching...
No Matches
qgstemporalutils.h
Go to the documentation of this file.
1/***************************************************************************
2 qgstemporalutils.h
3 ------------------
4 Date : March 2020
5 Copyright : (C) 2020 by Nyall Dawson
6 Email : nyall dot dawson at gmail dot com
7 ***************************************************************************
8 * *
9 * This program is free software; you can redistribute it and/or modify *
10 * it under the terms of the GNU General Public License as published by *
11 * the Free Software Foundation; either version 2 of the License, or *
12 * (at your option) any later version. *
13 * *
14 ***************************************************************************/
15
16#ifndef QGSTEMPORALUTILS_H
17#define QGSTEMPORALUTILS_H
18
19#include "qgis_core.h"
20#include "qgsrange.h"
21#include "qgsinterval.h"
22
23class QgsProject;
24class QgsMapSettings;
25class QgsFeedback;
27
28#ifndef SIP_RUN
29
40class CORE_EXPORT QgsTimeDuration
41{
42 public:
43
45 int years = 0;
47 int months = 0;
49 int weeks = 0;
51 int days = 0;
53 int hours = 0;
55 int minutes = 0;
57 double seconds = 0;
58
62 bool isNull() const
63 {
64 return !years && !months && !days &&
65 !hours && !minutes && !seconds;
66 }
67
68 // TODO c++20 - replace with = default
69 bool operator==( const QgsTimeDuration &other ) const
70 {
71 return years == other.years && months == other.months && weeks == other.weeks &&
72 days == other.days && hours == other.hours &&
73 minutes == other.minutes && seconds == other.seconds;
74 }
75
76 bool operator!=( const QgsTimeDuration &other ) const
77 {
78 return !( *this == other );
79 }
80
84 QgsInterval toInterval() const;
85
89 QString toString() const;
90
97 long long toSeconds() const;
98
102 QDateTime addToDateTime( const QDateTime &dateTime );
103
107 static QgsTimeDuration fromString( const QString &string, bool &ok );
108
109};
110#endif
111
112
121class CORE_EXPORT QgsTemporalUtils
122{
123 public:
124
131 static QgsDateTimeRange calculateTemporalRangeForProject( QgsProject *project );
132
144 static QList< QgsDateTimeRange > usedTemporalRangesForProject( QgsProject *project );
145
148 {
151
154
157
166
168 QList<QgsMapDecoration *> decorations;
169
181 QList<QgsDateTimeRange> availableTemporalRanges;
182
188 double frameRate = 30;
189
190 };
191
209 static bool exportAnimation( const QgsMapSettings &mapSettings, const AnimationExportSettings &settings, QString &error SIP_OUT, QgsFeedback *feedback = nullptr );
210
232 static QDateTime calculateFrameTime( const QDateTime &start, const long long frame, const QgsInterval &interval );
233
245 static QList< QDateTime > calculateDateTimesUsingDuration( const QDateTime &start, const QDateTime &end, const QString &duration, bool &ok SIP_OUT, bool &maxValuesExceeded SIP_OUT, int maxValues = -1 );
246
247#ifndef SIP_RUN
248
260 static QList< QDateTime > calculateDateTimesUsingDuration( const QDateTime &start, const QDateTime &end, const QgsTimeDuration &duration, bool &maxValuesExceeded SIP_OUT, int maxValues = -1 );
261#endif
262
272 static QList< QDateTime > calculateDateTimesFromISO8601( const QString &string, bool &ok SIP_OUT, bool &maxValuesExceeded SIP_OUT, int maxValues = -1 );
273
274};
275
276
277#endif // QGSTEMPORALUTILS_H
Base class for feedback objects to be used for cancellation of something running in a worker thread.
Definition qgsfeedback.h:44
A representation of the interval between two datetime values.
Definition qgsinterval.h:46
Interface for map decorations.
The QgsMapSettings class contains configuration for rendering of the map.
Encapsulates a QGIS project, including sets of map layers and their styles, layouts,...
Definition qgsproject.h:107
Contains utility methods for working with temporal layers and projects.
Contains utility methods for working with temporal layers and projects.
bool operator!=(const QgsTimeDuration &other) const
bool operator==(const QgsTimeDuration &other) const
int minutes
Minutes.
double seconds
Seconds.
bool isNull() const
Returns true if the duration is null, i.e.
#define SIP_OUT
Definition qgis_sip.h:58
Contains settings relating to exporting animations.
QgsDateTimeRange animationRange
Dictates the overall temporal range of the animation.
QList< QgsDateTimeRange > availableTemporalRanges
Contains the list of all available temporal ranges which have data available.
QgsInterval frameDuration
Duration of individual export frames.
QString fileNameTemplate
The filename template for exporting the frames.
QString outputDirectory
Destination directory for created image files.
QList< QgsMapDecoration * > decorations
List of decorations to draw onto exported frames.