- provide [TBD] information

The usage of the "IVAS_rend" program is as follows:

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

Usage: IVAS_rend [options]

Usage: IVAS_rend [Options]

Valid options:

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

Head rotation trajectory file

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

[TBD]

Input data representing the current rotation of the listeners head can be provided to the decoder 

in an ASCII formatted file comprising four columns separated by commas. These columns contain 

floating-point numbers representing either a quaternion or a Euler angle. The distinction between 

these two input formats is made by a magic number in the first column. If this value is set to -3.0, 

it is assumed that the remaining three columns contain three Euler angles. Otherwise, all four 

columns are interpreted as a Quaternion. The input is expected to have one line for each subframe of 5 ms. 

In the case of Quaternion-based input, the columns are the w, x, y, z components of a unit quaternion. 

Proper normalization to 1 mustshall be maintained in the input. The coordinate system is defined such that 

the x-axis points from the left to the right ear, the y axis points into the direction of view, and the 

z axis point from bottom to top. The origin is in the center of the head. 

In the case of Euler angle input, the first column contains the magic number -3.0, and the next three 

columns are the Euler angles yaw, pitch, and roll. The rotations are applied in the order yaw-pitch-roll. 

The yaw angle rotates around the z axis, the pitch angle rotates aroud the new y axis, and the roll angle 

rotates around the new x axis.

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

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

/scripts/trajectories.

External orientation file

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

The external orientation file provides orientation information for any non-listener dependent orientations. 

The orientations shall be given as floating point quaternions to the decoder/renderer in (w, x, y, z) order. 

Additional information may be given as HeadRotIndicator, ExtOriIndicator, ExtIntrpFlag and ExtIntrpNFrames. 

Each entry line represents a sub-frame entry, where the sub-frame resolution is 5ms. In the processing, the 

quaternions are inverted to act as a rotation instead of orientation. 

[TBD]

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

Renderer config file