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
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
|
/*
* 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: 2 нояб. 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_EXPANDER_H_
#define LSP_PLUG_IN_DSP_UNITS_DYNAMICS_EXPANDER_H_
#include <lsp-plug.in/dsp-units/version.h>
#include <lsp-plug.in/dsp-units/iface/IStateDumper.h>
namespace lsp
{
namespace dspu
{
enum expander_mode_t
{
EM_DOWNWARD,
EM_UPWARD
};
class LSP_DSP_UNITS_PUBLIC Expander
{
private:
Expander & operator = (const Expander &);
Expander(const Expander &);
protected:
// Basic parameters
float fAttackThresh;
float fReleaseThresh;
float fAttack;
float fRelease;
float fKnee;
float fRatio;
float fEnvelope;
// Pre-calculated parameters
float fTauAttack;
float fTauRelease;
float vHermite[3]; // Knee hermite interpolation
float fLogKS; // Knee start
float fLogKE; // Knee end
float fLogTH; // Logarithmic threshold
// Additional parameters
size_t nSampleRate;
bool bUpdate;
bool bUpward;
public:
explicit Expander();
~Expander();
/**
* Construct object
*/
void construct();
/**
* Destroy object
*/
void destroy();
public:
/** Check that some of parameters have been modified
* and we need to call update_settings();
*
* @return true if some of parameters have been modified
*/
inline bool modified() const
{
return bUpdate;
}
inline bool is_upward() const
{
return bUpward;
}
inline bool is_downward() const
{
return !bUpward;
}
/** Update expander settings
*
*/
void update_settings();
/** Set threshold
*
* @param attack the attack threshold
* @param release the release threshold (relative to attack, must be positive, less or equal to 1.0)
*/
inline void set_threshold(float attack, float release)
{
if ((fAttackThresh == attack) && (fReleaseThresh == release))
return;
fAttackThresh = attack;
fReleaseThresh = release;
bUpdate = true;
}
/** Set timings
*
* @param attack attack time (ms)
* @param release release time (ms)
*/
inline void set_timings(float attack, float release)
{
if ((fAttack == attack) && (fRelease == release))
return;
fAttack = attack;
fRelease = release;
bUpdate = true;
}
/** Set attack time
*
* @param attack attack time (ms)
*/
inline void set_attack(float attack)
{
if (fAttack == attack)
return;
fAttack = attack;
bUpdate = true;
}
/** Set release time
*
* @param release release time (ms)
*/
inline void set_release(float release)
{
if (fRelease == release)
return;
fRelease = release;
bUpdate = true;
}
/** Set sample rate
*
* @param sr sample rate
*/
inline void set_sample_rate(size_t sr)
{
if (sr == nSampleRate)
return;
nSampleRate = sr;
bUpdate = true;
}
/** Set knee
*
* @param knee (in gain units)
*/
inline void set_knee(float knee)
{
if (knee == fKnee)
return;
fKnee = knee;
bUpdate = true;
}
/** Set ratio
*
* @param ratio expansion ratio
*/
inline void set_ratio(float ratio)
{
if (ratio == fRatio)
return;
bUpdate = true;
fRatio = ratio;
}
/** Set expander mode: upward/downward
*
* @param mode expander mode
*/
inline void set_mode(size_t mode)
{
bool upward = (mode == EM_UPWARD);
if (upward == bUpward)
return;
bUpward = upward;
bUpdate = true;
}
/** Process sidechain signal
*
* @param out output signal gain to VCA
* @param env envelope signal of expander
* @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 s sidechain signal
* @param out envelope signal of expander, may be NULL
* @return output signal gain to VCA
*/
float process(float *env, float s);
/** Get expansion curve
*
* @param out output expansion value
* @param in input expansion value
* @param dots number of input dots
*/
void curve(float *out, const float *in, size_t dots);
/** Get expansion curve point
*
* @param in input level
*/
float curve(float in);
/** Get gain amplification
*
* @param out output signal
* @param in input signal
* @param dots number of dots
*/
void amplification(float *out, const float *in, size_t dots);
/** Get gain amplification
*
* @param in input level
*/
float amplification(float in);
/**
* Dump internal state
* @param v state dumper
*/
void dump(IStateDumper *v) const;
};
}
} /* namespace lsp */
#endif /* LSP_PLUG_IN_DSP_UNITS_DYNAMICS_EXPANDER_H_ */
|
