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
101
102
103
104
105
106
107
108
109
110
|
/* -*- c-basic-offset: 4 indent-tabs-mode: nil -*- vi:set ts=8 sts=4 sw=4: */
/*
Sonic Visualiser
An audio file viewer and annotation editor.
Centre for Digital Music, Queen Mary, University of London.
This file copyright 2006-2007 Chris Cannam and QMUL.
This program 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 2 of the
License, or (at your option) any later version. See the file
COPYING included with this distribution for more information.
*/
#ifndef SV_RANGE_SUMMARISABLE_TIME_VALUE_MODEL_H
#define SV_RANGE_SUMMARISABLE_TIME_VALUE_MODEL_H
#include <QObject>
#include "DenseTimeValueModel.h"
#include <stdint.h>
namespace sv {
/**
* Base class for models containing dense two-dimensional data (value
* against time) that may be meaningfully represented in a zoomed view
* using min/max range summaries. Audio waveform data is an obvious
* example: think "peaks and minima" for "ranges".
*/
class RangeSummarisableTimeValueModel : public DenseTimeValueModel
{
Q_OBJECT
public:
RangeSummarisableTimeValueModel() { }
class Range
{
public:
Range() :
m_new(true), m_min(0.f), m_max(0.f), m_absmean(0.f) { }
Range(float min, float max, float absmean) :
m_new(false), m_min(min), m_max(max), m_absmean(absmean) { }
Range(const Range &r) =default;
Range &operator=(const Range &) =default;
float min() const { return m_min; }
float max() const { return m_max; }
float absmean() const { return m_absmean; }
void setMin(float min) { m_min = min; m_new = false; }
void setMax(float max) { m_max = max; m_new = false; }
void setAbsmean(float absmean) { m_absmean = absmean; }
void sample(float s) {
if (m_new) {
m_min = s;
m_max = s;
m_new = false;
} else {
if (s < m_min) m_min = s;
if (s > m_max) m_max = s;
}
}
private:
bool m_new;
float m_min;
float m_max;
float m_absmean;
};
typedef std::vector<Range> RangeBlock;
/**
* Return ranges from the given start frame, corresponding to the
* given number of underlying sample frames, summarised at the
* given block size. duration / blockSize ranges should ideally
* be returned.
*
* If the given block size is not supported by this model
* (according to its zoom constraint), also modify the blockSize
* parameter so as to return the block size that was actually
* obtained.
*/
virtual void getSummaries(int channel, sv_frame_t start, sv_frame_t count,
RangeBlock &ranges,
int &blockSize) const = 0;
/**
* Return the range from the given start frame, corresponding to
* the given number of underlying sample frames, summarised at a
* block size equal to the distance between start and end frames.
*/
virtual Range getSummary(int channel, sv_frame_t start, sv_frame_t count) const = 0;
virtual int getSummaryBlockSize(int desired) const = 0;
QString getTypeName() const override { return tr("Range-Summarisable Time-Value"); }
};
} // end namespace sv
#endif
|
