saf_hoa_internal.h

Go to the documentation of this file.

/*
 * Copyright 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_HOA_INTERNAL_H_INCLUDED__
#define __SAF_HOA_INTERNAL_H_INCLUDED__
 
#include "saf_hoa.h"
#include "../saf_sh/saf_sh.h"       /* for computing the legendre polynamials */
#include "../saf_vbap/saf_vbap.h"        /* for VBAP gains utilised by AllRAD */
#include "../saf_utilities/saf_utilities.h"   /* for linear algebra speed-ups */
#include "saf_externals.h" 
 
#ifdef __cplusplus
extern "C" {
#endif /* __cplusplus */
 
/* ========================================================================== */
/*                       Loudspeaker Ambisonic Decoders                       */
/* ========================================================================== */
 
void getEPAD(/* Input Arguments */
             int order,
             float* ls_dirs_deg,
             int nLS,
             /* Output Arguments */
             float* decMtx);
 
void getAllRAD(/* Input Arguments */
               int order,
               float* ls_dirs_deg,
               int nLS,
               /* Output Arguments */
               float* decMtx);
 
 
/* ========================================================================== */
/*                         Binaural Ambisonic Decoders                        */
/* ========================================================================== */
 
void getBinDecoder_LS(/* Input Arguments */
                      float_complex* hrtfs,
                      float* hrtf_dirs_deg,
                      int N_dirs,
                      int N_bands,
                      int order,
                      float* weights,
                      /* Output Arguments */
                      float_complex* decMtx);
 
void getBinDecoder_LSDIFFEQ(/* Input Arguments */
                            float_complex* hrtfs,
                            float* hrtf_dirs_deg,
                            int N_dirs,
                            int N_bands,
                            int order,
                            float* weights,
                            /* Output Arguments */
                            float_complex* decMtx);
 
void getBinDecoder_SPR(/* Input Arguments */
                       float_complex* hrtfs,
                       float* hrtf_dirs_deg,
                       int N_dirs,
                       int N_bands,
                       int order,
                       float* weights,
                       /* Output Arguments */
                       float_complex* decMtx);
 
void getBinDecoder_TA(/* Input Arguments */
                      float_complex* hrtfs,
                      float* hrtf_dirs_deg,
                      int N_dirs,
                      int N_bands,
                      int order,
                      float* freqVector,
                      float* itd_s,
                      float* weights,
                      /* Output Arguments */
                      float_complex* decMtx);
 
void getBinDecoder_MAGLS(/* Input Arguments */
                         float_complex* hrtfs,
                         float* hrtf_dirs_deg,
                         int N_dirs,
                         int N_bands,
                         int order,
                         float* freqVector,
                         float* weights,
                         /* Output Arguments */
                         float_complex* decMtx);
 
 
#ifdef __cplusplus
} /* extern "C" */
#endif /* __cplusplus */
 
#endif /* __SAF_HOA_INTERNAL_H_INCLUDED__ */