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
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
|
/*
* Copyright (C) 2020 Linux Studio Plugins Project <https://lsp-plug.in/>
* (C) 2020 Vladimir Sadovnikov <sadko4u@gmail.com>
*
* This file is part of lsp-dsp-units
* Created on: 16 сент. 2016 г.
*
* lsp-dsp-units is free software: you can redistribute it and/or modify
* it under the terms of the GNU Lesser General Public License as published by
* the Free Software Foundation, either version 3 of the License, or
* any later version.
*
* lsp-dsp-units is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
* GNU Lesser General Public License for more details.
*
* You should have received a copy of the GNU Lesser General Public License
* along with lsp-dsp-units. If not, see <https://www.gnu.org/licenses/>.
*/
#ifndef LSP_PLUG_IN_DSP_UNITS_DYNAMICS_COMPRESSOR_H_
#define LSP_PLUG_IN_DSP_UNITS_DYNAMICS_COMPRESSOR_H_
#include <lsp-plug.in/dsp-units/version.h>
#include <lsp-plug.in/dsp-units/iface/IStateDumper.h>
namespace lsp
{
namespace dspu
{
enum compressor_mode_t
{
CM_DOWNWARD,
CM_UPWARD,
CM_BOOSTING
};
/** Compressor class implementation
*
*/
class LSP_DSP_UNITS_PUBLIC Compressor
{
private:
Compressor & operator = (const Compressor &);
Compressor(const Compressor &);
protected:
typedef struct knee_t
{
float fKS; // Knee start
float fKE; // Knee end
float fGain; // Pre-amplification gain
float vKnee[3]; // Hermite interpolation of the knee
float vTilt[2]; // Tilt parameters after the knee
} knee_t;
protected:
// Basic parameters
float fAttackThresh;
float fReleaseThresh;
float fBoostThresh;
float fAttack;
float fRelease;
float fKnee;
float fRatio;
float fEnvelope;
// Pre-calculated parameters
float fTauAttack;
float fTauRelease;
knee_t vKnees[2]; // Two compressor knees
// Additional parameters
size_t nSampleRate;
size_t nMode;
bool bUpdate;
public:
explicit Compressor();
~Compressor();
/**
* Construct object
*/
void construct();
/**
* Destroy object
*/
void destroy();
public:
/** Check that some of compressor's parameters have been modified
* and we need to call update_settings();
*
* @return true if some of compressor's parameters have been modified
*/
inline bool modified() const
{
return bUpdate;
}
/** Update compressor's settings
*
*/
void update_settings();
/** Set compressor threshold
*
* @param attack the attack threshold
* @param release the release threshold (relative to attack, must be positive, less or equal to 1.0)
*/
void set_threshold(float attack, float release);
/**
* Set boost threshold, valid for upward compression only
* @param boost boost threshold
*/
void set_boost_threshold(float boost);
/** Set compressor timings
*
* @param attack attack time (ms)
* @param release release time (ms)
*/
void set_timings(float attack, float release);
/** Set attack time
*
* @param attack attack time (ms)
*/
void set_attack(float attack);
/** Set release time
*
* @param release release time (ms)
*/
void set_release(float release);
/** Set compressor's sample rate
*
* @param sr sample rate
*/
void set_sample_rate(size_t sr);
/** Set compressor's knee
*
* @param knee (in gain units)
*/
void set_knee(float knee);
/** Set compression ratio
*
* @param ratio compression ratio
*/
void set_ratio(float ratio);
/** Set compression mode: upward/downward
*
* @param mode compression mode
*/
void set_mode(size_t mode);
/** Process sidechain signal
*
* @param out output signal gain to VCA
* @param env envelope signal of compressor
* @param in sidechain signal
* @param samples number of samples to process
*/
void process(float *out, float *env, const float *in, size_t samples);
/** Process one sample of sidechain signal
*
* @param in sidechain signal
* @param out envelope signal of compressor, may be NULL
* @return output signal gain to VCA
*/
float process(float *env, float in);
/** Get compression curve
*
* @param out output compression value
* @param in input compression value
* @param dots number of input dots
*/
void curve(float *out, const float *in, size_t dots);
/** Get compression curve point
*
* @param in input level
*/
float curve(float in);
/** Get compressor gain reduction
*
* @param out output signal
* @param in input signal
* @param dots number of dots
*/
void reduction(float *out, const float *in, size_t dots);
/** Get compressor gain reduction
*
* @param in input level
*/
float reduction(float in);
/**
* Dump internal state
* @param v state dumper
*/
void dump(IStateDumper *v) const;
};
}
} /* namespace lsp */
#endif /* LSP_PLUG_IN_DSP_UNITS_DYNAMICS_COMPRESSOR_H_ */
|
