overte-HifiExperiments/externals/stk/include/BandedWG.h
2013-05-30 12:25:29 -07:00

153 lines
4.2 KiB
C++

#ifndef STK_BANDEDWG_H
#define STK_BANDEDWG_H
#include "Instrmnt.h"
#include "DelayL.h"
#include "BowTable.h"
#include "ADSR.h"
#include "BiQuad.h"
namespace stk {
/***************************************************/
/*! \class BandedWG
\brief Banded waveguide modeling class.
This class uses banded waveguide techniques to
model a variety of sounds, including bowed
bars, glasses, and bowls. For more
information, see Essl, G. and Cook, P. "Banded
Waveguides: Towards Physical Modelling of Bar
Percussion Instruments", Proceedings of the
1999 International Computer Music Conference.
Control Change Numbers:
- Bow Pressure = 2
- Bow Motion = 4
- Strike Position = 8 (not implemented)
- Vibrato Frequency = 11
- Gain = 1
- Bow Velocity = 128
- Set Striking = 64
- Instrument Presets = 16
- Uniform Bar = 0
- Tuned Bar = 1
- Glass Harmonica = 2
- Tibetan Bowl = 3
by Georg Essl, 1999 - 2004.
Modified for STK 4.0 by Gary Scavone.
*/
/***************************************************/
const int MAX_BANDED_MODES = 20;
class BandedWG : public Instrmnt
{
public:
//! Class constructor.
BandedWG( void );
//! Class destructor.
~BandedWG( void );
//! Reset and clear all internal state.
void clear( void );
//! Set strike position (0.0 - 1.0).
void setStrikePosition( StkFloat position );
//! Select a preset.
void setPreset( int preset );
//! Set instrument parameters for a particular frequency.
void setFrequency( StkFloat frequency );
//! Apply bow velocity/pressure to instrument with given amplitude and rate of increase.
void startBowing( StkFloat amplitude, StkFloat rate );
//! Decrease bow velocity/breath pressure with given rate of decrease.
void stopBowing( StkFloat rate );
//! Pluck the instrument with given amplitude.
void pluck( StkFloat amp );
//! Start a note with the given frequency and amplitude.
void noteOn( StkFloat frequency, StkFloat amplitude );
//! Stop a note with the given amplitude (speed of decay).
void noteOff( StkFloat amplitude );
//! Perform the control change specified by \e number and \e value (0.0 - 128.0).
void controlChange( int number, StkFloat value );
//! Compute and return one output sample.
StkFloat tick( unsigned int channel = 0 );
//! 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:
bool doPluck_;
bool trackVelocity_;
int nModes_;
int presetModes_;
BowTable bowTable_;
ADSR adsr_;
BiQuad bandpass_[MAX_BANDED_MODES];
DelayL delay_[MAX_BANDED_MODES];
StkFloat maxVelocity_;
StkFloat modes_[MAX_BANDED_MODES];
StkFloat frequency_;
StkFloat baseGain_;
StkFloat gains_[MAX_BANDED_MODES];
StkFloat basegains_[MAX_BANDED_MODES];
StkFloat excitation_[MAX_BANDED_MODES];
StkFloat integrationConstant_;
StkFloat velocityInput_;
StkFloat bowVelocity_;
StkFloat bowTarget_;
StkFloat bowPosition_;
StkFloat strikeAmp_;
int strikePosition_;
};
inline StkFrames& BandedWG :: tick( StkFrames& frames, unsigned int channel )
{
unsigned int nChannels = lastFrame_.channels();
#if defined(_STK_DEBUG_)
if ( channel > frames.channels() - nChannels ) {
oStream_ << "BandedWG::tick(): channel and StkFrames arguments are incompatible!";
handleError( StkError::FUNCTION_ARGUMENT );
}
#endif
StkFloat *samples = &frames[channel];
unsigned int j, hop = frames.channels() - nChannels;
if ( nChannels == 1 ) {
for ( unsigned int i=0; i<frames.frames(); i++, samples += hop )
*samples++ = tick();
}
else {
for ( unsigned int i=0; i<frames.frames(); i++, samples += hop ) {
*samples++ = tick();
for ( j=1; j<nChannels; j++ )
*samples++ = lastFrame_[j];
}
}
return frames;
}
} // stk namespace
#endif