ambi_bin.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 __AMBI_BIN_H_INCLUDED__
#define __AMBI_BIN_H_INCLUDED__
 
#include "_common.h"
 
#ifdef __cplusplus
extern "C" {
#endif /* __cplusplus */
 
/* ========================================================================== */
/*                             Presets + Constants                            */
/* ========================================================================== */
    
typedef enum {
    DECODING_METHOD_LS = 1,   
    DECODING_METHOD_LSDIFFEQ, 
    DECODING_METHOD_SPR,      
    DECODING_METHOD_TA,       
    DECODING_METHOD_MAGLS,    
}AMBI_BIN_DECODING_METHODS;
    
#define AMBI_BIN_NUM_DECODING_METHODS ( 5 )
 
typedef enum {
    HRIR_PREPROC_OFF = 1,     
    HRIR_PREPROC_EQ,          
    HRIR_PREPROC_PHASE,       
    HRIR_PREPROC_ALL,         
}AMBI_BIN_PREPROC;
 
#define AMBI_BIN_NUM_HRIR_PREPROC_OPTIONS ( 4 )
 
 
/* ========================================================================== */
/*                               Main Functions                               */
/* ========================================================================== */
 
void ambi_bin_create(void** const phAmbi);
 
void ambi_bin_destroy(void** const phAmbi);
 
void ambi_bin_init(void* const hAmbi,
                   int samplerate);
 
void ambi_bin_initCodec(void* const hAmbi);
 
void ambi_bin_process(void* const hAmbi,
                      const float *const * inputs,
                      float* const* const outputs,
                      int nInputs,
                      int nOutputs,
                      int nSamples);
 
 
/* ========================================================================== */
/*                                Set Functions                               */
/* ========================================================================== */
 
void ambi_bin_refreshParams(void* const hAmbi);
 
void ambi_bin_setUseDefaultHRIRsflag(void* const hAmbi, int newState);
 
void ambi_bin_setSofaFilePath(void* const hAmbi, const char* path);
 
void ambi_bin_setInputOrderPreset(void* const hAmbi,
                                  SH_ORDERS newPreset);
 
void ambi_bin_setDecodingMethod(void* const hAmbi,
                                AMBI_BIN_DECODING_METHODS newMethod);
 
void ambi_bin_setChOrder(void* const hAmbi, int newOrder);
 
void ambi_bin_setNormType(void* const hAmbi, int newType);
 
void ambi_bin_setEnableMaxRE(void* const hAmbi, int newState);
 
void ambi_bin_setEnableDiffuseMatching(void* const hAmbi, int newState);
 
void ambi_bin_setEnableTruncationEQ(void* const hAmbi, int newState);
 
void ambi_bin_setHRIRsPreProc(void* const hAmbi, AMBI_BIN_PREPROC newType);
 
void ambi_bin_setEnableRotation(void* const hAmbi, int newState);
 
void ambi_bin_setYaw(void* const hAmbi, float newYaw_deg);
 
void ambi_bin_setPitch(void* const hAmbi, float newPitch);
 
void ambi_bin_setRoll(void* const hAmbi, float newRoll);
 
void ambi_bin_setFlipYaw(void* const hAmbi, int newState);
 
void ambi_bin_setFlipPitch(void* const hAmbi, int newState);
 
void ambi_bin_setFlipRoll(void* const hAmbi, int newState);
 
void ambi_bin_setRPYflag(void* const hAmbi, int newState);
 
 
/* ========================================================================== */
/*                                Get Functions                               */
/* ========================================================================== */
 
int ambi_bin_getFrameSize(void);
 
CODEC_STATUS ambi_bin_getCodecStatus(void* const hAmbi);
    
float ambi_bin_getProgressBar0_1(void* const hAmbi);
    
void ambi_bin_getProgressBarText(void* const hAmbi, char* text);
    
int ambi_bin_getUseDefaultHRIRsflag(void* const hAmbi);
 
int ambi_bin_getInputOrderPreset(void* const hAmbi);
 
AMBI_BIN_DECODING_METHODS ambi_bin_getDecodingMethod(void* const hAmbi);
 
char* ambi_bin_getSofaFilePath(void* const hAmbi);
 
int ambi_bin_getChOrder(void* const hAmbi);
 
int ambi_bin_getNormType(void* const hAmbi); 
 
int ambi_bin_getNumEars(void);
 
int ambi_bin_getNSHrequired(void* const hAmbi);
 
int ambi_bin_getEnableMaxRE(void* const hAmbi);
 
int ambi_bin_getEnableDiffuseMatching(void* const hAmbi);
 
int ambi_bin_getEnableTruncationEQ(void* const hAmbi);
 
AMBI_BIN_PREPROC ambi_bin_getHRIRsPreProc(void* const hAmbi);
 
int ambi_bin_getEnableRotation(void* const hAmbi);
 
float ambi_bin_getYaw(void* const hAmbi);
 
float ambi_bin_getPitch(void* const hAmbi);
 
float ambi_bin_getRoll(void* const hAmbi);
 
int ambi_bin_getFlipYaw(void* const hAmbi);
 
int ambi_bin_getFlipPitch(void* const hAmbi);
 
int ambi_bin_getFlipRoll(void* const hAmbi);
 
int ambi_bin_getRPYflag(void* const hAmbi);
 
int ambi_bin_getNDirs(void* const hAmbi);
 
int ambi_bin_getHRIRlength(void* const hAmbi);
 
int ambi_bin_getHRIRsamplerate(void* const hAmbi);
 
int ambi_bin_getDAWsamplerate(void* const hAmbi);
 
int ambi_bin_getProcessingDelay(void);
 
    
#ifdef __cplusplus
} /* extern "C" { */
#endif /* __cplusplus */
 
#endif /* __AMBI_BIN_H_INCLUDED__ */