/*====================================================================================
    3GPP TS26.258 Nov 20, 2025. IVAS Codec Version IVAS-FL-3.0
  ====================================================================================*/

Table Format Converter program
------------------------------

The table format converter is used to generate the file containing the binary representation of the binaural 
filters for renderers (dynamic loading of generated file using –hrtf argument in IVAS decoder or renderer command).
This tool is able to aggregate the binary files generated for different IVAS renderers.

First, build the converter under scripts/binauralRenderer_interface/Table_Format_Converter/ in VSCode (using CMakeList) or command line:
   - mkdir build
   - cd build
   - cmake ..
   - cmake --build . (option --config=release)
   - cd ..

Usage: 
------
tables_format_converter [Options]

Mandatory parameters : 

Options :
-output_file_path : Path where output file will be created (default = './binaural_renderers_hrtf_data').
-output_file_name : Name of output file (without extension .bin or sample rate, default = 'ivas_binaural').
-16 : Select 16 kHz sampling frequency (no multiple values, all frequencies by default).
-32 : Select 32 kHz sampling frequency (no multiple values, all frequencies by default).
-48 : Select 48 kHz sampling frequency (no multiple values, all frequencies by default).
-input_td_file_path             : if exist path of binary files for time-domain renderer.
-input_td_file_name             : if exist common name of input td file with extension.
-input_reverb_file_path         : if exist path of binary files for reverb.
-input_reverb_file_name         : if exist name of input reverb file with extension.
-input_fastconv_file_path       : if exist path of binary file for fastconv renderer.
-input_fastconv_file_name       : if exist name of input fastconv file with extension.
-input_param_file_path          : if exist path of binary file for parametric renderer.
-input_param_file_name          : if exist name of input param file with extension.
-input_mixerconv_file_hrir_path : if exist path of binary files for mixer_conv hrir renderer.
-input_mixerconv_file_hrir_name : if exist common name of input mixer_conv hrir files.
-input_mixerconv_file_brir_path : if exist path of binary files for mixer_conv brir renderer.
-input_mixerconv_file_brir_name : if exist common name of input mixer_conv brir files.

For example :
   tables_format_converter(.exe) -output_file_path ../binaural_renderers_hrtf_data -output_file_name test -input_td_file_path ../binaural_renderers_hrtf_data/IVAS_default -input_td_file_name td_HRIR_128_Meth5_IRC_53_Q10_symL_Itrp1_48000_model_v003 -input_param_file_path ../binaural_renderers_hrtf_data -input_param_file_name parambin_HRIR_128_Meth5_IRC_53_Q10_symL_Itrp1_48000_IIS_BRIR_officialMPEG_Combined.bin

