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

   1 /**************************************************************************
   2         KitchenAlert
   3
   4         Copyright (C) 2010  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 2010-09-08
  43   @version 0.1.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
  76 signals:
  77     /*! Emitted when the remaining time in the timer has changed */
  78     void remainingTimeChanged();
  79
  80     /*! Emitted when the timer alerts */
  81     void alert(QModelIndex indexOfAlerter);
  82
  83 public slots:
  84     /*! The internal QTimer is connected to this slot */
  85     void secondPassed();
  86
  87     /*! Start the timer */
  88     void start();
  89
  90     /*! Stop the timer*/
  91     void stop();
  92
  93     /*! Snooze the timer
  94         Currently sets the timer to alert again in two minutes.
  95     */
  96     void snooze();
  97
  98     /*! Switches to use the default sound (and saves it to settings */
  99     void enableDefaultSound();
 100
 101     /*! Changes the sound file used and saves it to settings */
 102     void changeAlertSound(QString filename);
 103
 104
 105
 106
 107 private:
 108     int _originalTime; //seconds!
 109     int _remainingTime; //seconds!
 110     QString _alertText;
 111     QTimer _actualTimer;
 112     bool alerting_;
 113
 114     QModelIndex whereAmI();
 115
 116     AlertSound alertSound_;
 117
 118 };
 119
 120 #endif // TIMER_H