Arduino STK  4.6.2
Flute.h
1 #ifndef STK_FLUTE_H
2 #define STK_FLUTE_H
3 
4 #include "Instrmnt.h"
5 #include "JetTable.h"
6 #include "DelayL.h"
7 #include "OnePole.h"
8 #include "PoleZero.h"
9 #include "Noise.h"
10 #include "ADSR.h"
11 #include "SineWave.h"
12 
13 namespace stk {
14 
15 /***************************************************/
37 /***************************************************/
38 
39 class Flute : public Instrmnt
40 {
41  public:
43 
46  Flute( StkFloat lowestFrequency );
47 
49  ~Flute( void );
50 
52  void clear( void );
53 
55  void setFrequency( StkFloat frequency );
56 
58  void setJetReflection( StkFloat coefficient ) { jetReflection_ = coefficient; };
59 
61  void setEndReflection( StkFloat coefficient ) { endReflection_ = coefficient; };
62 
64  void setJetDelay( StkFloat aRatio );
65 
67  void startBlowing( StkFloat amplitude, StkFloat rate );
68 
70  void stopBlowing( StkFloat rate );
71 
73  void noteOn( StkFloat frequency, StkFloat amplitude );
74 
76  void noteOff( StkFloat amplitude );
77 
79  void controlChange( int number, StkFloat value );
80 
82  StkFloat tick( unsigned int channel = 0 );
83 
85 
92  StkFrames& tick( StkFrames& frames, unsigned int channel = 0 );
93 
94  protected:
95 
96  DelayL jetDelay_;
97  DelayL boreDelay_;
98  JetTable jetTable_;
99  OnePole filter_;
100  PoleZero dcBlock_;
101  Noise noise_;
102  ADSR adsr_;
103  SineWave vibrato_;
104 
105  StkFloat lastFrequency_;
106  StkFloat maxPressure_;
107  StkFloat jetReflection_;
108  StkFloat endReflection_;
109  StkFloat noiseGain_;
110  StkFloat vibratoGain_;
111  StkFloat outputGain_;
112  StkFloat jetRatio_;
113 
114 };
115 
116 inline StkFloat Flute :: tick( unsigned int )
117 {
118  StkFloat pressureDiff;
119  StkFloat breathPressure;
120 
121  // Calculate the breath pressure (envelope + noise + vibrato)
122  breathPressure = maxPressure_ * adsr_.tick();
123  breathPressure += breathPressure * ( noiseGain_ * noise_.tick() + vibratoGain_ * vibrato_.tick() );
124 
125  StkFloat temp = -filter_.tick( boreDelay_.lastOut() );
126  temp = dcBlock_.tick( temp ); // Block DC on reflection.
127 
128  pressureDiff = breathPressure - (jetReflection_ * temp);
129  pressureDiff = jetDelay_.tick( pressureDiff );
130  pressureDiff = jetTable_.tick( pressureDiff ) + (endReflection_ * temp);
131  lastFrame_[0] = (StkFloat) 0.3 * boreDelay_.tick( pressureDiff );
132 
133  lastFrame_[0] *= outputGain_;
134  return lastFrame_[0];
135 }
136 
137 inline StkFrames& Flute :: tick( StkFrames& frames, unsigned int channel )
138 {
139  unsigned int nChannels = lastFrame_.channels();
140 #if defined(_STK_DEBUG_)
141  if ( channel > frames.channels() - nChannels ) {
142  oStream_ << "Flute::tick(): channel and StkFrames arguments are incompatible!";
143  handleError( StkError::FUNCTION_ARGUMENT );
144  }
145 #endif
146 
147  StkFloat *samples = &frames[channel];
148  unsigned int j, hop = frames.channels() - nChannels;
149  if ( nChannels == 1 ) {
150  for ( unsigned int i=0; i<frames.frames(); i++, samples += hop )
151  *samples++ = tick();
152  }
153  else {
154  for ( unsigned int i=0; i<frames.frames(); i++, samples += hop ) {
155  *samples++ = tick();
156  for ( j=1; j<nChannels; j++ )
157  *samples++ = lastFrame_[j];
158  }
159  }
160 
161  return frames;
162 }
163 
164 } // stk namespace
165 
166 #endif
STK ADSR envelope class.
Definition: ADSR.h:27
StkFloat tick(void)
Compute and return one output sample.
Definition: ADSR.h:117
STK linear interpolating delay line class.
Definition: DelayL.h:28
StkFloat lastOut(void) const
Return the last computed output value.
Definition: DelayL.h:76
StkFloat tick(StkFloat input)
Input one sample to the filter and return one output.
Definition: DelayL.h:163
STK flute physical model class.
Definition: Flute.h:40
void setJetReflection(StkFloat coefficient)
Set the reflection coefficient for the jet delay (-1.0 - 1.0).
Definition: Flute.h:58
void startBlowing(StkFloat amplitude, StkFloat rate)
Apply breath velocity to instrument with given amplitude and rate of increase.
void clear(void)
Reset and clear all internal state.
void stopBlowing(StkFloat rate)
Decrease breath velocity with given rate of decrease.
~Flute(void)
Class destructor.
void setEndReflection(StkFloat coefficient)
Set the reflection coefficient for the air column delay (-1.0 - 1.0).
Definition: Flute.h:61
void controlChange(int number, StkFloat value)
Perform the control change specified by number and value (0.0 - 128.0).
Flute(StkFloat lowestFrequency)
Class constructor, taking the lowest desired playing frequency.
StkFloat tick(unsigned int channel=0)
Compute and return one output sample.
Definition: Flute.h:116
void setJetDelay(StkFloat aRatio)
Set the length of the jet delay in terms of a ratio of jet delay to air column delay lengths.
void noteOff(StkFloat amplitude)
Stop a note with the given amplitude (speed of decay).
void setFrequency(StkFloat frequency)
Set instrument parameters for a particular frequency.
void noteOn(StkFloat frequency, StkFloat amplitude)
Start a note with the given frequency and amplitude.
STK instrument abstract base class.
Definition: Instrmnt.h:20
STK jet table class.
Definition: JetTable.h:24
StkFloat tick(StkFloat input)
Take one sample input and map to one sample of output.
Definition: JetTable.h:54
STK noise generator.
Definition: Noise.h:22
StkFloat tick(void)
Compute and return one output sample.
Definition: Noise.h:59
STK one-pole filter class.
Definition: OnePole.h:21
StkFloat tick(StkFloat input)
Input one sample to the filter and return one output.
Definition: OnePole.h:80
STK one-pole, one-zero filter class.
Definition: PoleZero.h:22
StkFloat tick(StkFloat input)
Input one sample to the filter and return one output.
Definition: PoleZero.h:79
STK sinusoid oscillator class.
Definition: SineWave.h:26
StkFloat tick(void)
Compute and return one output sample.
Definition: SineWave.h:99
An STK class to handle vectorized audio data.
Definition: Stk.h:287
unsigned int channels(void) const
Return the number of channels represented by the data.
Definition: Stk.h:415
unsigned int frames(void) const
Return the number of sample frames represented by the data.
Definition: Stk.h:418
static void handleError(const char *message, StkError::Type type)
Static function for error reporting and handling using c-strings.
The STK namespace.
Definition: ADSR.h:8