saf_hrir.h

Go to the documentation of this file.

/*
 * Copyright 2016-2018 Leo McCormack
 *
 * Permission to use, copy, modify, and/or distribute this software for any
 * purpose with or without fee is hereby granted, provided that the above
 * copyright notice and this permission notice appear in all copies.
 *
 * THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH
 * REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY
 * AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT,
 * INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM
 * LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR
 * OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
 * PERFORMANCE OF THIS SOFTWARE.
 */
 
#ifndef __SAF_HRIR_H_INCLUDED__
#define __SAF_HRIR_H_INCLUDED__
 
#ifdef __cplusplus
extern "C" {
#endif /* __cplusplus */
    
#include "../saf_utilities/saf_utility_complex.h"
    
/* ========================================================================== */
/*                               Default HRIRs                                */
/* ========================================================================== */
/* The default HRIR dataset is a Genelec Aural ID of a KEMAR Dummy Head (@48kHz)
 * Kindly provided by Aki Mäkivirta and Jaan Johansson */
 
extern const float __default_hrirs[836][2][256];
 
extern const float __default_hrir_dirs_deg[836][2];
 
extern const int __default_N_hrir_dirs;
 
extern const int __default_hrir_len;
 
extern const int __default_hrir_fs;
 
 
/* ========================================================================== */
/*                               Main Functions                               */
/* ========================================================================== */
 
void estimateITDs(/* Input Arguments */
                  float* hrirs,
                  int N_dirs,
                  int hrir_len,
                  int fs,
                  /* Output Arguments */
                  float* itds_s);
 
void HRIRs2HRTFs_afSTFT(/* Input Arguments */
                        float* hrirs,
                        int N_dirs,
                        int hrir_len,
                        int hopsize,
                        int LDmode,
                        int hybridmode,
                        /* Output Arguments */
                        float_complex* hrtf_fb);
 
void HRIRs2HRTFs_qmf(/* Input Arguments */
                     float* hrirs,
                     int N_dirs,
                     int hrir_len,
                     int hopsize,
                     int hybridmode,
                     /* Output Arguments */
                     float_complex* hrtf_fb);
 
void HRIRs2HRTFs(/* Input Arguments */
                 float* hrirs,
                 int N_dirs,
                 int hrir_len,
                 int fftSize,
                 /* Output Arguments */
                 float_complex* hrtfs);
 
void diffuseFieldEqualiseHRTFs(/* Input Arguments */
                               int N_dirs,
                               float* itds_s,
                               float* centreFreq,
                               int N_bands,
                               float* weights,
                               int applyEQ,
                               int applyPhase,
                               /* Input/Output Arguments */
                               float_complex* hrtfs);
 
void interpHRTFs(/* Input Arguments */
                 float_complex* hrtfs,
                 float* itds,
                 float* freqVector,
                 float* interp_table,
                 int N_hrtf_dirs,
                 int N_bands,
                 int N_interp_dirs,
                 /* Output Arguments */
                 float_complex* hrtf_interp);
 
void binauralDiffuseCoherence(/* Input Arguments */
                              float_complex* hrtfs,
                              float* itds,
                              float* freqVector,
                              int N_hrtf_dirs,
                              int N_bands,
                              /* Output Arguments */
                              float* HRTFcoh);
 
void resampleHRIRs(/* Input Arguments */
                   float* hrirs_in,
                   int hrirs_N_dirs,
                   int hrirs_in_len,
                   int hrirs_in_fs,
                   int hrirs_out_fs,
                   int padToNextPow2,
                   /* Output Arguments */
                   float** hrirs_out,
                   int* hrirs_out_len);
 
 
#ifdef __cplusplus
} /* extern "C" */
#endif  /* __cplusplus */
 
#endif /* __SAF_HRIR_H_INCLUDED__ */
 
 /* doxygen addtogroup HRIR */