/Users/slork/njb/svn/src/common/mo_io.h

Go to the documentation of this file.

/*----------------------------------------------------------------------------
  MoMu: A Mobile Music Toolkit
  Copyright (c) 2010 Nicholas J. Bryan, Jorge Herrera, Jieun Oh, and Ge Wang
  All rights reserved.
    http://momu.stanford.edu/toolkit/
 
  Mobile Music Research @ CCRMA
  Music, Computing, Design Group
  Stanford University
    http://momu.stanford.edu/
    http://ccrma.stanford.edu/groups/mcd/
 
 MoMu is distributed under the following BSD style open source license:
 
 Permission is hereby granted, free of charge, to any person obtaining a 
 copy of this software and associated documentation files (the
 "Software"), to deal in the Software without restriction, including
 without limitation the rights to use, copy, modify, merge, publish,
 distribute, sublicense, and/or sell copies of the Software, and to
 permit persons to whom the Software is furnished to do so, subject to
 the following conditions:
 
 The authors encourage users of MoMu to include this copyright notice,
 and to let us know that you are using MoMu. Any person wishing to 
 distribute modifications to the Software is encouraged to send the 
 modifications to the original authors so that they can be incorporated 
 into the canonical version.
 
 The Software is provided "as is", WITHOUT ANY WARRANTY, express or implied,
 including but not limited to the warranties of MERCHANTABILITY, FITNESS
 FOR A PARTICULAR PURPOSE and NONINFRINGEMENT.  In no event shall the authors
 or copyright holders by liable for any claim, damages, or other liability,
 whether in an actino of a contract, tort or otherwise, arising from, out of
 or in connection with the Software or the use or other dealings in the 
 software.
 -----------------------------------------------------------------------------*/

/*----------------------------------------------------------------------------*/
/*----------------------------------------------------------------------------*/

#ifndef __MO_IO_H__
#define __MO_IO_H__

#include "mo_def.h"
#include <string>

/*----------------------------------------------------------------------------*/
/*----------------------------------------------------------------------------*/
class MoAudioFileIn
{
public:
    MoAudioFileIn();
    
    virtual ~MoAudioFileIn();
    
    virtual bool openFile( const char * fileName, const char * extension, bool raw = FALSE, 
                           bool doNormalize = TRUE, bool generate = true );
    
    void closeFile();
    
    void reset();
    
    /*
     for large, incrementally loaded files with integer data types,
     normalization is computed relative to the data type maximum.
     No normalization is performed for incrementally loaded files
     with floating-point data types. */
    void normalize();
    
    /*
     for large, incrementally loaded files with integer data types,
     normalization is computed relative to the data type maximum 
     (peak/maximum).  For incrementally loaded files with floating-
     point data types, direct scaling by peak is performed. */
    void normalize( SAMPLE peak );
    
    unsigned long getSize() const;
    
    unsigned int getChannels() const;
    
    /*
     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. */
    SAMPLE getFileRate() const;
    
    bool isFinished() const;
    
    void setRate( SAMPLE aRate );

    virtual void addTime( SAMPLE aTime );


    void setInterpolate( bool doInterpolate );

    virtual SAMPLE lastOut() const;
    
    virtual SAMPLE tick();
    
    virtual SAMPLE * tick( SAMPLE * vector, unsigned int vectorSize );
    
    virtual const SAMPLE * lastFrame() const;
    
    virtual const SAMPLE * tickFrame();
    
    virtual SAMPLE * tickFrame( SAMPLE *frameVector, unsigned int frames );

public: // SWAP formerly protected
    typedef unsigned long STK_FORMAT;
    static const STK_FORMAT STK_SINT8;  /* -128 to +127 */
    static const STK_FORMAT STK_SINT16; /* -32768 to +32767 */
    static const STK_FORMAT STK_SINT32; /* -2147483648 to +2147483647. */
    static const STK_FORMAT MY_FLOAT32; /* normalized between plus/minus 1.0. */
    static const STK_FORMAT MY_FLOAT64; /* normalized between plus/minus 1.0. */

    // initialize class variables
    void init();
    // read file data
    virtual bool readData( unsigned long index );
    // get STK RAW file information
    bool getRawInfo( const char *fileName );
    // 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 );

    // char msg[256];
    const char * m_filename; // chuck data
    FILE * fd;
    SAMPLE * data;
    SAMPLE * lastOutput;
    bool chunking;
    bool finished;
    bool interpolate;
    bool byteswap;
    unsigned long fileSize;
    unsigned long bufferSize;
    unsigned long dataOffset;
    unsigned int channels;
    long chunkPointer;
    STK_FORMAT dataType;
    SAMPLE fileRate;
    SAMPLE gain;
    SAMPLE time;
    SAMPLE rate;

public:
    bool m_loaded;
    SAMPLE m_gain;
};




#endif