#include <AudioFile.h>

Inheritance diagram for AudioFile:

Collaboration diagram for AudioFile:

Public Member Functions
	AudioFile (const std::string &pFilename)
	Constructor.
	AudioFile (const std::string &pFilename, AudioFileModes pFileMode)
	AudioFile (const AudioFile &pAudioFile)
virtual	~AudioFile ()
virtual void	setAudioFileInfo (const AudioFileInfo &pAudioFileInfo)=0
virtual AudioFileResultType	open (AudioFileModes pOpenMode)
virtual bool	BitrateIsAdjustable () const=0
	Returns whether or not the audio file bitrate is adjustable.
virtual bool	isOpen () const
	Returns whether or not the audio file is open.
virtual bool	hasReadMode () const
	Returns whether or not read mode is enabled for the file.
virtual bool	hasWriteMode () const
	Returns whether or not write mode is enabled for the file.
virtual void	close ()
	Closes the audio file.
virtual AudioFileResultType	getNextSample_int64 (int64_t &pAudioSample)=0
	Gets the next sample from the file, cast to a 64-bit integer.
virtual AudioFileResultType	writeSample_int64 (int64_t pAudioSample)=0
	Writes an audio sample to the file. The parameter is a 64-bit integer but will be cast to the bitness of the audio samples in the file.
virtual AudioFileResultType	getHighestSampleValue_int64 (int64_t &pHighestAudioSample)=0
	Gets the highest audio sample value from the file, cast to a 64-bit integer.
virtual AudioFileResultType	goToAudioDataPos ()=0
	Goes to the audio data position in the audio file.
virtual size_t	numSamples () const=0
	Returns the number of audio samples in the audio file.
virtual int64_t	maxValueForSampleSize () const=0
	Returns the maximum possible positive value of the audio file's sample size.
const std::string &	Filename () const
	Gets the filename of the audio file.
void	Filename (const std::string &pFilename)
	Setter for the filename of the audio file.
void	setMetadata (const std::string &pName, const std::string &pValue)
	Adds a piece of metadata for the audio file.
template<typename T>
void	setMetadataFromVal (const std::string &pName, const T &pValue)
	Adds a piece of metadata for the audio file. Templatized for any value type. The value will be converted to a string to store in the metadata.
AudioFileResultType	getMetadata (const std::string &pName, std::string &pValue) const
	Gets a metadata value as a string.
std::string	getMetadata (const std::string &pName) const
	Gets a metadata value.
template<typename T>
AudioFileResultType	getMetadataAs (const std::string &pName, T &pValue) const
	Gets a metadata value. Templatized to capture the value as any type.
template<typename T>
T	getMetadataAs (const std::string &pName) const
template<typename T>
T	getMetadataAs (const std::string &pName, const T &pDefaultVal) const
	Gets a metadata value. Templatized to return it as any type.
bool	hasMetadata (const std::string &pName) const
	Returns whether or not a metadata item exists.
virtual AudioFileInfo	getAudioFileInfo () const=0
	Returns an AudioFile object with information about the audio file.
virtual void	seekOutputToSampleNum (size_t pSampleNum)=0

Protected Member Functions
virtual std::streampos	fileSizeAccordingToStream ()
virtual void	setFileMode (AudioFileModes pFileMode)

Protected Attributes
std::string	mFilename
std::fstream	mFileStream
std::ios_base::openmode	mFileOpenMode
size_t	mDataSizeBytes
std::map< std::string, std::string >	mMetadata

Constructor & Destructor Documentation

◆ AudioFile() [1/3]

EOUtils::AudioFile::AudioFile ( const std::string & pFilename )

explicit

Constructor.

Parameters

[in] pFilename The name of the audio file

◆ AudioFile() [2/3]

EOUtils::AudioFile::AudioFile	(	const std::string &	pFilename,
		AudioFileModes	pFileMode )

explicit

◆ AudioFile() [3/3]

EOUtils::AudioFile::AudioFile ( const AudioFile & pAudioFile )

◆ ~AudioFile()

EOUtils::AudioFile::~AudioFile ( )

virtual

Member Function Documentation

