CAmbisonicBinauralizer Class Reference

Ambisonic binauralizer. More...

#include <AmbisonicBinauralizer.h>

Inheritance diagram for CAmbisonicBinauralizer:

[legend]Collaboration diagram for CAmbisonicBinauralizer:


Public Member Functions
	CAmbisonicBinauralizer (AmbInt nOrder=DEFAULT_ORDER, AmbInt b3D=DEFAULT_HEIGHT, AmbInt nSampleRate=DEFAULT_SAMPLERATE, AmbInt nBlockSize=DEFAULT_BLOCKSIZE, AmbInt bDiffused=DEFAULT_HRTFSET_DIFFUSED)
	~CAmbisonicBinauralizer ()
virtual AmbInt	Create (AmbInt nOrder, AmbInt b3D, AmbInt nSampleRate, AmbInt nBlockSize, AmbInt bDiffused)
virtual void	Reset ()
virtual void	Refresh ()
void	Process (CBFormat pBFSrc, AmbFloat *ppfDst)
Protected Member Functions
void	ArrangeSpeakers ()
void	AllocateBuffers ()
void	DeallocateBuffers ()
Protected Attributes
CAmbisonicDecoder	m_AmbDecoder
AmbInt	m_nBlockSize
AmbInt	m_nTaps
AmbInt	m_nFFTSize
AmbInt	m_nFFTBins
AmbFloat	m_fFFTScaler
AmbInt	m_nOverlapLength
kiss_fftr_cfg	m_pFFT_cfg
kiss_fftr_cfg	m_pIFFT_cfg
kiss_fft_cpx **	m_ppcpFilters [2]
kiss_fft_cpx *	m_pcpScratch
AmbFloat *	m_pfScratchBufferA
AmbFloat *	m_pfScratchBufferB
AmbFloat *	m_pfOverlap [2]

Detailed Description

Ambisonic binauralizer.

B-Format to binaural decoder.

Constructor & Destructor Documentation

CAmbisonicBinauralizer::CAmbisonicBinauralizer	(	AmbInt	nOrder = `DEFAULT_ORDER`,
		AmbInt	b3D = `DEFAULT_HEIGHT`,
		AmbInt	nSampleRate = `DEFAULT_SAMPLERATE`,
		AmbInt	nBlockSize = `DEFAULT_BLOCKSIZE`,
		AmbInt	bDiffused = `DEFAULT_HRTFSET_DIFFUSED`
	)

Constructor that allows for the format to be specified. If the format arguments are not specified, the values set for DEFAULT_ORDER, and DEFAULT_HEIGHT, will be used instead, as wel as a default sample rate of DEFAULT_SAMPLERATE, default block size of DEFAULT_BLOCKSIZE, and default HRTF set diffused of DEFAULT_HRTFSET_DIFFUSED.

CAmbisonicBinauralizer::~CAmbisonicBinauralizer ( )

Member Function Documentation

AmbInt CAmbisonicBinauralizer::Create	(	AmbInt	nOrder,
		AmbInt	b3D,
		AmbInt	nSampleRate,
		AmbInt	nBlockSize,
		AmbInt	bDiffused
	)			`[virtual]`

Re-create the object for the given configuration. Previous data is lost. The function returns the number of taps used for the processing, and this can be used to offset the delay this causes. If the creation fails, then the return will be 0/false.

void CAmbisonicBinauralizer::Reset ( ) [virtual]

Resets members.

Implements CAmbisonicBase.

void CAmbisonicBinauralizer::Refresh ( ) [virtual]

Refreshes coefficients.

Implements CAmbisonicBase.

void CAmbisonicBinauralizer::Process	(	CBFormat *	pBFSrc,
		AmbFloat **	ppfDst
	)

Decode B-Format to binaural feeds. There is no arguement for the number of samples to process, as this is determined by the nBlockSize argument in the constructor and Create() function. It is the responsibility of program using this library to handle the blocks of the signal by FIFO buffers or other means.

void CAmbisonicBinauralizer::ArrangeSpeakers ( ) [protected]