jvoiphrtflocalisation.h

使用VOIP进行网络传输声音的类库

/*

    This file is a part of JVOIPLIB, a library designed to facilitate
    the use of Voice over IP (VoIP).

    Copyright (C) 2000-2004  Jori Liesenborgs ([e-mail])

    This library (JVOIPLIB) is based upon work done for my thesis at
    the School for Knowledge Technology (Belgium/The Netherlands)

    This file was developed at the 'Expertise Centre for Digital
    Media' (EDM) in Diepenbeek, Belgium (http://www.edm.luc.ac.be).
    The EDM is a research institute of the 'Limburgs Universitair
    Centrum' (LUC) (http://www.luc.ac.be).

    The full GNU Library General Public License can be found in the
    file LICENSE.LGPL which is included in the source code archive.

    This library is free software; you can redistribute it and/or
    modify it under the terms of the GNU Library General Public
    License as published by the Free Software Foundation; either
    version 2 of the License, or (at your option) any later version.

    This library is distributed in the hope that it will be useful,
    but WITHOUT ANY WARRANTY; without even the implied warranty of
    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
    Library General Public License for more details.

    You should have received a copy of the GNU Library General Public
    License along with this library; if not, write to the Free
    Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307
    USA

    ACKNOWLEDGEMENTS
    ----------------
    This 3D sound module uses Head-Related Impulse Response data, which
    was obtained from http://sound.media.mit.edu/KEMAR.html (compact.zip).
    The measurements were made by Bill Gardner and Keith Martin, so many
    thanks to them.
*/

#ifndef JVOIPHRTFLOCALISATION_H

#define JVOIPHRTFLOCALISATION_H

#include "jvoipconfig.h"

#ifndef JVOIPDISABLE_LOCALISATION_HRTF

#include "jvoipsessionlocalisation.h"
#include "jvoipsampleconverter.h"

class JVOIPHRTFLocalisation : public JVOIPSessionLocalisation
{
public:
	JVOIPHRTFLocalisation(JVOIPSession *sess);
	~JVOIPHRTFLocalisation();
	int Init(int outputsamprate,int outputbytespersample,const JVOIPComponentParams *componentparams);
	int Cleanup();
	int Create3DEffect(double local_x,double local_y,double local_z,
                           double righteardir_x,double righteardir_y,double righteardir_z,
                           double frontdir_x,double frontdir_y,double frontdir_z,
			   double updir_x,double updir_y,double updir_z,
        	           double remote_x,double remote_y,double remote_z,
                           VoIPFramework::VoiceBlock *vb,
                           VoIPFramework::VOIPuint64 sourceid);
	
	bool SupportsOutputSamplingRate(int orate);
	int SetOutputSamplingRate(int orate);
	bool SupportsOutputBytesPerSample(int outputbytespersample);
	int SetOutputBytesPerSample(int outputbytespersample);
	
	int GetComponentState(JVOIPComponentState **compstate);
	int SetComponentState(JVOIPComponentState *compstate);
	
	std::string GetComponentName();
	std::string GetComponentDescription();
	std::vector<JVOIPCompParamInfo> *GetComponentParameters() throw (JVOIPException);
private:
	void CalculateAzimuthAndElevation();
	void CalculateDistances();
	int AllocateNewBuffer();
	int CreateConvolutionFilters();
	void DestroyConvolutionFilters();
		
	bool init;
	int bytespersample;
	JVOIPSampleConverter sampconv;

	VoIPFramework::VoiceBlock *vblock;
	unsigned char *data;
	int datalen;
	unsigned char *newdata;
	int newdatalen;
	int newnumsamples;
	float *samplebuf,*samplebuf2;

	double localpos[3];
	double remotepos[3];
	double righteardir[3];
	double frontdir[3];
	double updir[3];
	double righteardist,lefteardist;
	int azimuth,elevation;
	bool leftear;
	
	struct AzimuthData
	{
		AzimuthData() { azimuth = 0; numvalues = 0 ; leftvalues = NULL; rightvalues = NULL; }
		~AzimuthData() { if (leftvalues) delete [] leftvalues; if (rightvalues) delete [] rightvalues; }

		int azimuth;
		int numvalues;
		float *leftvalues;
		float *rightvalues;
	};

	struct ElevationData
	{
		ElevationData() { numazimuths = 0; azimuths = NULL; }
		~ElevationData() { if (azimuths) delete [] azimuths; }
		int elevation;
		int numazimuths;
		AzimuthData *azimuths;
	};

	ElevationData *filterdata;
	
	// These structures hold the original HRTF data
	
	struct OrigAzimuthData
	{
		int azimuth;
		int leftresponse[128];
		int rightresponse[128];
	};

	struct OrigElevationData
	{
		int elevation;
		int numazimuths;
		struct OrigAzimuthData *azimuthdata;
	};

	static OrigAzimuthData azimuths_m40[];
	static OrigAzimuthData azimuths_m30[];
	static OrigAzimuthData azimuths_m20[];
	static OrigAzimuthData azimuths_m10[];
	static OrigAzimuthData azimuths_p0[];
	static OrigAzimuthData azimuths_p10[];
	static OrigAzimuthData azimuths_p20[];
	static OrigAzimuthData azimuths_p30[];
	static OrigAzimuthData azimuths_p40[];
	static OrigAzimuthData azimuths_p50[];
	static OrigAzimuthData azimuths_p60[];
	static OrigAzimuthData azimuths_p70[];
	static OrigAzimuthData azimuths_p80[];
	static OrigAzimuthData azimuths_p90[];
	static OrigElevationData elevationdata[]; 	
};

#endif // JVOIPDISABLE_LOCALISATION_HRTF

#endif // JVOIPHRTFLOCALISATION_H