◆ BitrateIsAdjustable()

virtual bool EOUtils::AudioFile::BitrateIsAdjustable ( ) const

pure virtual

Returns whether or not the audio file bitrate is adjustable.

◆ close()

void EOUtils::AudioFile::close ( )

virtual

Closes the audio file.

◆ Filename() [1/2]

const string & EOUtils::AudioFile::Filename ( ) const

Gets the filename of the audio file.

◆ Filename() [2/2]

void EOUtils::AudioFile::Filename ( const std::string & pFilename )

Setter for the filename of the audio file.

Parameters

[in] pFilename The new filename

◆ fileSizeAccordingToStream()

std::streampos EOUtils::AudioFile::fileSizeAccordingToStream ( )

protectedvirtual

◆ getAudioFileInfo()

virtual AudioFileInfo EOUtils::AudioFile::getAudioFileInfo ( ) const

pure virtual

Returns an AudioFile object with information about the audio file.

◆ getHighestSampleValue_int64()

virtual AudioFileResultType EOUtils::AudioFile::getHighestSampleValue_int64 ( int64_t & pHighestAudioSample )

pure virtual

Gets the highest audio sample value from the file, cast to a 64-bit integer.

Parameters

[out] pHighestAudioSample The highest audio sample from the file, cast to a 64-bit integer

Returns: True on success, or false with error messages on failure

◆ getMetadata() [1/2]

std::string EOUtils::AudioFile::getMetadata ( const std::string & pName ) const

Gets a metadata value.

Parameters

[in] pName The name of the metadata item (string)

Returns: The metadata item value, or a blank string if it doesn't exist

◆ getMetadata() [2/2]

AudioFileResultType EOUtils::AudioFile::getMetadata	(	const std::string &	pName,
		std::string &	pValue ) const

Gets a metadata value as a string.

Parameters

[in]	pName	The name of the metadata item (string)
[out]	pValue	This variable will store the value of the metadata item as a string

Returns: True on success or false with an error if the item doesn't exist

◆ getMetadataAs() [1/3]

template<typename T>

T EOUtils::AudioFile::getMetadataAs ( const std::string & pName ) const

inline

◆ getMetadataAs() [2/3]

template<typename T>

T EOUtils::AudioFile::getMetadataAs	(	const std::string &	pName,
		const T &	pDefaultVal ) const

inline

Gets a metadata value. Templatized to return it as any type.

Parameters

[in] pName The name of the metadata item (string)

Returns: The metadata item value, templatized as the given type

◆ getMetadataAs() [3/3]

template<typename T>

AudioFileResultType EOUtils::AudioFile::getMetadataAs	(	const std::string &	pName,
		T &	pValue ) const

inline

Gets a metadata value. Templatized to capture the value as any type.

Parameters

[in]	pName	The name of the metadata item (string)
[out]	pValue	This variable will store the value of the metadata item. Templatized to store the value as any type.

Returns: True on success or false with an error if the item doesn't exist

◆ getNextSample_int64()

virtual AudioFileResultType EOUtils::AudioFile::getNextSample_int64 ( int64_t & pAudioSample )

pure virtual

Gets the next sample from the file, cast to a 64-bit integer.

Parameters

[out] pAudioSample The next audio sample from the file, cast to a 64-bit integer

Returns: True on success, or false with error messages on failure

◆ goToAudioDataPos()

virtual AudioFileResultType EOUtils::AudioFile::goToAudioDataPos ( )

pure virtual

Goes to the audio data position in the audio file.

◆ hasMetadata()

bool EOUtils::AudioFile::hasMetadata ( const std::string & pName ) const

Returns whether or not a metadata item exists.

Parameters

[in] pName The name of the metadata item to check

Returns: True if the item exists, or false if not

◆ hasReadMode()

bool EOUtils::AudioFile::hasReadMode ( ) const

virtual

Returns whether or not read mode is enabled for the file.

◆ hasWriteMode()

bool EOUtils::AudioFile::hasWriteMode ( ) const

virtual

Returns whether or not write mode is enabled for the file.

◆ isOpen()

bool EOUtils::AudioFile::isOpen ( ) const

