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
|
#ifndef STK_MODULATE_H
#define STK_MODULATE_H
#include "Generator.h"
#include "SineWave.h"
#include "Noise.h"
#include "OnePole.h"
namespace stk {
/***************************************************/
/*! \class Modulate
\brief STK periodic/random modulator.
This class combines random and periodic
modulations to give a nice, natural human
modulation function.
by Perry R. Cook and Gary P. Scavone, 1995--2023.
*/
/***************************************************/
class Modulate : public Generator
{
public:
//! Class constructor.
/*!
An StkError can be thrown if the rawwave path is incorrect.
*/
Modulate( void );
//! Class destructor.
~Modulate( void );
//! Reset internal state.
void reset( void ) { lastFrame_[0] = 0.0; };
//! Set the periodic (vibrato) rate or frequency in Hz.
void setVibratoRate( StkFloat rate ) { vibrato_.setFrequency( rate ); };
//! Set the periodic (vibrato) gain.
void setVibratoGain( StkFloat gain ) { vibratoGain_ = gain; };
//! Set the periodic (vibrato) rate or frequency in Hz.
void setRandomRate( StkFloat rate ) { noiseRate_ = (unsigned int) ( rate * Stk::sampleRate() / 22050.0 ); };
//! Set the random modulation gain.
void setRandomGain( StkFloat gain );
//! Return the last computed output value.
StkFloat lastOut( void ) const { return lastFrame_[0]; };
//! Compute and return one output sample.
StkFloat tick( void );
//! Fill a channel of the StkFrames object with computed outputs.
/*!
The \c channel argument must be less than the number of
channels in the StkFrames argument (the first channel is specified
by 0). However, range checking is only performed if _STK_DEBUG_
is defined during compilation, in which case an out-of-range value
will trigger an StkError exception.
*/
StkFrames& tick( StkFrames& frames, unsigned int channel = 0 );
protected:
void sampleRateChanged( StkFloat newRate, StkFloat oldRate );
SineWave vibrato_;
Noise noise_;
OnePole filter_;
StkFloat vibratoGain_;
StkFloat randomGain_;
unsigned int noiseRate_;
unsigned int noiseCounter_;
};
inline StkFloat Modulate :: tick( void )
{
// Compute periodic and random modulations.
lastFrame_[0] = vibratoGain_ * vibrato_.tick();
if ( noiseCounter_++ >= noiseRate_ ) {
noise_.tick();
noiseCounter_ = 0;
}
lastFrame_[0] += filter_.tick( noise_.lastOut() );
return lastFrame_[0];
}
inline StkFrames& Modulate :: tick( StkFrames& frames, unsigned int channel )
{
#if defined(_STK_DEBUG_)
if ( channel >= frames.channels() ) {
oStream_ << "Modulate::tick(): channel and StkFrames arguments are incompatible!";
handleError( StkError::FUNCTION_ARGUMENT );
}
#endif
StkFloat *samples = &frames[channel];
unsigned int hop = frames.channels();
for ( unsigned int i=0; i<frames.frames(); i++, samples += hop )
*samples = Modulate::tick();
return frames;
}
} // stk namespace
#endif
|
