- address comments

*******************************************************************************************************/

These files represent a codec candidate to the IVAS

Extension to the 3GPP EVS Codec floating-point C simulation. All code is

written in C. The system is implemented as three separate programs:

These files represent the 3GPP EVS Codec Extension for Immersive Voice and 

Audio Services (IVAS) floating-point C simulation. All code is writtten

in C. The system is implemented as three separate programs:

        IVAS_cod   Encoder

        IVAS_dec   Decoder

such as an HP (HP-UX) or a Sun, then binary files will need to be modified

by swapping the byte order in the files.

The input and output files (*.8k, *.16k, *.32k, *.48k) are 16-bit signed

binary files with 8/16/32/48 kHz sampling rate with no headers. Alternatively, 

The input and output files (*.8k, *.16k, *.32k, *.48k) are 16-bit integer 

PCM files with 8/16/32/48 kHz sampling rate with no headers. Alternatively, 

the input and output files are WAV files.

The Encoder produces bitstream files in either ITU G.192 or MIME file

    |-- lib_debug

    |-- lib_dec

    |-- lib_enc

	|-- lib_lc3plus

    |-- lib_rend

    |-- lib_util

    |-- readme.txt

Mandatory parameters:

---------------------

OutputConf           : Output configuration: MONO, STEREO, 5_1, 7_1, 5_1_2, 5_1_4, 7_1_4, FOA,

                       HOA2, HOA3, BINAURAL, BINAURAL_ROOM_IR, BINAURAL_ROOM_REVERB, 

                       BINAURAL_SPLIT_CODED, BINAURAL_SPLIT_PCM, EXT

                       HOA2, HOA3, BINAURAL, BINAURAL_ROOM_IR, BINAURAL_ROOM_REVERB, EXT

                       By default, channel order and loudspeaker positions are equal to the

                       encoder. For loudspeaker outputs, OutputConf can be a custom loudspeaker

                       layout file. See below for details.

-rvf File           : Reference vector specified by external trajectory File

                      works only in combination with '-otr ref_vec' and 'ref_vec_lev' modes

-render_config File : Renderer configuration option with parameters specified in File

-om File            : MD output File for BINAURAL_SPLIT_PCM output

-non_diegetic_pan P : panning mono non-diegetic sound to stereo -90<= P <=90,

                      left or l or 90->left, right or r or -90->right, center or c or  0->middle

-q                  : Quiet mode, limit printouts to terminal, default is deactivated

Valid options:

-i File             : Input audio File (WAV, raw PCM or scene description file)

-if Format          : Audio Format of input file (e.g. 5_1 or HOA3 or META, use -l for a list)

-im Files           : Metadata files for ISM (one file per object) or MASA inputs or BINAURAL_SPLIT_PCM input mode

-im Files           : Metadata files for ISM (one file per object) or MASA inputs

-o File             : Output audio File

-of Format          : Audio Format of output file

                      Alternatively, it can be a custom loudspeaker layout File

-fs                 : Input sampling rate in kHz (16, 32, 48) - required only with raw PCM inputs

-tf File            : Head rotation trajectory File for simulation of head tracking (only for binaural outputs)

-om File            : Coded metadata File for BINAURAL_SPLIT_PCM output mode

-prbfi File         : Split rendering option: bfi File

-rf File           	: Reference rotation trajectory File for simulation of head tracking (only for binaural outputs)

-rvf File           : Reference vector trajectory File for simulation of head tracking (only for binaural outputs)

-hrtf File          : Custom HRTF File for binaural rendering (only for binaural outputs)

includes acoustics environment parameters and source directivity. The data can be provided using 

binary bitstream or a text file. 

The renderer configuration text file can additionally be used to configure the pre-rendering step 

of the split binaural renderer. All split renderer parameters are optional.

The detailed syntax can be found in 3GPP TS 26.258.

Example renderer configuration files are available, e.g.: