SoundFileL.h

Go to the documentation of this file.

#ifndef CSL_SoundFileL_H
#define CSL_SoundFileL_H

#include "SoundFile.h"          // abstract class header
#include <sndfile.h>            // libsndfile header file

                                // NB: set these as compile-time flags now
//#define USE_MP3               // Support MP3 file reading using libMAD
                                // otherwise assume AIFF or WAV file
//#define CSL_USE_SRConv        // Support sample rate conversion                               
                                
#include "CSL_Includes.h"
#include <sndfile.h>            // libsndfile header file
#include <string.h>

#ifdef CSL_USE_SRConv
    #include <samplerate.h>     // libsamplerate header file

                                // Sample Rate Convertor interpolation modes -- slow to fast
    #define CSL_SRC_MODE SRC_SINC_BEST_QUALITY
    // #define CSL_SRC_MODE SRC_SINC_MEDIUM_QUALITY
    // #define CSL_SRC_MODE SRC_SINC_FASTEST
    // #define CSL_SRC_MODE SRC_ZERO_ORDER_HOLD
    // #define CSL_SRC_MODE SRC_LINEAR
#endif

namespace csl {


class LSoundFile : public Abst_SoundFile {
public:                         
    LSoundFile(string path, int start = -1, int stop = -1);
    LSoundFile(string folder, string path, int start = -1, int stop = -1);
    LSoundFile(LSoundFile & otherSndFile);          
    ~LSoundFile();

    SoundFileFormat format();                       
    
    void openForRead() throw (CException);  


    void openForWrite(SoundFileFormat format = kSoundFileFormatAIFF, 
                    unsigned channels = 1, 
                    unsigned rate = 44100,
                    unsigned bitDepth = 16) throw (CException);
    void openForReadWrite() throw (CException);     
    void close();                                   

    unsigned seekTo(int position, SeekPosition whence = kPositionStart) throw(CException);
    void readBufferFromFile(unsigned numFrames);

    void nextBuffer(Buffer &outB) throw (CException);               
    void writeBuffer(Buffer &inputBuffer) throw (CException);       

#ifdef CSL_USE_SRConv                               
    void convertRate(char * mTempPath, int fromRate, int toRate);
#endif

    SF_INFO * sfInfo() { return mSFInfo; }          
    SNDFILE * sndFile() { return mSndfile; }        

protected:
    SF_INFO * mSFInfo;                              
    SNDFILE * mSndfile;                             
    Interleaver mInterleaver;                       
#ifdef CSL_USE_SRConv
    Buffer mSRConvBuffer;                           
    SRC_STATE * mSRateConv;                         
    SRC_DATA mSRateData;                            
    int mSRCReturn;                                 
#endif
    void initFromSndfile();                         
    void checkBuffer(unsigned numFrames);           
};


#ifdef USE_MP3

#define MP3_TEMP_EXT ".aiff"    // what format to save temp decoded MP3 files

#ifdef CSL_MACOSX               // where to save temp decoded MP3 files - platform-dependent
#define MP3_TEMP_DIR "/tmp/"
#else
#define MP3_TEMP_DIR "/tmp/"        
// #define MP3_TEMP_DIR "."     
#endif

#define DEFAULT_MP3_RATE 44100          // default sample rate for MP3 files

class MP3File : public LSoundFile {
public:                         
    MP3File(string path = "", int start = -1, int stop = -1);
    ~MP3File();

    char * tempPath() { return mTempPath; }         
    virtual void openForRead() throw (CException);  

    virtual void openForWrite(SoundFileFormat format = kSoundFileFormatAIFF, 
                    unsigned channels = 1, 
                    unsigned rate = 44100,
                    unsigned bitDepth = 16) throw (CException);
    virtual void openForReadWrite() throw (CException);     
    
    char * mTempDir;                                
    unsigned mMP3Rate;                              

protected:
    int decodeMP3() throw (CException);             
//  int closef(int which);
    char * mTempPath;                               
    LSoundFile * mTempFile;                         
};

// Temp name macro -- also used by other services
// NB: This is UNIX-specific - ToDo: use run-time file sep

#define MP3_TEMP_NAME(in_path, out_path, temp_dir) {                \
    sprintf(out_path, "%s%s", temp_dir, in_path);                   \
    char * lastDot = strrchr(out_path, (int) '.');                  \
    if (lastDot) sprintf(lastDot, MP3_TEMP_EXT);                    \
    char * pos = out_path;                                          \
    pos += strlen(temp_dir);                                        \
    pos = strchr(pos, (int) '/');                                   \
    while (pos) {                                                   \
        *pos = '_';                                                 \
        pos = strchr(pos, (int) '/');                               \
    }}

// AIFF name macro -- also used by other services
// This assumes the in_path ends with ".mp3"

#define AIFF_TEMP_NAME(in_path, out_path) {                         \
        strcpy(out_path, in_path);                                  \
        strcpy((out_path + strlen(out_path) - 4), ".aiff"); }

#endif // USE_MP3

} // end of namespace

#endif