Alc/hrtf.h

   1 #ifndef ALC_HRTF_H
   2 #define ALC_HRTF_H
   3
   4 #include "AL/al.h"
   5 #include "AL/alc.h"
   6
   7 #include "alMain.h"
   8 #include "alstring.h"
   9 #include "atomic.h"
  10
  11
  12 /* The maximum number of virtual speakers used to generate HRTF coefficients
  13  * for decoding B-Format.
  14  */
  15 #define HRTF_AMBI_MAX_CHANNELS 16
  16
  17
  18 struct HrtfEntry;
  19
  20 struct Hrtf {
  21     RefCount ref;
  22
  23     ALuint sampleRate;
  24     ALsizei irSize;
  25     ALubyte evCount;
  26
  27     const ALubyte *azCount;
  28     const ALushort *evOffset;
  29     const ALfloat (*coeffs)[2];
  30     const ALubyte (*delays)[2];
  31 };
  32
  33
  34 void FreeHrtfs(void);
  35
  36 vector_EnumeratedHrtf EnumerateHrtf(const_al_string devname);
  37 void FreeHrtfList(vector_EnumeratedHrtf *list);
  38 struct Hrtf *GetLoadedHrtf(struct HrtfEntry *entry);
  39 void Hrtf_IncRef(struct Hrtf *hrtf);
  40 void Hrtf_DecRef(struct Hrtf *hrtf);
  41
  42 void GetHrtfCoeffs(const struct Hrtf *Hrtf, ALfloat elevation, ALfloat azimuth, ALfloat spread, ALfloat (*coeffs)[2], ALsizei *delays);
  43
  44 /**
  45  * Produces HRTF filter coefficients for decoding B-Format, given a set of
  46  * virtual speaker positions and HF/LF matrices for decoding to them. The
  47  * returned coefficients are ordered and scaled according to the matrices.
  48  */
  49 void BuildBFormatHrtf(const struct Hrtf *Hrtf, DirectHrtfState *state, ALsizei NumChannels, const ALfloat (*restrict AmbiPoints)[2], const ALfloat (*restrict AmbiMatrix)[2][MAX_AMBI_COEFFS], ALsizei AmbiCount);
  50
  51 #endif /* ALC_HRTF_H */