GAudioOutput.h 2.53 KB
Newer Older
pixhawk's avatar
pixhawk committed
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36
/*=====================================================================

PIXHAWK Micro Air Vehicle Flying Robotics Toolkit

(c) 2009, 2010 PIXHAWK PROJECT  <http://pixhawk.ethz.ch>

This file is part of the PIXHAWK project

    PIXHAWK is free software: you can redistribute it and/or modify
    it under the terms of the GNU General Public License as published by
    the Free Software Foundation, either version 3 of the License, or
    (at your option) any later version.

    PIXHAWK is distributed in the hope that it will be useful,
    but WITHOUT ANY WARRANTY; without even the implied warranty of
    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
    GNU General Public License for more details.

    You should have received a copy of the GNU General Public License
    along with PIXHAWK. If not, see <http://www.gnu.org/licenses/>.

======================================================================*/

/**
 * @file
 *   @brief Definition of audio output
 *
 *   @author Lorenz Meier <mavteam@student.ethz.ch>
 *
 */

#ifndef GAUDIOOUTPUT_H
#define GAUDIOOUTPUT_H

#include <QObject>
#include <QTimer>
37
#include <QThread>
pixhawk's avatar
pixhawk committed
38
#include <QStringList>
39

40 41
#include "QGCAudioWorker.h"
#include "QGCSingleton.h"
Lorenz Meier's avatar
Lorenz Meier committed
42

pixhawk's avatar
pixhawk committed
43 44 45 46 47
/**
 * @brief Audio Output (speech synthesizer and "beep" output)
 * This class follows the singleton design pattern
 * @see http://en.wikipedia.org/wiki/Singleton_pattern
 */
48
class GAudioOutput : public QGCSingleton
pixhawk's avatar
pixhawk committed
49 50
{
    Q_OBJECT
51 52 53
    
    DECLARE_QGC_SINGLETON(GAudioOutput, GAudioOutput)
    
pixhawk's avatar
pixhawk committed
54 55 56
public:
    /** @brief List available voices */
    QStringList listVoices(void);
Lorenz Meier's avatar
Lorenz Meier committed
57 58
    enum
    {
59 60 61
        VOICE_MALE = 0,
        VOICE_FEMALE
    } QGVoice;
pixhawk's avatar
pixhawk committed
62

63 64 65 66 67 68 69 70 71 72 73 74
    enum AUDIO_SEVERITY
    {
        AUDIO_SEVERITY_EMERGENCY = 0,
        AUDIO_SEVERITY_ALERT = 1,
        AUDIO_SEVERITY_CRITICAL = 2,
        AUDIO_SEVERITY_ERROR = 3,
        AUDIO_SEVERITY_WARNING = 4,
        AUDIO_SEVERITY_NOTICE = 5,
        AUDIO_SEVERITY_INFO = 6,
        AUDIO_SEVERITY_DEBUG = 7
    };

75 76 77
    /** @brief Get the mute state */
    bool isMuted();

pixhawk's avatar
pixhawk committed
78 79
public slots:
    /** @brief Say this text if current output priority matches */
80
    bool say(const QString& text, int severity = 6);
81 82
    /** @brief Mute/unmute sound */
    void mute(bool mute);
83 84 85

signals:
    void mutedChanged(bool);
86
    bool textToSpeak(QString text, int severity = 1);
87
    void beepOnce();
pixhawk's avatar
pixhawk committed
88 89

protected:
90
    bool muted;
91 92
    QThread* thread;
    QGCAudioWorker* worker;
93
    
pixhawk's avatar
pixhawk committed
94
private:
Lorenz Meier's avatar
Lorenz Meier committed
95 96
    GAudioOutput(QObject *parent = NULL);
    ~GAudioOutput();
97 98
    
    static const char* _mutedKey;
pixhawk's avatar
pixhawk committed
99 100 101
};

#endif // AUDIOOUTPUT_H
Lorenz Meier's avatar
Lorenz Meier committed
102