Skip to content

readme.txt: Object Metadata Description

The description of the object metadata in the readme.txt is imho still not 100% correct or misleading. Currently, it states:

These are comma separated files (csv) which indicate the per object position
in the format:
frame azimuth, elevation, radius, spread, gain, yaw, pitch, non-diegetic

with the following meaning:
| Parameter    | format, value range | meaning
---------------------------------------------------------------------------------------------------
| azimuth      | float, [-180,180]   | azimuth; positive indicates left; default: 0
---------------------------------------------------------------------------------------------------
| elevation    | float, [-90,90]     | elevation; positive indicates up; default: 0
---------------------------------------------------------------------------------------------------
| radius       | float, [0, 15.75]   | radius (extended metadata); default: 1
---------------------------------------------------------------------------------------------------
| spread       | float, [0,360]      | spread in angles from 0...360 deg; default: 0
---------------------------------------------------------------------------------------------------
| gain         | float, [0,1]        | gain; default: 1
---------------------------------------------------------------------------------------------------
| yaw          | float, [-180,180]   | yaw (extended metadata); positive indicates left; default: 0
---------------------------------------------------------------------------------------------------
| pitch        | float, [-90,90]     | pitch (extended metadata); positive indicates up; default: 0
---------------------------------------------------------------------------------------------------
| non-diegetic | float*, [0 1]       | Flag for activation of non-diegetic rendering; default: 0
|                                    | if Flag is set to 1, panning gain is specified by azimuth.
|                                    | Value between [-90,90], 90 left, -90 right, 0 center
---------------------------------------------------------------------------------------------------
*Read as float value for convenience, but used as an integer flag internally.

Issues:

  • frame azimuth, elevation, radius, spread, gain, yaw, pitch, non-diegetic - why frame? I think this should be removed
  • range for azimuth, yaw: Why does it say [-180,180] and not [-180,180[?