Envelope.h

#ifndef STK_ENVELOPE_H
#define STK_ENVELOPE_H
 
#include "Generator.h"
 
namespace stk {
 
/***************************************************/
/***************************************************/
 
class Envelope : public Generator
{
 public:
 
  Envelope( void );
 
  ~Envelope( void );
 
  Envelope& operator= ( const Envelope& e );
 
  void keyOn( StkFloat target = 1.0 ) { this->setTarget( target ); };
 
  void keyOff(  StkFloat target = 0.0 ) { this->setTarget( target ); };
 
 
  void setRate( StkFloat rate );
 
 
  void setTime( StkFloat time );
 
  void setTarget( StkFloat target );
 
  void setValue( StkFloat value );
 
  int getState( void ) const { return state_; };
 
  StkFloat lastOut( void ) const { return lastFrame_[0]; };
 
  StkFloat tick( void );
 
 
  StkFrames& tick( StkFrames& frames, unsigned int channel = 0 );
 
 protected:
 
  void sampleRateChanged( StkFloat newRate, StkFloat oldRate );
 
  StkFloat value_;
  StkFloat target_;
  StkFloat rate_;
  int state_;
};
 
inline StkFloat Envelope :: tick( void )
{
  if ( state_ ) {
    if ( target_ > value_ ) {
      value_ += rate_;
      if ( value_ >= target_ ) {
        value_ = target_;
        state_ = 0;
      }
    }
    else {
      value_ -= rate_;
      if ( value_ <= target_ ) {
        value_ = target_;
        state_ = 0;
      }
    }
    lastFrame_[0] = value_;
  }
 
  return value_;
}
 
inline StkFrames& Envelope :: tick( StkFrames& frames, unsigned int channel )
{
#if defined(_STK_DEBUG_)
  if ( channel >= frames.channels() ) {
    oStream_ << "Envelope::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 = tick();
 
  return frames;
}
 
} // stk namespace
 
#endif