1 | /****************************************************************************
|
---|
2 | **
|
---|
3 | ** Copyright (C) 2011 Nokia Corporation and/or its subsidiary(-ies).
|
---|
4 | ** All rights reserved.
|
---|
5 | ** Contact: Nokia Corporation ([email protected])
|
---|
6 | **
|
---|
7 | ** This file is part of the examples of the Qt Toolkit.
|
---|
8 | **
|
---|
9 | ** $QT_BEGIN_LICENSE:BSD$
|
---|
10 | ** You may use this file under the terms of the BSD license as follows:
|
---|
11 | **
|
---|
12 | ** "Redistribution and use in source and binary forms, with or without
|
---|
13 | ** modification, are permitted provided that the following conditions are
|
---|
14 | ** met:
|
---|
15 | ** * Redistributions of source code must retain the above copyright
|
---|
16 | ** notice, this list of conditions and the following disclaimer.
|
---|
17 | ** * Redistributions in binary form must reproduce the above copyright
|
---|
18 | ** notice, this list of conditions and the following disclaimer in
|
---|
19 | ** the documentation and/or other materials provided with the
|
---|
20 | ** distribution.
|
---|
21 | ** * Neither the name of Nokia Corporation and its Subsidiary(-ies) nor
|
---|
22 | ** the names of its contributors may be used to endorse or promote
|
---|
23 | ** products derived from this software without specific prior written
|
---|
24 | ** permission.
|
---|
25 | **
|
---|
26 | ** THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
|
---|
27 | ** "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
|
---|
28 | ** LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
|
---|
29 | ** A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
|
---|
30 | ** OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
|
---|
31 | ** SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
|
---|
32 | ** LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
|
---|
33 | ** DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
|
---|
34 | ** THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
|
---|
35 | ** (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
|
---|
36 | ** OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE."
|
---|
37 | ** $QT_END_LICENSE$
|
---|
38 | **
|
---|
39 | ****************************************************************************/
|
---|
40 |
|
---|
41 | #ifndef ENGINE_H
|
---|
42 | #define ENGINE_H
|
---|
43 |
|
---|
44 | #include "spectrum.h"
|
---|
45 | #include "spectrumanalyser.h"
|
---|
46 | #include "wavfile.h"
|
---|
47 |
|
---|
48 | #include <QObject>
|
---|
49 | #include <QByteArray>
|
---|
50 | #include <QBuffer>
|
---|
51 | #include <QVector>
|
---|
52 | #include <QtMultimedia/QAudioDeviceInfo>
|
---|
53 | #include <QtMultimedia/QAudioFormat>
|
---|
54 |
|
---|
55 | #ifdef DUMP_CAPTURED_AUDIO
|
---|
56 | #define DUMP_DATA
|
---|
57 | #endif
|
---|
58 |
|
---|
59 | #ifdef DUMP_SPECTRUM
|
---|
60 | #define DUMP_DATA
|
---|
61 | #endif
|
---|
62 |
|
---|
63 | #ifdef DUMP_DATA
|
---|
64 | #include <QDir>
|
---|
65 | #endif
|
---|
66 |
|
---|
67 | class FrequencySpectrum;
|
---|
68 | QT_FORWARD_DECLARE_CLASS(QAudioInput)
|
---|
69 | QT_FORWARD_DECLARE_CLASS(QAudioOutput)
|
---|
70 | QT_FORWARD_DECLARE_CLASS(QFile)
|
---|
71 |
|
---|
72 | /**
|
---|
73 | * This class interfaces with the QtMultimedia audio classes, and also with
|
---|
74 | * the SpectrumAnalyser class. Its role is to manage the capture and playback
|
---|
75 | * of audio data, meanwhile performing real-time analysis of the audio level
|
---|
76 | * and frequency spectrum.
|
---|
77 | */
|
---|
78 | class Engine : public QObject {
|
---|
79 | Q_OBJECT
|
---|
80 | public:
|
---|
81 | Engine(QObject *parent = 0);
|
---|
82 | ~Engine();
|
---|
83 |
|
---|
84 | const QList<QAudioDeviceInfo>& availableAudioInputDevices() const
|
---|
85 | { return m_availableAudioInputDevices; }
|
---|
86 |
|
---|
87 | const QList<QAudioDeviceInfo>& availableAudioOutputDevices() const
|
---|
88 | { return m_availableAudioOutputDevices; }
|
---|
89 |
|
---|
90 | QAudio::Mode mode() const { return m_mode; }
|
---|
91 | QAudio::State state() const { return m_state; }
|
---|
92 |
|
---|
93 | /**
|
---|
94 | * \return Current audio format
|
---|
95 | * \note May be QAudioFormat() if engine is not initialized
|
---|
96 | */
|
---|
97 | const QAudioFormat& format() const { return m_format; }
|
---|
98 |
|
---|
99 | /**
|
---|
100 | * Stop any ongoing recording or playback, and reset to ground state.
|
---|
101 | */
|
---|
102 | void reset();
|
---|
103 |
|
---|
104 | /**
|
---|
105 | * Load data from WAV file
|
---|
106 | */
|
---|
107 | bool loadFile(const QString &fileName);
|
---|
108 |
|
---|
109 | /**
|
---|
110 | * Generate tone
|
---|
111 | */
|
---|
112 | bool generateTone(const Tone &tone);
|
---|
113 |
|
---|
114 | /**
|
---|
|
---|