26struct ADSRTests final :
public UnitTest
28 ADSRTests() :
UnitTest (
"ADSR", UnitTestCategories::audio) {}
30 void runTest()
override
32 constexpr double sampleRate = 44100.0;
33 const ADSR::Parameters parameters { 0.1f, 0.1f, 0.5f, 0.1f };
36 adsr.setSampleRate (sampleRate);
37 adsr.setParameters (parameters);
43 expect (! adsr.isActive());
54 auto buffer = getTestBuffer (sampleRate, parameters.attack);
55 adsr.applyEnvelopeToBuffer (buffer, 0, buffer.getNumSamples());
57 expect (isIncreasing (buffer));
65 advanceADSR (adsr, roundToInt (parameters.attack * sampleRate));
67 auto buffer = getTestBuffer (sampleRate, parameters.decay);
68 adsr.applyEnvelopeToBuffer (buffer, 0, buffer.getNumSamples());
70 expect (isDecreasing (buffer));
78 advanceADSR (adsr, roundToInt ((parameters.attack + parameters.decay + 0.01) * sampleRate));
82 for (
int numTests = 0; numTests < 100; ++numTests)
84 const auto sustainLevel = random.nextFloat();
85 const auto sustainLength = jmax (0.1f, random.nextFloat());
87 adsr.setParameters ({ parameters.attack, parameters.decay, sustainLevel, parameters.release });
89 auto buffer = getTestBuffer (sampleRate, sustainLength);
90 adsr.applyEnvelopeToBuffer (buffer, 0, buffer.getNumSamples());
92 expect (isSustained (buffer, sustainLevel));
101 advanceADSR (adsr, roundToInt ((parameters.attack + parameters.decay) * sampleRate));
104 auto buffer = getTestBuffer (sampleRate, parameters.release);
105 adsr.applyEnvelopeToBuffer (buffer, 0, buffer.getNumSamples());
107 expect (isDecreasing (buffer));
110 beginTest (
"Zero-length attack jumps to decay");
113 adsr.setParameters ({ 0.0f, parameters.decay, parameters.sustain, parameters.release });
117 auto buffer = getTestBuffer (sampleRate, parameters.decay);
118 adsr.applyEnvelopeToBuffer (buffer, 0, buffer.getNumSamples());
120 expect (isDecreasing (buffer));
123 beginTest (
"Zero-length decay jumps to sustain");
126 adsr.setParameters ({ parameters.attack, 0.0f, parameters.sustain, parameters.release });
129 advanceADSR (adsr, roundToInt (parameters.attack * sampleRate));
130 adsr.getNextSample();
132 expectEquals (adsr.getNextSample(), parameters.sustain);
134 auto buffer = getTestBuffer (sampleRate, 1);
135 adsr.applyEnvelopeToBuffer (buffer, 0, buffer.getNumSamples());
137 expect (isSustained (buffer, parameters.sustain));
140 beginTest (
"Zero-length attack and decay jumps to sustain");
143 adsr.setParameters ({ 0.0f, 0.0f, parameters.sustain, parameters.release });
147 expectEquals (adsr.getNextSample(), parameters.sustain);
149 auto buffer = getTestBuffer (sampleRate, 1);
150 adsr.applyEnvelopeToBuffer (buffer, 0, buffer.getNumSamples());
152 expect (isSustained (buffer, parameters.sustain));
155 beginTest (
"Zero-length attack and decay releases correctly");
158 adsr.setParameters ({ 0.0f, 0.0f, parameters.sustain, parameters.release });
163 auto buffer = getTestBuffer (sampleRate, parameters.release);
164 adsr.applyEnvelopeToBuffer (buffer, 0, buffer.getNumSamples());
166 expect (isDecreasing (buffer));
169 beginTest (
"Zero-length release resets to idle");
172 adsr.setParameters ({ parameters.attack, parameters.decay, parameters.sustain, 0.0f });
175 advanceADSR (adsr, roundToInt ((parameters.attack + parameters.decay) * sampleRate));
178 expect (! adsr.isActive());
182 static void advanceADSR (ADSR& adsr,
int numSamplesToAdvance)
184 while (--numSamplesToAdvance >= 0)
185 adsr.getNextSample();
188 static AudioBuffer<float> getTestBuffer (
double sampleRate,
float lengthInSeconds)
190 AudioBuffer<float> buffer { 2, roundToInt (lengthInSeconds * sampleRate) };
192 for (
int channel = 0; channel < buffer.getNumChannels(); ++channel)
193 for (
int sample = 0; sample < buffer.getNumSamples(); ++sample)
194 buffer.setSample (channel, sample, 1.0f);
199 static bool isIncreasing (
const AudioBuffer<float>& b)
201 jassert (b.getNumChannels() > 0 && b.getNumSamples() > 0);
203 for (
int channel = 0; channel < b.getNumChannels(); ++channel)
205 float previousSample = -1.0f;
207 for (
int sample = 0; sample < b.getNumSamples(); ++sample)
209 const auto currentSample = b.getSample (channel, sample);
211 if (currentSample <= previousSample)
214 previousSample = currentSample;
221 static bool isDecreasing (
const AudioBuffer<float>& b)
223 jassert (b.getNumChannels() > 0 && b.getNumSamples() > 0);
225 for (
int channel = 0; channel < b.getNumChannels(); ++channel)
227 float previousSample = std::numeric_limits<float>::max();
229 for (
int sample = 0; sample < b.getNumSamples(); ++sample)
231 const auto currentSample = b.getSample (channel, sample);
233 if (currentSample >= previousSample)
236 previousSample = currentSample;
243 static bool isSustained (
const AudioBuffer<float>& b,
float sustainLevel)
245 jassert (b.getNumChannels() > 0 && b.getNumSamples() > 0);
247 for (
int channel = 0; channel < b.getNumChannels(); ++channel)
248 if (b.findMinMax (channel, 0, b.getNumSamples()) != Range<float> { sustainLevel, sustainLevel })
255static ADSRTests adsrTests;
void expectEquals(ValueType actual, ValueType expected, String failureMessage=String())
UnitTest(const String &name, const String &category=String())
void beginTest(const String &testName)
void expect(bool testResult, const String &failureMessage=String())