binauraliser.h

Convolves input audio (up to 64 channels) with interpolated HRTFs in the time-frequency domain.

Convolves input audio (up to 64 channels) with interpolated HRTFs in the time-frequency domain.

Files

binauraliser.h (include), binauraliser_internal.h, binauraliser.c, binauraliser_internal.c

Include Header

/*
 * Copyright 2017-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 __BINAURALISER_H_INCLUDED__
#define __BINAURALISER_H_INCLUDED__
 
#include "_common.h"
 
#ifdef __cplusplus
extern "C" {
#endif /* __cplusplus */
 
/* ========================================================================== */
/*                             Presets + Constants                            */
/* ========================================================================== */
 
typedef enum {
    INTERP_TRI = 1, 
    INTERP_TRI_PS   
}INTERP_MODES;
 
 
/* ========================================================================== */
/*                               Main Functions                               */
/* ========================================================================== */
 
void binauraliser_create(void** const phBin);
 
void binauraliser_destroy(void** const phBin);
 
void binauraliser_init(void* const hBin,
                       int samplerate);
 
void binauraliser_initCodec(void* const hBin);
 
void binauraliser_process(void* const hBin,
                          const float *const * inputs,
                          float* const* outputs,
                          int nInputs,
                          int nOutputs,
                          int nSamples);
 
 
/* ========================================================================== */
/*                                Set Functions                               */
/* ========================================================================== */
 
void binauraliser_refreshSettings(void* const hBin);
    
void binauraliser_setSourceAzi_deg(void* const hBin,
                                   int index,
                                   float newAzi_deg);
 
void binauraliser_setSourceElev_deg(void* const hBin,
                                    int index,
                                    float newElev_deg);
 
void binauraliser_setNumSources(void* const hBin, int new_nSources);
 
void binauraliser_setUseDefaultHRIRsflag(void* const hBin, int newState);
 
void binauraliser_setSofaFilePath(void* const hBin, const char* path);
 
void binauraliser_setEnableHRIRsDiffuseEQ(void* const hBin, int newState);
 
void binauraliser_setInputConfigPreset(void* const hBin, int newPresetID);
 
void binauraliser_setEnableRotation(void* const hBin, int newState);
 
void binauraliser_setYaw(void* const hBin, float newYaw);
 
void binauraliser_setPitch(void* const hBin, float newPitch);
 
void binauraliser_setRoll(void* const hBin, float newRoll);
 
void binauraliser_setFlipYaw(void* const hBin, int newState);
 
void binauraliser_setFlipPitch(void* const hBin, int newState);
 
void binauraliser_setFlipRoll(void* const hBin, int newState);
 
void binauraliser_setRPYflag(void* const hBin, int newState);
 
void binauraliser_setInterpMode(void* const hBin, int newMode);
 
void binauraliser_setSourceGain(void* const hBin, int srcIdx, float newGain);
 
void binauraliser_setSourceSolo(void* const hBin, int srcIdx);
 
void binauraliser_setUnSolo(void* const hBin);
 
 
/* ========================================================================== */
/*                                Get Functions                               */
/* ========================================================================== */
 
int binauraliser_getFrameSize(void);
 
CODEC_STATUS binauraliser_getCodecStatus(void* const hBin);
 
float binauraliser_getProgressBar0_1(void* const hBin);
 
void binauraliser_getProgressBarText(void* const hBin, char* text);
 
float binauraliser_getSourceAzi_deg(void* const hBin, int index);
 
float binauraliser_getSourceElev_deg(void* const hBin, int index);
 
int binauraliser_getNumSources(void* const hBin);
 
int binauraliser_getMaxNumSources(void);
 
int binauraliser_getNumEars(void);
 
int binauraliser_getNDirs(void* const hBin);
 
int binauraliser_getNTriangles(void* const hBin);
 
float binauraliser_getHRIRAzi_deg(void* const hBin, int index);
 
float binauraliser_getHRIRElev_deg(void* const hBin, int index);
 
int binauraliser_getHRIRlength(void* const hBin);
 
int binauraliser_getHRIRsamplerate(void* const hBin);
 
int binauraliser_getUseDefaultHRIRsflag(void* const hBin);
 
char* binauraliser_getSofaFilePath(void* const hBin);
 
int binauraliser_getEnableHRIRsDiffuseEQ(void* const hBin);
 
int binauraliser_getDAWsamplerate(void* const hBin);
 
int binauraliser_getEnableRotation(void* const hBin);
 
float binauraliser_getYaw(void* const hBin);
 
float binauraliser_getPitch(void* const hBin);
 
float binauraliser_getRoll(void* const hBin);
 
int binauraliser_getFlipYaw(void* const hBin);
 
int binauraliser_getFlipPitch(void* const hBin);
 
int binauraliser_getFlipRoll(void* const hBin);
 
int binauraliser_getRPYflag(void* const hBin);
 
int binauraliser_getInterpMode(void* const hBin);
 
int binauraliser_getProcessingDelay(void);
 
 
#ifdef __cplusplus
} /* extern "C" { */
#endif /* __cplusplus */
 
#endif /* __BINAURALISER_H_INCLUDED__ */