1/****************************************************************************
2**
3** Copyright (C) 2017 The Qt Company Ltd.
4** Contact: https://www.qt.io/licensing/
5**
6** This file is part of the examples of the Qt Toolkit.
7**
8** $QT_BEGIN_LICENSE:BSD$
9** Commercial License Usage
10** Licensees holding valid commercial Qt licenses may use this file in
11** accordance with the commercial license agreement provided with the
12** Software or, alternatively, in accordance with the terms contained in
13** a written agreement between you and The Qt Company. For licensing terms
14** and conditions see https://www.qt.io/terms-conditions. For further
15** information use the contact form at https://www.qt.io/contact-us.
16**
17** BSD License Usage
18** Alternatively, you may use this file under the terms of the BSD license
19** as follows:
20**
21** "Redistribution and use in source and binary forms, with or without
22** modification, are permitted provided that the following conditions are
23** met:
24** * Redistributions of source code must retain the above copyright
25** notice, this list of conditions and the following disclaimer.
26** * Redistributions in binary form must reproduce the above copyright
27** notice, this list of conditions and the following disclaimer in
28** the documentation and/or other materials provided with the
29** distribution.
30** * Neither the name of The Qt Company Ltd nor the names of its
31** contributors may be used to endorse or promote products derived
32** from this software without specific prior written permission.
33**
34**
35** THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
36** "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
37** LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
38** A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
39** OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
40** SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
41** LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
42** DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
43** THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
44** (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
45** OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE."
46**
47** $QT_END_LICENSE$
48**
49****************************************************************************/
50
51#ifndef MAINWIDGET_H
52#define MAINWIDGET_H
53
54#include <QAudio>
55#include <QIcon>
56#include <QWidget>
57
58class Engine;
59class FrequencySpectrum;
60class LevelMeter;
61class ProgressBar;
62class SettingsDialog;
63class Spectrograph;
64class ToneGeneratorDialog;
65class Waveform;
66
67QT_BEGIN_NAMESPACE
68class QAction;
69class QAudioFormat;
70class QLabel;
71class QMenu;
72class QPushButton;
73QT_END_NAMESPACE
74
75/**
76 * Main application widget, responsible for connecting the various UI
77 * elements to the Engine.
78 */
79class MainWidget : public QWidget
80{
81 Q_OBJECT
82
83public:
84 explicit MainWidget(QWidget *parent = 0);
85 ~MainWidget();
86
87 // QObject
88 void timerEvent(QTimerEvent *event) override;
89
90public slots:
91 void stateChanged(QAudio::Mode mode, QAudio::State state);
92 void formatChanged(const QAudioFormat &format);
93 void spectrumChanged(qint64 position, qint64 length,
94 const FrequencySpectrum &spectrum);
95 void infoMessage(const QString &message, int timeoutMs);
96 void errorMessage(const QString &heading, const QString &detail);
97 void audioPositionChanged(qint64 position);
98 void bufferLengthChanged(qint64 length);
99
100private slots:
101 void showFileDialog();
102 void showSettingsDialog();
103 void showToneGeneratorDialog();
104 void initializeRecord();
105 void updateModeMenu();
106 void updateButtonStates();
107
108private:
109 void createUi();
110 void createMenus();
111 void connectUi();
112 void reset();
113
114 enum Mode {
115 NoMode,
116 RecordMode,
117 GenerateToneMode,
118 LoadFileMode
119 };
120
121 void setMode(Mode mode);
122
123private:
124 Mode m_mode;
125
126 Engine* m_engine;
127
128#ifndef DISABLE_WAVEFORM
129 Waveform* m_waveform;
130#endif
131 ProgressBar* m_progressBar;
132 Spectrograph* m_spectrograph;
133 LevelMeter* m_levelMeter;
134
135 QPushButton* m_modeButton;
136 QPushButton* m_recordButton;
137 QIcon m_recordIcon;
138 QPushButton* m_pauseButton;
139 QIcon m_pauseIcon;
140 QPushButton* m_playButton;
141 QIcon m_playIcon;
142 QPushButton* m_settingsButton;
143 QIcon m_settingsIcon;
144
145 QLabel* m_infoMessage;
146 int m_infoMessageTimerId;
147
148 SettingsDialog* m_settingsDialog;
149 ToneGeneratorDialog* m_toneGeneratorDialog;
150
151 QMenu* m_modeMenu;
152 QAction* m_loadFileAction;
153 QAction* m_generateToneAction;
154 QAction* m_recordAction;
155};
156
157#endif // MAINWIDGET_H
158

source code of qtmultimedia/examples/multimedia/spectrum/app/mainwidget.h