Loris 1.5

Oscillator.h

00001 #ifndef INCLUDE_OSCILLATOR_H
00002 #define INCLUDE_OSCILLATOR_H
00003 /*
00004  * This is the Loris C++ Class Library, implementing analysis, 
00005  * manipulation, and synthesis of digitized sounds using the Reassigned 
00006  * Bandwidth-Enhanced Additive Sound Model.
00007  *
00008  * Loris is Copyright (c) 1999-2010 by Kelly Fitz and Lippold Haken
00009  *
00010  * This program is free software; you can redistribute it and/or modify
00011  * it under the terms of the GNU General Public License as published by
00012  * the Free Software Foundation; either version 2 of the License, or
00013  * (at your option) any later version.
00014  *
00015  * This program is distributed in the hope that it will be useful,
00016  * but WITHOUT ANY WARRANTY, without even the implied warranty of
00017  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
00018  * GNU General Public License for more details.
00019  *
00020  * You should have received a copy of the GNU General Public License
00021  * along with this program; if not, write to the Free Software
00022  * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
00023  *
00024  *
00025  * Oscillator.h
00026  *
00027  * Definition of class Loris::Oscillator, a Bandwidth-Enhanced Oscillator.
00028  *
00029  * Kelly Fitz, 31 Aug 1999
00030  * loris@cerlsoundgroup.org
00031  *
00032  * http://www.cerlsoundgroup.org/Loris/
00033  *
00034  */
00035 
00036 #include "NoiseGenerator.h"
00037 #include "Filter.h"
00038 
00039 //  begin namespace
00040 namespace Loris {
00041 
00042 class Breakpoint;
00043 
00044 // ---------------------------------------------------------------------------
00045 //  class Oscillator
00046 //
00056 //
00057 class Oscillator
00058 {
00059 //  --- implementation ---
00060 
00061     NoiseGenerator m_modulator;     
00062     Filter m_filter;                
00063     
00064     //  instantaneous oscillator state:
00065     double m_instfrequency;         
00066     double m_instamplitude;         
00067     double m_instbandwidth;         
00068     
00069     //  accumulating phase state:
00070     double m_determphase;       
00071 
00072 //  --- interface ---
00073 public:
00074 //  --- construction ---
00075 
00077     Oscillator( void );
00078      
00079     //  Copy, assignment, and destruction are free.
00080     //
00081     //  Copied and assigned Oscillators have the duplicate state
00082     //  variables and the filters have the same coefficients,
00083     //  but the state of the filter delay lines is not copied.
00084 
00085 // --- oscillation ---
00086      
00091     void resetEnvelopes( const Breakpoint & bp, double srate );
00092       
00097     void setPhase( double ph );
00098 
00106     void oscillate( double * begin, double * end,
00107                     const Breakpoint & bp, double srate );
00108 
00109 // --- accessors ---
00110 
00112     double amplitude( void ) const { return m_instamplitude; }
00113     
00115     double bandwidth( void ) const { return m_instbandwidth; }
00116     
00118     double phase( void ) const { return m_determphase; }
00119     
00121     double radianFreq( void ) const { return m_instfrequency; }
00122     
00125     Filter & filter( void ) { return m_filter; }
00126     
00127 // --- static members ---
00128 
00132     static const Filter & prototype_filter( void );
00133      
00134 };  //  end of class Oscillator
00135 
00136 }   //  end of namespace Loris
00137 
00138 #endif /* ndef INCLUDE_OSCILLATOR_H */
 All Classes Functions Variables Typedefs Enumerator Friends