add description for orientation and config features

stvOMASA_4ISM_2MASA1TC48c.wav - 5 channels (4 discrete audio object and 2 MASA 1 transport channel), 48000 Hz

stvOMASA_4ISM_2MASA2TC48c.wav - 6 channels (4 discrete audio object and 2 MASA 2 transport channels), 48000 Hz

MASA metadata file

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

For the MASA operation modes, in addition the following metadata files

located in /scripts/testv/ folder are required:

stv2MASA1TC48c.met

stv2MASA2TC48c.met

The detailed syntax of MASA metadata files can be found in 3GPP TS 26.258.

It is strongly recommended to align these files to the corresponding

PCM audio files. The MASA metadata files can be generated with the

latest version of the IVAS MASA C Reference Software, which was made

available at

https://www.3gpp.org/ftp/TSG_SA/WG4_CODEC/TSGS4_118-e/Docs/S4-220443.zip

Object based audio metadata file

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

For the ISM operation modes, in addition the following metadata files

located at /scripts/testv/ folder are required:

The metadata reader accepts 1-8 values specified per line. If a value is not specified, the default

value is assumed.

HRTF filter file

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

For the HRTF filter File option, external HRTF filter Files are available in folder

/scripts/binauralRenderer_interface/binaural_renderers_hrtf_data:

ivas_binaural_32kHz.bin

ivas_binaural_48kHz.bin

The HRTF filter file has a specific container format with a header and a sequence of entries. The 

detailed syntax can be found in 3GPP TS 26.258.

Head rotation trajectory file

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

[TBD]

For the Head rotation operation modes, external trajectory files are available:

headrot_case02_3000_q.csv 

headrot_case03_3000_q.csv

Reference rotation/vector file

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

The external reference orientation of the orientation tracking feature can either be provided as a 

rotation (Quaternion or Euler angles) or as a pair of 3-dimensional positions (listener position 

and acoustic reference position). 

The Reference Rotation format is identical to Head rotation trajectory file.

The Reference Vector file format describes a pair of x/y/z positions, one for the listener and one 

for the acoustic reference. The acoustic reference direction is defined by the vector from the 

listener towards the acoustic reference position. The reference vector file is a CSV file with 

comma as separator. Each line must contain a listener and an acoustic reference position in the 

following order:

    x axis position of the listener. 

    y axis position of the listener. 

    z axis position of the listener. 

    x axis position of the acoustic reference. 

    y axis position of the acoustic reference. 

    z axis position of the acoustic reference. 

For Reference vector specified by external trajectory file, example files are available in folder 

/scripts/trajectories.

External orientation file

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

[TBD]

Renderer config file

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

The renderer configuration file provides metadata for controlling the rendering process. This metadata 

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.

For the Renderer configuration option operation modes, external configuration files are available, e.g.:

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

rend_rend_config_hospital_patientroom.cfg

rend_config_recreation.cfg