beeps 0.1.12 → 0.1.13

data/src/stk/include/FileRead.h

@@ -1,141 +0,0 @@
-#ifndef STK_FILEREAD_H
-#define STK_FILEREAD_H
-
-#include "Stk.h"
-
-namespace stk {
-
-/***************************************************/
-/*! \class FileRead
-    \brief STK audio file input class.
-
-    This class provides input support for various
-    audio file formats.  Multi-channel (>2)
-    soundfiles are supported.  The file data is
-    returned via an external StkFrames object
-    passed to the read() function.  This class
-    does not store its own copy of the file data,
-    rather the data is read directly from disk.
-
-    FileRead currently supports uncompressed WAV,
-    AIFF/AIFC, SND (AU), MAT-file (Matlab), and
-    STK RAW file formats.  Signed integer (8-,
-    16-, 24-, and 32-bit) and floating-point (32- and
-    64-bit) data types are supported.  Compressed
-    data types are not supported.
-
-    STK RAW files have no header and are assumed to
-    contain a monophonic stream of 16-bit signed
-    integers in big-endian byte order at a sample
-    rate of 22050 Hz.  MAT-file data should be saved
-    in an array with each data channel filling a
-    matrix row.  The sample rate for MAT-files should
-    be specified in a variable named "fs".  If no
-    such variable is found, the sample rate is
-    assumed to be 44100 Hz.
-
-    by Perry R. Cook and Gary P. Scavone, 1995--2014.
-*/
-/***************************************************/
-
-class FileRead : public Stk
-{
-public:
-  //! Default constructor.
-  FileRead( void );
-
-  //! Overloaded constructor that opens a file during instantiation.
-  /*!
-    An StkError will be thrown if the file is not found or its
-    format is unknown or unsupported.  The optional arguments allow a
-    headerless file type to be supported.  If \c typeRaw is false (the
-    default), the subsequent parameters are ignored.
-  */
-  FileRead( std::string fileName, bool typeRaw = false, unsigned int nChannels = 1,
-            StkFormat format = STK_SINT16, StkFloat rate = 22050.0 );
-
-  //! Class destructor.
-  ~FileRead( void );
-
-  //! Open the specified file and determine its formatting.
-  /*!
-    An StkError will be thrown if the file is not found or its
-    format is unknown or unsupported.  The optional arguments allow a
-    headerless file type to be supported.  If \c typeRaw is false (the
-    default), the subsequent parameters are ignored.
-  */
-  void open( std::string fileName, bool typeRaw = false, unsigned int nChannels = 1,
-             StkFormat format = STK_SINT16, StkFloat rate = 22050.0 );
-
-  //! If a file is open, close it.
-  void close( void );
-
-  //! Returns \e true if a file is currently open.
-  bool isOpen( void );
-
-  //! Return the file size in sample frames.
-  unsigned long fileSize( void ) const { return fileSize_; };
-
-  //! Return the number of audio channels in the file.
-  unsigned int channels( void ) const { return channels_; };
-
-  //! Return the data format of the file.
-  StkFormat format( void ) const { return dataType_; };
-
-  //! Return the file sample rate in Hz.
-  /*!
-    WAV, SND, and AIF formatted files specify a sample rate in
-    their headers.  By definition, STK RAW files have a sample rate of
-    22050 Hz.  MAT-files are assumed to have a rate of 44100 Hz.
-  */
-  StkFloat fileRate( void ) const { return fileRate_; };
-
-  //! Read sample frames from the file into an StkFrames object.
-  /*!
-    The number of sample frames to read will be determined from the
-    number of frames of the StkFrames argument.  If this size is
-    larger than the available data in the file (given the file size
-    and starting frame index), the extra frames will be unaffected
-    (the StkFrames object will not be resized).  Optional parameters
-    are provided to specify the starting sample frame within the file
-    (default = 0) and whether to normalize the data with respect to
-    fixed-point limits (default = true).  An StkError will be thrown
-    if a file error occurs or if the number of channels in the
-    StkFrames argument is not equal to that in the file.
-   */
-  void read( StkFrames& buffer, unsigned long startFrame = 0, bool doNormalize = true );
-
-protected:
-
-  // Get STK RAW file information.
-  bool getRawInfo( const char *fileName, unsigned int nChannels,
-                   StkFormat format, StkFloat rate );
-
-  // Get WAV file header information.
-  bool getWavInfo( const char *fileName );
-
-  // Get SND (AU) file header information.
-  bool getSndInfo( const char *fileName );
-
-  // Get AIFF file header information.
-  bool getAifInfo( const char *fileName );
-
-  // Get MAT-file header information.
-  bool getMatInfo( const char *fileName );
-
-  // Helper function for MAT-file parsing.
-  bool findNextMatArray( SINT32 *chunkSize, SINT32 *rows, SINT32 *columns, SINT32 *nametype );
-
-  FILE *fd_;
-  bool byteswap_;
-  bool wavFile_;
-  unsigned long fileSize_;
-  unsigned long dataOffset_;
-  unsigned int channels_;
-  StkFormat dataType_;
-  StkFloat fileRate_;
-};
-
-} // stk namespace
-
-#endif

