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
|
/*
* 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: 7 нояб. 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_GATE_H_
#define LSP_PLUG_IN_DSP_UNITS_DYNAMICS_GATE_H_
#include <lsp-plug.in/dsp-units/version.h>
#include <lsp-plug.in/dsp-units/iface/IStateDumper.h>
namespace lsp
{
namespace dspu
{
class LSP_DSP_UNITS_PUBLIC Gate
{
private:
Gate & operator = (const Gate &);
Gate(const Gate &);
protected:
typedef struct curve_t
{
float fThreshold;
float fZone;
float fZS;
float fZE;
float fZSGain;
float fZEGain;
float vHermite[4];
} curve_t;
protected:
// Parameters
curve_t sCurves[2];
float fAttack;
float fRelease;
float fTauAttack;
float fTauRelease;
float fReduction;
float fEnvelope;
// Additional parameters
size_t nSampleRate;
size_t nCurve;
bool bUpdate;
public:
explicit Gate();
~Gate();
/**
* Construct the object
*/
void construct();
/**
* Destroy the 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;
}
/** Update gate settings
*
*/
void update_settings();
/** Set threshold
*
* @param topen open curve threshold
* @param tclose close curve threshold
*
*/
inline void set_threshold(float topen, float tclose)
{
if ((topen == sCurves[0].fThreshold) && (tclose == sCurves[1].fThreshold))
return;
sCurves[0].fThreshold = topen;
sCurves[1].fThreshold = tclose;
bUpdate = true;
}
/** Set reduction
*
* @param reduction the reduction threshold
*/
inline void set_reduction(float reduction)
{
if (reduction == fReduction)
return;
fReduction = reduction;
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 reduction zone
*
* @param open open curve ratio
* @param close close curve ratio
*/
inline void set_zone(float open, float close)
{
if ((open == sCurves[0].fZone) && (close == sCurves[1].fZone))
return;
sCurves[0].fZone = open;
sCurves[1].fZone = close;
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 curve
*
* @param out output expansion value
* @param in input expansion value
* @param dots number of input dots
* @param hyst output hysteresis curve or direct curve
*/
void curve(float *out, const float *in, size_t dots, bool hyst) const;
/** Get curve point
*
* @param in input level
* @param hyst output hysteresis curve or direct curve
*/
float curve(float in, bool hyst) const;
/** Get gain amplification
*
* @param out output signal
* @param in input signal
* @param dots number of dots
* @param hyst output hysteresis amplification or direct amplification
*/
void amplification(float *out, const float *in, size_t dots, bool hyst) const;
/** Get gain amplification at current state
*
* @param in input level
*/
float amplification(float in) const;
/** Get gain amplification
*
* @param in input level
* @param hyst output hysteresis amplification or direct amplification
*/
float amplification(float in, bool hyst) const;
/**
* Dump internal state
* @param v state dumper
*/
void dump(IStateDumper *v) const;
};
}
} /* namespace lsp */
#endif /* LSP_PLUG_IN_DSP_UNITS_DYNAMICS_GATE_H_ */
|