audiodata.h

/*************************************************************************
 
  Copyright 2011-2015 Ibrahim Sha'ath
 
  This file is part of LibKeyFinder.
 
  LibKeyFinder is free software: you can redistribute it and/or modify
  it under the terms of the GNU General Public License as published by
  the Free Software Foundation, either version 3 of the License, or
  (at your option) any later version.
 
  LibKeyFinder is distributed in the hope that it will be useful,
  but WITHOUT ANY WARRANTY; without even the implied warranty of
  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  GNU General Public License for more details.
 
  You should have received a copy of the GNU General Public License
  along with LibKeyFinder.  If not, see <http://www.gnu.org/licenses/>.
 
*************************************************************************/
 
#ifndef AUDIOSTREAM_H
#define AUDIOSTREAM_H
 
#include "constants.h"
 
namespace KeyFinder {
 
  class AudioData {
  public:
    AudioData();
 
    unsigned int getChannels() const;
    unsigned int getFrameRate() const;
    double getSample(unsigned int index) const;
    double getSampleByFrame(unsigned int frame, unsigned int channel) const;
    double getSampleAtReadIterator() const;
    unsigned int getSampleCount() const;
    unsigned int getFrameCount() const;
 
    void setChannels(unsigned int newChannels);
    void setFrameRate(unsigned int newFrameRate);
    void setSample(unsigned int index, double value);
    void setSampleByFrame(unsigned int frame, unsigned int channels, double value);
    void setSampleAtWriteIterator(double value);
    void addToSampleCount(unsigned int newSamples);
    void addToFrameCount(unsigned int newFrames);
 
    void advanceReadIterator(unsigned int by = 1);
    void advanceWriteIterator(unsigned int by = 1);
    bool readIteratorWithinUpperBound() const;
    bool writeIteratorWithinUpperBound() const;
    void resetIterators();
 
    void append(const AudioData& that);
    void prepend(const AudioData& that);
    void discardFramesFromFront(unsigned int discardFrameCount);
    void reduceToMono();
    void downsample(unsigned int factor, bool shortcut = true);
    AudioData* sliceSamplesFromBack(unsigned int sliceSampleCount);
 
  private:
    std::deque<double> samples;
    unsigned int channels;
    unsigned int frameRate;
    std::deque<double>::const_iterator readIterator;
    std::deque<double>::iterator writeIterator;
  };
 
}
 
#endif