0c3df1d430
Added a raw audio decoder, allowing raw audio to be played if the format and frequency is known. Will also load from .raw files on disk, but will assume the format is 16 bit mono and the frequency is 22050 hz Added a tutorial to show how recording and playback can be done. Added the ability for the user to unregister audio codecs that they will not be using. Also added methods to test for the existance of a decoder and get the decoder factory back. Moved cVector3.h to include instead of Headers to make using it in user projects easier (one less include path) Moved the audio format enum to its own header file. Small fix in the wav decoder to prevent the file header from being played as audio data.
93 lines
4.6 KiB
C++
93 lines
4.6 KiB
C++
#ifndef CAUDIOCAPTURE_H
|
|
#define CAUDIOCAPTURE_H
|
|
|
|
#include "../include/IAudioCapture.h"
|
|
#include <vector>
|
|
#include <AL/al.h>
|
|
#include <AL/alc.h>
|
|
|
|
namespace cAudio
|
|
{
|
|
class cAudioCapture : public IAudioCapture
|
|
{
|
|
public:
|
|
cAudioCapture();
|
|
~cAudioCapture();
|
|
|
|
//! Checks to see if capturing audio is supported by OpenAL
|
|
//! Normally run automatically by cAudioManager::init()
|
|
bool checkCaptureExtension();
|
|
|
|
//! Grabs samples from the OpenAL buffer into the capture buffer. Should be run once every audio frame.
|
|
//! Normally run automatically by cAudioManager::update()
|
|
void updateCaptureBuffer(bool force = false);
|
|
|
|
//! Shuts down the capture device
|
|
//! Normally run automatically by cAudioManager::shutDown()
|
|
void shutdown();
|
|
|
|
//! Initializes the capture device to the selected settings
|
|
/** Note that calling this will cause the capture device to be reinitialized. Calling while in use may lead to a loss of audio data.
|
|
\param frequency: Frequency that the captured audio will be at
|
|
\param format: Format of the captured audio
|
|
\param internalBufferSize: Size of the internal OpenAL buffer used to store the captured audio until the next IAudioManager::update() in bytes
|
|
\return True on success, False if the capture device failed to initialize.
|
|
*/
|
|
virtual bool initialize(unsigned int frequency = 22050, AudioFormats format = EAF_16BIT_MONO, unsigned int internalBufferSize = 8192);
|
|
//! Returns true if the current OpenAL implementation supports capturing audio
|
|
virtual bool isSupported() { return Supported; }
|
|
//! Returns true if the capture device is ready to be used. False may indicate an error with the current settings.
|
|
virtual bool isReady() { return Ready; }
|
|
|
|
//! Returns the frequency that the captured audio will be at
|
|
virtual unsigned int getFrequency() { return Frequency; }
|
|
//! Returns the format of the captured audio
|
|
virtual AudioFormats getFormat() { return Format; }
|
|
//! Returns the internal OpenAL buffer size in bytes
|
|
virtual unsigned int getInternalBufferSize() { return InternalBufferSize; }
|
|
//! Returns the size of a "sample" of audio data. Useful for making sure you grab audio data at sample boundaries
|
|
virtual unsigned int getSampleSize() { return SampleSize; }
|
|
|
|
//! Sets the frequency that the captured audio will be at. Will cause the capture device to be reinitialized. Calling while in use may lead to a loss of audio data.
|
|
/** \return True on success, False if the capture device failed to initialize. */
|
|
virtual bool setFrequency(unsigned int frequency);
|
|
//! Sets the format that the captured audio will be at. Will cause the capture device to be reinitialized. Calling while in use may lead to a loss of audio data.
|
|
/** \return True on success, False if the capture device failed to initialize. */
|
|
virtual bool setFormat(AudioFormats format);
|
|
//! Sets the internal buffer size that OpenAL will use to store captured audio between calls to IAudioManager::update() in bytes. Will cause the capture device to be reinitialized. Calling while in use may lead to a loss of audio data.
|
|
/** \return True on success, False if the capture device failed to initialize. */
|
|
virtual bool setInternalBufferSize(unsigned int internalBufferSize);
|
|
|
|
//! Starts capturing audio data to an internal buffer. Will clear any old data in the buffer.
|
|
/** \return True if capture was successfully started. */
|
|
virtual bool beginCapture();
|
|
//! Stops capturing audio data to an internal buffer. Will copy any remaining audio data to the capture buffer.
|
|
virtual void stopCapture();
|
|
//! Allows access to the audio data in the internal capture buffer
|
|
/** Can be called at any time to retrieve recorded audio. It is recommended that you call it every so often to prevent the internal buffer from growing too large.
|
|
Once successfully retrieved, the captured audio will be deleted from the internal buffer.
|
|
\param outputBuffer: Pointer to an output array to copy audio data to.
|
|
\param outputBufferSize: Size of the output array in bytes
|
|
*/
|
|
virtual void getCapturedAudio(void* outputBuffer, unsigned int outputBufferSize);
|
|
|
|
//! Returns the current size of the internal audio buffer in bytes
|
|
virtual unsigned int getCurrentCapturedAudioSize();
|
|
protected:
|
|
bool initOpenALDevice();
|
|
void shutdownOpenALDevice();
|
|
|
|
unsigned int Frequency;
|
|
AudioFormats Format;
|
|
unsigned int InternalBufferSize;
|
|
std::vector<char> CaptureBuffer;
|
|
bool Supported;
|
|
bool Ready;
|
|
bool Capturing;
|
|
int SampleSize;
|
|
|
|
ALCdevice* CaptureDevice;
|
|
};
|
|
};
|
|
|
|
#endif //! CAUDIOCAPTURE_H
|