vcs.maemo.org Git - kitchenalert/blob - src/timer.h

   1 /**************************************************************************
   2         KitchenAlert
   3
   4         Copyright (C) 2010-2011  Heli Hyvättinen
   5
   6         This file is part of KitchenAlert.
   7
   8         Kitchen Alert is free software: you can redistribute it and/or modify
   9         it under the terms of the GNU General Public License as published by
  10         the Free Software Foundation, either version 3 of the License, or
  11         (at your option) any later version.
  12
  13         This program is distributed in the hope that it will be useful,
  14         but WITHOUT ANY WARRANTY; without even the implied warranty of
  15         MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  16         GNU General Public License for more details.
  17
  18         You should have received a copy of the GNU General Public License
  19         along with this program.  If not, see <http://www.gnu.org/licenses/>.
  20
  21 **************************************************************************/
  22
  23
  24
  25
  26
  27 #ifndef TIMER_H
  28 #define TIMER_H
  29
  30 #include <QObject>
  31 #include <QString>
  32 #include <QTimer>
  33
  34
  35 #include <QModelIndex>
  36
  37 #include "alertsound.h"
  38
  39 /*! The timer class of KitchenAlert'
  40
  41   @author Heli Hyvättinen
  42   @date 2011-04-05
  43   @version 0.2.1
  44
  45 The timer class of KitchenAlert.
  46
  47 */
  48
  49 class Timer : public QObject
  50 {
  51     Q_OBJECT
  52 public:
  53     explicit Timer(QObject *parent = 0);
  54
  55     /*! Returns the original time in seconds
  56         When the alert restarts, it is set to this time.
  57     */
  58      int getOriginalTimeInSeconds();
  59
  60     /*! Sets the original time in seconds */
  61     void setOriginalTimeInSeconds(int seconds);
  62
  63     /*! Returns the time remaining before the alert in seconds       */
  64     int getRemainingTimeInSeconds();
  65
  66     /*! Returns the alert text */
  67     QString getAlertText();
  68
  69     /*! Sets the alert text */
  70     void setAlertText(QString text);
  71
  72     /*! Returns whether the timer is alerting */
  73     bool isAlerting();
  74
  75     /*! Saves the timer to a file
  76       @param filename The file to which to save.
  77     */
  78     bool save(QString filename);
  79
  80     /*! Loads a timer from a file
  81       @param filename The file from which to load.
  82     */
  83     bool load(QString filename);
  84
  85
  86 signals:
  87     /*! Emitted when the remaining time in the timer has changed */
  88     void remainingTimeChanged();
  89
  90     /*! Emitted when the timer alerts */
  91     void alert(QModelIndex indexOfAlerter);
  92
  93 public slots:
  94     /*! The internal QTimer is connected to this slot */
  95     void secondPassed();
  96
  97     /*! Start the timer */
  98     void start();
  99
 100     /*! Stop the timer*/
 101     void stop();
 102
 103     /*! Snooze the timer
 104         Currently sets the timer to alert again in two minutes.
 105     */
 106     void snooze();
 107
 108     /*! Switches to use the default sound (and saves it to settings */
 109     void enableDefaultSound();
 110
 111     /*! Changes the sound file used and saves it to settings */
 112     void changeAlertSound(QString filename);
 113
 114
 115
 116
 117 private:
 118     int _originalTime; //seconds!
 119     int _remainingTime; //seconds!
 120     QString _alertText;
 121     QTimer _actualTimer;
 122     bool alerting_;
 123
 124     QString filenameWithPath_; /*! Name (with full path) of the file where the timer was loaded from. Empty if timer not loaded from file. */
 125
 126     QModelIndex whereAmI();
 127
 128     AlertSound alertSound_;
 129
 130
 131
 132 };
 133
 134 #endif // TIMER_H