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
92
93
94
95
96
97
98
99
100
|
#ifndef W_F_HPP__
#define W_F_HPP__
#include "JS8_Include/commons.h"
#include <QColor>
#include <QFlags>
#include <QList>
#include <QMetaType>
#include <QVector>
class QString;
namespace WF {
Q_NAMESPACE
// Spectrum type, defines the types of waterfall spectrum displays.
enum class Spectrum { Current, Cumulative, LinearAvg };
Q_ENUM_NS(Spectrum)
// Maximum width of the screen in pixels.
static constexpr std::size_t MaxScreenWidth = 2048;
// Waterfall data storage types.
using SPlot = std::array<float, JS8_NSMAX>;
using SWide = std::array<float, MaxScreenWidth>;
// The wide graph class drains into the plotter class, driven by a
// timer based on the desired frames per second that the waterfall
// should display. Since the wide graph itself acts as a sink for
// the detector, and we may or may not have averaging in play, we
// end up with sink states that the waterfall might be in:
//
// 1. Drained - No new data has arrived in the wide graph sink
// since it was last drained to the plotter. Any
// frame of data sent to the plotter in this state
// is a duplicate of the last frame.
//
// 2. Summary - New data arrived in the wide graph sink; adjunct
// summary data referenced by the plotter will have
// changed. If Current isn't set, then the frame is
// a duplicate of the last frame.
//
// 3. Current - Averaging has completed; data is current and not
// a duplicate of the last frame.
enum class Sink { Drained = 0x0, Summary = 0x1, Current = 0x2 };
Q_DECLARE_FLAGS(State, Sink)
//
// Class Palette
//
// Encapsulates a waterfall palette description. A colour gradient
// over 256 intervals is described by a list of RGB colour triplets.
// The list of colours are use to interpolate the full 256 interval
// waterfall colour gradient.
//
// Responsibilities
//
// Construction from a string which is a path to a file containing
// colour descriptions in the form rrr;ggg;bbb on up to 256
// consecutive lines, where rrr, ggg and, bbb are integral numbers in
// the range 0<=n<256.
//
// Construction from a list of QColor instances. Up to the first 256
// list elements are used.
//
// Includes a design GUI to create or adjust a Palette.
//
class Palette {
public:
using Colours = QList<QColor>;
Palette() = default;
explicit Palette(Colours const &);
explicit Palette(QString const &file_path);
Palette(Palette const &) = default;
Palette &operator=(Palette const &) = default;
Colours colours() const { return colours_; }
// interpolate a gradient over 256 steps
QVector<QColor> interpolate() const;
// returns true if colours have been modified
bool design();
private:
Colours colours_;
};
} // namespace WF
Q_DECLARE_METATYPE(WF::Spectrum)
Q_DECLARE_METATYPE(WF::Palette::Colours)
Q_DECLARE_OPERATORS_FOR_FLAGS(WF::State)
#endif
|
