summaryrefslogtreecommitdiffstats
path: root/examples/multimedia/spectrum/spectrum.h
blob: e416e82bd2481c487522c036722051b1adabffff (plain)
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
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
// Copyright (C) 2017 The Qt Company Ltd.
// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause

#ifndef SPECTRUM_H
#define SPECTRUM_H

#include "fftreal_wrapper.h" // For FFTLengthPowerOfTwo
#include "utils.h"

#include <QtGlobal>

//-----------------------------------------------------------------------------
// Constants
//-----------------------------------------------------------------------------

// Number of audio samples used to calculate the frequency spectrum
const int SpectrumLengthSamples = PowerOfTwo<FFTLengthPowerOfTwo>::Result;

// Number of bands in the frequency spectrum
const int SpectrumNumBands = 10;

// Lower bound of first band in the spectrum
const qreal SpectrumLowFreq = 0.0; // Hz

// Upper band of last band in the spectrum
const qreal SpectrumHighFreq = 1000.0; // Hz

// Waveform window size in microseconds
const qint64 WaveformWindowDuration = 500 * 1000;

// Length of waveform tiles in bytes
// Ideally, these would match the QAudio*::bufferSize(), but that isn't
// available until some time after QAudio*::start() has been called, and we
// need this value in order to initialize the waveform display.
// We therefore just choose a sensible value.
const int WaveformTileLength = 4096;

// Fudge factor used to calculate the spectrum bar heights
const qreal SpectrumAnalyserMultiplier = 0.15;

// Disable message timeout
const int NullMessageTimeout = -1;

//-----------------------------------------------------------------------------
// Types and data structures
//-----------------------------------------------------------------------------

enum WindowFunction { NoWindow, HannWindow };
Q_DECLARE_METATYPE(WindowFunction)

const WindowFunction DefaultWindowFunction = HannWindow;

struct Tone
{
    Tone(qreal freq = 0.0, qreal amp = 0.0) : frequency(freq), amplitude(amp) { }

    // Start and end frequencies for swept tone generation
    qreal frequency;

    // Amplitude in range [0.0, 1.0]
    qreal amplitude;
};

struct SweptTone
{
    SweptTone(qreal start = 0.0, qreal end = 0.0, qreal amp = 0.0)
        : startFreq(start), endFreq(end), amplitude(amp)
    {
        Q_ASSERT(end >= start);
    }

    SweptTone(const Tone &tone)
        : startFreq(tone.frequency), endFreq(tone.frequency), amplitude(tone.amplitude)
    {
    }

    // Start and end frequencies for swept tone generation
    qreal startFreq;
    qreal endFreq;

    // Amplitude in range [0.0, 1.0]
    qreal amplitude;
};

// Handle some dependencies between macros defined in the .pro file

#ifdef DISABLE_WAVEFORM
#    undef SUPERIMPOSE_PROGRESS_ON_WAVEFORM
#endif

#endif // SPECTRUM_H