AudioFileUtilities Namespace Reference

A collection of functions for loading and storing audio files. More...

Functions
int	getSamples (const std::string &file, float *buf, unsigned int channel, unsigned int startFrame, unsigned int endFrame)
int	getNumChannels (const std::string &file)
int	getNumFrames (const std::string &file)
int	write (const std::string &filename, float *buf, unsigned int channels, unsigned int frames, unsigned int samplerate)
int	write (const std::string &filename, const std::vector< std::vector< float > > &dataIn, unsigned int sampleRate)
std::vector< std::vector< float > >	load (const std::string &filename, int maxCount=-1, unsigned int start=0)
std::vector< float >	loadMono (const std::string &file)

Detailed Description

A collection of functions for loading and storing audio files.

A collection of functions for loading and storing audio files.

Function Documentation

getSamples()

int AudioFileUtilities::getSamples	(	const std::string &	file,
		float *	buf,
		unsigned int	channel,
		unsigned int	startFrame,
		unsigned int	endFrame )

Load audio frames between startFrame and endFrame from channel of the specified file into the preallocated memory location buf.

Returns

0 on success, or an error code upon failure.

Examples

Audio/sample-streamer/render.cpp.

getNumChannels()

int AudioFileUtilities::getNumChannels

(

const std::string &

file

)

Get the number of audio channels in file.

Returns

the number of audio channels on success, or a negative error code upon failure.

getNumFrames()

int AudioFileUtilities::getNumFrames

(

const std::string &

file

)

Get the number of audio frames in file.

Returns

the number of frames on success, or a negative error code upon failure.

Examples

Audio/sample-streamer/render.cpp.

write() [1/2]

int AudioFileUtilities::write	(	const std::string &	filename,
		float *	buf,
		unsigned int	channels,
		unsigned int	frames,
		unsigned int	samplerate )

Store samples from memory into an audio file on disk.

Parameters

filename	the file to write to
buf	a vector containing channels * frames of interlaved data
channels	the channels in the data and output file
frames	the frames in the data and output file
sampleRate	the sampling rate of the data

Examples

Audio/record-audio/render.cpp.

write() [2/2]

int AudioFileUtilities::write	(	const std::string &	filename,
		const std::vector< std::vector< float > > &	dataIn,
		unsigned int	sampleRate )

Write non-interlaved samples from memory into an audio file on disk.

Parameters

filename	the file to write to
dataIn	a vector containing one vector of data per channel
sampleRate	the sampling rate of the data

load()

std::vector< std::vector< float > > AudioFileUtilities::load	(	const std::string &	filename,
		int	maxCount = -1,
		unsigned int	start = 0 )

Load audio samples from a file into memory.

Loads at most count samples from each channel of filename, starting from frame start.

Parameters

filename	the file to load
maxCount	the maximum number of samples to load from each channel. Pass a negative value for no limit.
start	the first sample to load.

Returns

a vector containing one vector of data per channel.

Examples

Audio/sample-loader/render.cpp, Audio/sample-piezo-trigger/render.cpp, and Audio/sample-streamer/render.cpp.

loadMono()

std::vector< float > AudioFileUtilities::loadMono

(

const std::string &

file

)

Load audio samples from a file into memory.

Simplified version of load(), which only loads the first channel of the file.

Examples

terminal-only/filter-FIR/render.cpp, terminal-only/filter-IIR/render.cpp, and terminal-only/samples/render.cpp.