data/src/stk/include/FileWvIn.h

@@ -1,195 +0,0 @@
-#ifndef STK_FILEWVIN_H
-#define STK_FILEWVIN_H
-
-#include "WvIn.h"
-#include "FileRead.h"
-
-namespace stk {
-
-/***************************************************/
-/*! \class FileWvIn
-    \brief STK audio file input class.
-
-    This class inherits from WvIn.  It provides a "tick-level"
-    interface to the FileRead class.  It also provides variable-rate
-    playback functionality.  Audio file support is provided by the
-    FileRead class.  Linear interpolation is used for fractional read
-    rates.
-
-    FileWvIn supports multi-channel data.  It is important to
-    distinguish the tick() method that computes a single frame (and
-    returns only the specified sample of a multi-channel frame) from
-    the overloaded one that takes an StkFrames object for
-    multi-channel and/or multi-frame data.
-
-    FileWvIn will either load the entire content of an audio file into
-    local memory or incrementally read file data from disk in chunks.
-    This behavior is controlled by the optional constructor arguments
-    \e chunkThreshold and \e chunkSize.  File sizes greater than \e
-    chunkThreshold (in sample frames) will be read incrementally in
-    chunks of \e chunkSize each (also in sample frames).
-
-    When the file end is reached, subsequent calls to the tick()
-    functions return zeros and isFinished() returns \e true.
-
-    See the FileRead class for a description of the supported audio
-    file formats.
-
-    by Perry R. Cook and Gary P. Scavone, 1995--2014.
-*/
-/***************************************************/
-
-class FileWvIn : public WvIn
-{
-public:
-  //! Default constructor.
-  FileWvIn( unsigned long chunkThreshold = 1000000, unsigned long chunkSize = 1024 );
-
-  //! Overloaded constructor for file input.
-  /*!
-    An StkError will be thrown if the file is not found, its format is
-    unknown, or a read error occurs.
-  */
-  FileWvIn( std::string fileName, bool raw = false, bool doNormalize = true,
-            unsigned long chunkThreshold = 1000000, unsigned long chunkSize = 1024 );
-
-  //! Class destructor.
-  ~FileWvIn( void );
-
-  //! Open the specified file and load its data.
-  /*!
-    Data from a previously opened file will be overwritten by this
-    function.  An StkError will be thrown if the file is not found,
-    its format is unknown, or a read error occurs.  If the file data
-    is to be loaded incrementally from disk and normalization is
-    specified, a scaling will be applied with respect to fixed-point
-    limits.  If the data format is floating-point, no scaling is
-    performed.
-  */
-  virtual void openFile( std::string fileName, bool raw = false, bool doNormalize = true );
-
-  //! Close a file if one is open.
-  virtual void closeFile( void );
-
-  //! Clear outputs and reset time (file) pointer to zero.
-  virtual void reset( void );
-
-  //! Normalize data to a maximum of +-1.0.
-  /*!
-    This function has no effect when data is incrementally loaded
-    from disk.
-  */
-  virtual void normalize( void );
-
-  //! Normalize data to a maximum of \e +-peak.
-  /*!
-    This function has no effect when data is incrementally loaded
-    from disk.
-  */
-  virtual void normalize( StkFloat peak );
-
-  //! Return the file size in sample frames.
-  virtual unsigned long getSize( void ) const { return file_.fileSize(); };
-
-  //! Return the input file sample rate in Hz (not the data read rate).
-  /*!
-    WAV, SND, and AIF formatted files specify a sample rate in
-    their headers.  STK RAW files have a sample rate of 22050 Hz
-    by definition.  MAT-files are assumed to have a rate of 44100 Hz.
-  */
-  virtual StkFloat getFileRate( void ) const { return data_.dataRate(); };
-
-  //! Query whether a file is open.
-  bool isOpen( void ) { return file_.isOpen(); };
-
-  //! Query whether reading is complete.
-  bool isFinished( void ) const { return finished_; };
-
-  //! Set the data read rate in samples.  The rate can be negative.
-  /*!
-    If the rate value is negative, the data is read in reverse order.
-  */
-  virtual void setRate( StkFloat rate );
-
-  //! Increment the read pointer by \e time samples.
-  /*!
-    Note that this function will not modify the interpolation flag status.
-   */
-  virtual void addTime( StkFloat time );
-
-  //! Turn linear interpolation on/off.
-  /*!
-    Interpolation is automatically off when the read rate is
-    an integer value.  If interpolation is turned off for a
-    fractional rate, the time index is truncated to an integer
-    value.
-  */
-  void setInterpolate( bool doInterpolate ) { interpolate_ = doInterpolate; };
-
-  //! Return the specified channel value of the last computed frame.
-  /*!
-    If no file is loaded, the returned value is 0.0.  The \c
-    channel argument must be less than the number of output channels,
-    which can be determined with the channelsOut() function (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. \sa
-    lastFrame()
-  */
-  StkFloat lastOut( unsigned int channel = 0 );
-
-  //! Compute a sample frame and return the specified \c channel value.
-  /*!
-    For multi-channel files, use the lastFrame() function to get
-    all values from the computed frame.  If no file data is loaded,
-    the returned value is 0.0.  The \c channel argument must be less
-    than the number of channels in the file data (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.
-  */
-  virtual StkFloat tick( unsigned int channel = 0 );
-
-  //! Fill the StkFrames object with computed sample frames, starting at the specified channel and return the same reference.
-  /*!
-    The \c channel argument plus the number of input channels 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.
-  */
-  virtual StkFrames& tick( StkFrames& frames,unsigned int channel = 0 );
-
-protected:
-
-  void sampleRateChanged( StkFloat newRate, StkFloat oldRate );
-
-  FileRead file_;
-  bool finished_;
-  bool interpolate_;
-  bool normalizing_;
-  bool chunking_;
-  StkFloat time_;
-  StkFloat rate_;
-  unsigned long chunkThreshold_;
-  unsigned long chunkSize_;
-  long chunkPointer_;
-
-};
-
-inline StkFloat FileWvIn :: lastOut( unsigned int channel )
-{
-#if defined(_STK_DEBUG_)
-  if ( channel >= data_.channels() ) {
-    oStream_ << "FileWvIn::lastOut(): channel argument and soundfile data are incompatible!";
-    handleError( StkError::FUNCTION_ARGUMENT );
-  }
-#endif
-
-  if ( finished_ ) return 0.0;
-  return lastFrame_[channel];
-}
-
-} // stk namespace
-
-#endif

data/src/stk/include/Generator.h

@@ -1,50 +0,0 @@
-#ifndef STK_GENERATOR_H
-#define STK_GENERATOR_H
-
-#include "Stk.h"
-
-namespace stk {
-
-/***************************************************/
-/*! \class Generator
-    \brief STK abstract unit generator parent class.
-
-    This class provides limited common functionality for STK unit
-    generator sample-source subclasses.  It is general enough to
-    support both monophonic and polyphonic output classes.
-
-    by Perry R. Cook and Gary P. Scavone, 1995--2014.
-*/
-/***************************************************/
-
-class Generator : public Stk
-{
- public:
-
-  //! Class constructor.
-  Generator( void ) { lastFrame_.resize( 1, 1, 0.0 ); };
-
-  //! Return the number of output channels for the class.
-  unsigned int channelsOut( void ) const { return lastFrame_.channels(); };
-
-  //! Return an StkFrames reference to the last output sample frame.
-  const StkFrames& lastFrame( void ) const { return lastFrame_; };
-
-  //! Fill the StkFrames object with computed sample frames, starting at the specified channel.
-  /*!
-    The \c channel argument plus the number of output channels 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.
-  */
-  virtual StkFrames& tick( StkFrames& frames, unsigned int channel = 0 ) = 0;
-
-  protected:
-
-  StkFrames lastFrame_;
-};
-
-} // stk namespace
-
-#endif

data/src/stk/include/SineWave.h

@@ -1,159 +0,0 @@
-#ifndef STK_SINEWAVE_H
-#define STK_SINEWAVE_H
-
-const unsigned long TABLE_SIZE = 2048;
-
-#include "Generator.h"
-
-namespace stk {
-
-/***************************************************/
-/*! \class SineWave
-    \brief STK sinusoid oscillator class.
-
-    This class computes and saves a static sine "table" that can be
-    shared by multiple instances.  It has an interface similar to the
-    WaveLoop class but inherits from the Generator class.  Output
-    values are computed using linear interpolation.
-
-    The "table" length, set in SineWave.h, is 2048 samples by default.
-
-    by Perry R. Cook and Gary P. Scavone, 1995--2014.
-*/
-/***************************************************/
-
-class SineWave : public Generator
-{
-public:
-  //! Default constructor.
-  SineWave( void );
-
-  //! Class destructor.
-  ~SineWave( void );
-
-  //! Clear output and reset time pointer to zero.
-  void reset( void );
-
-  //! Set the data read rate in samples.  The rate can be negative.
-  /*!
-    If the rate value is negative, the data is read in reverse order.
-  */
-  void setRate( StkFloat rate ) { rate_ = rate; };
-
-  //! Set the data interpolation rate based on a looping frequency.
-  /*!
-    This function determines the interpolation rate based on the file
-    size and the current Stk::sampleRate.  The \e frequency value
-    corresponds to file cycles per second.  The frequency can be
-    negative, in which case the loop is read in reverse order.
-   */
-  void setFrequency( StkFloat frequency );
-
-  //! Increment the read pointer by \e time in samples, modulo the table size.
-  void addTime( StkFloat time );
-
-  //! Increment the read pointer by a normalized \e phase value.
-  /*!
-    This function increments the read pointer by a normalized phase
-    value, such that \e phase = 1.0 corresponds to a 360 degree phase
-    shift.  Positive or negative values are possible.
-   */
-  void addPhase( StkFloat phase );
-
-  //! Add a normalized phase offset to the read pointer.
-  /*!
-    A \e phaseOffset = 1.0 corresponds to a 360 degree phase
-    offset.  Positive or negative values are possible.
-   */
-  void addPhaseOffset( StkFloat phaseOffset );
-
-  //! 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 );
-
-  static StkFrames table_;
-  StkFloat time_;
-  StkFloat rate_;
-  StkFloat phaseOffset_;
-  unsigned int iIndex_;
-  StkFloat alpha_;
-
-};
-
-inline StkFloat SineWave :: tick( void )
-{
-  // Check limits of time address ... if necessary, recalculate modulo
-  // TABLE_SIZE.
-  while ( time_ < 0.0 )
-    time_ += TABLE_SIZE;
-  while ( time_ >= TABLE_SIZE )
-    time_ -= TABLE_SIZE;
-
-  iIndex_ = (unsigned int) time_;
-  alpha_ = time_ - iIndex_;
-  StkFloat tmp = table_[ iIndex_ ];
-  tmp += ( alpha_ * ( table_[ iIndex_ + 1 ] - tmp ) );
-
-  // Increment time, which can be negative.
-  time_ += rate_;
-
-  lastFrame_[0] = tmp;
-  return lastFrame_[0];
-}
-
-inline StkFrames& SineWave :: tick( StkFrames& frames, unsigned int channel )
-{
-#if defined(_STK_DEBUG_)
-  if ( channel >= frames.channels() ) {
-    oStream_ << "SineWave::tick(): channel and StkFrames arguments are incompatible!";
-    handleError( StkError::FUNCTION_ARGUMENT );
-  }
-#endif
-
-  StkFloat *samples = &frames[channel];
-  StkFloat tmp = 0.0;
-
-  unsigned int hop = frames.channels();
-  for ( unsigned int i=0; i<frames.frames(); i++, samples += hop ) {
-
-    // Check limits of time address ... if necessary, recalculate modulo
-    // TABLE_SIZE.
-    while ( time_ < 0.0 )
-      time_ += TABLE_SIZE;
-    while ( time_ >= TABLE_SIZE )
-      time_ -= TABLE_SIZE;
-
-    iIndex_ = (unsigned int) time_;
-    alpha_ = time_ - iIndex_;
-    tmp = table_[ iIndex_ ];
-    tmp += ( alpha_ * ( table_[ iIndex_ + 1 ] - tmp ) );
-    *samples = tmp;
-
-    // Increment time, which can be negative.
-    time_ += rate_;
-  }
-
-  lastFrame_[0] = tmp;
-  return frames;
-}
-
-} // stk namespace
-
-#endif
-