96 lines
3.2 KiB
C++
96 lines
3.2 KiB
C++
#ifndef STAR_AUDIO_HPP
|
|
#define STAR_AUDIO_HPP
|
|
|
|
#include "StarIODevice.hpp"
|
|
|
|
namespace Star {
|
|
|
|
STAR_CLASS(CompressedAudioImpl);
|
|
STAR_CLASS(UncompressedAudioImpl);
|
|
STAR_CLASS(Audio);
|
|
|
|
STAR_EXCEPTION(AudioException, StarException);
|
|
|
|
// Simple class for reading audio files in ogg/vorbis and wav format.
|
|
// Reads and allows for decompression of a limited subset of ogg/vorbis. Does
|
|
// not handle multiple bitstreams, sample rate or channel number changes.
|
|
// Entire stream is kept in memory, and is implicitly shared so copying Audio
|
|
// instances is not expensive.
|
|
class Audio {
|
|
public:
|
|
explicit Audio(IODevicePtr device);
|
|
Audio(Audio const& audio);
|
|
Audio(Audio&& audio);
|
|
|
|
Audio& operator=(Audio const& audio);
|
|
Audio& operator=(Audio&& audio);
|
|
|
|
// This function returns the number of channels that this file has. Channels
|
|
// are static throughout file.
|
|
unsigned channels() const;
|
|
|
|
// This function returns the sample rate that this file has. Sample rates
|
|
// are static throughout file.
|
|
unsigned sampleRate() const;
|
|
|
|
// This function returns the playtime duration of the file.
|
|
double totalTime() const;
|
|
|
|
// This function returns total number of samples in this file.
|
|
uint64_t totalSamples() const;
|
|
|
|
// This function returns true when the datastream or file being read from is
|
|
// a vorbis compressed file. False otherwise.
|
|
bool compressed() const;
|
|
|
|
// If compressed, permanently uncompresses audio for faster reading. The
|
|
// uncompressed buffer is shared with all further copies of Audio, and this
|
|
// is irreversible.
|
|
void uncompress();
|
|
|
|
// This function seeks the data stream to the given time in seconds.
|
|
void seekTime(double time);
|
|
|
|
// This function seeks the data stream to the given sample number
|
|
void seekSample(uint64_t sample);
|
|
|
|
// This function converts the current offset of the file to the time value of
|
|
// that offset in seconds.
|
|
double currentTime() const;
|
|
|
|
// This function converts the current offset of the file to the current
|
|
// sample number.
|
|
uint64_t currentSample() const;
|
|
|
|
// Reads into 16 bit signed buffer with channels interleaved. Returns total
|
|
// number of samples read (counting each channel individually). 0 indicates
|
|
// end of stream.
|
|
size_t readPartial(int16_t* buffer, size_t bufferSize);
|
|
|
|
// Same as readPartial, but repeats read attempting to fill buffer as much as
|
|
// possible
|
|
size_t read(int16_t* buffer, size_t bufferSize);
|
|
|
|
// Read into a given buffer, while also converting into the given number of
|
|
// channels at the given sample rate and playback velocity. If the number of
|
|
// channels in the file is higher, only populates lower channels, if it is
|
|
// lower, the last channel is copied to the remaining channels. Attempts to
|
|
// fill the buffer as much as possible up to end of stream. May fail to fill
|
|
// an entire buffer depending on the destinationSampleRate / velocity /
|
|
// available samples.
|
|
size_t resample(unsigned destinationChannels, unsigned destinationSampleRate,
|
|
int16_t* destinationBuffer, size_t destinationBufferSize,
|
|
double velocity = 1.0);
|
|
|
|
private:
|
|
// If audio is uncompressed, this will be null.
|
|
CompressedAudioImplPtr m_compressed;
|
|
UncompressedAudioImplPtr m_uncompressed;
|
|
|
|
ByteArray m_workingBuffer;
|
|
};
|
|
|
|
}
|
|
|
|
#endif
|