virtual

Returns whether or not the audio file is open.

◆ maxValueForSampleSize()

virtual int64_t EOUtils::AudioFile::maxValueForSampleSize ( ) const

pure virtual

Returns the maximum possible positive value of the audio file's sample size.

◆ numSamples()

virtual size_t EOUtils::AudioFile::numSamples ( ) const

pure virtual

Returns the number of audio samples in the audio file.

◆ open()

AudioFileResultType EOUtils::AudioFile::open ( AudioFileModes pOpenMode )

virtual

◆ seekOutputToSampleNum()

virtual void EOUtils::AudioFile::seekOutputToSampleNum ( size_t pSampleNum )

pure virtual

◆ setAudioFileInfo()

virtual void EOUtils::AudioFile::setAudioFileInfo ( const AudioFileInfo & pAudioFileInfo )

pure virtual

◆ setFileMode()

void EOUtils::AudioFile::setFileMode ( AudioFileModes pFileMode )

protectedvirtual

◆ setMetadata()

void EOUtils::AudioFile::setMetadata	(	const std::string &	pName,
		const std::string &	pValue )

Adds a piece of metadata for the audio file.

Parameters

[in]	pName	The name of the metadata item (string)
[in]	pValue	The value of the metadata item (string)

◆ setMetadataFromVal()

template<typename T>

void EOUtils::AudioFile::setMetadataFromVal	(	const std::string &	pName,
		const T &	pValue )

inline

Adds a piece of metadata for the audio file. Templatized for any value type. The value will be converted to a string to store in the metadata.

Parameters

[in]	pName	The name of the metadata item (string)
[in]	pValue	The value of the metadata item (templatized for any type)

◆ writeSample_int64()

virtual AudioFileResultType EOUtils::AudioFile::writeSample_int64 ( int64_t pAudioSample )

pure virtual

Writes an audio sample to the file. The parameter is a 64-bit integer but will be cast to the bitness of the audio samples in the file.

Parameters

[in] pAudioSample The audio sample to write to the file

Returns: True on success, or false with error messages on failure

Member Data Documentation

◆ mDataSizeBytes

size_t EOUtils::AudioFile::mDataSizeBytes

protected

◆ mFilename

std::string EOUtils::AudioFile::mFilename

protected

◆ mFileOpenMode

std::ios_base::openmode EOUtils::AudioFile::mFileOpenMode

protected

◆ mFileStream

std::fstream EOUtils::AudioFile::mFileStream

protected

◆ mMetadata

std::map<std::string, std::string> EOUtils::AudioFile::mMetadata

protected

The documentation for this class was generated from the following files:

/home/erico/projects/audio_mixer_cpp/code/common/AudioFile.h
/home/erico/projects/audio_mixer_cpp/code/common/AudioFile.cpp

Public Member Functions

Protected Member Functions

Protected Attributes

Constructor & Destructor Documentation

◆ AudioFile() [1/3]

◆ AudioFile() [2/3]

◆ AudioFile() [3/3]

◆ ~AudioFile()

Member Function Documentation

◆ BitrateIsAdjustable()

◆ close()

◆ Filename() [1/2]

◆ Filename() [2/2]

◆ fileSizeAccordingToStream()

◆ getAudioFileInfo()

◆ getHighestSampleValue_int64()

◆ getMetadata() [1/2]

◆ getMetadata() [2/2]

◆ getMetadataAs() [1/3]

◆ getMetadataAs() [2/3]

◆ getMetadataAs() [3/3]

◆ getNextSample_int64()

◆ goToAudioDataPos()

◆ hasMetadata()

◆ hasReadMode()

◆ hasWriteMode()

◆ isOpen()

◆ maxValueForSampleSize()

◆ numSamples()

◆ open()

◆ seekOutputToSampleNum()

◆ setAudioFileInfo()

◆ setFileMode()

◆ setMetadata()

◆ setMetadataFromVal()

◆ writeSample_int64()

Member Data Documentation

◆ mDataSizeBytes

◆ mFilename

◆ mFileOpenMode

◆ mFileStream

◆ mMetadata