Skip to content

Draft: Add support for IVAS rtpdump reading and writing

Lauros Pajunen requested to merge 1154-add-rtpdump-support into main
  • Related issues: #1154
  • Requested reviewers:

Reason why this change is needed

In the RTP payload task force the desire for support of RTP in the form of rtpdump creation/parsing would be added to IVAS - for various reasons. The EVS codec part already supports rtpdump (which is a slimmed down variant of PCAP), but this was never brought to the IVAS part. Also packetization would be desirable (but was not part of EVS).

Usage

Encoder:

  • Use -rtpdump for the encoder to output an rtpdump stream, which is written to the output bitstream file. The rtpdump stream contains single IVAS frames packetized into IVAS RTP payload format packets. In EVS mono operating mode, the frames are packetized into IVAS payload format packets, which are interoperable with the EVS Header-Full RTP payload format.
  • -scene_orientation <file> can be used to input a scene orientation file to the encoder. The scene orientation values will be written to the PI data section of the IVAS payload. The file reading assumes one quaternion orientation value per line (same as for head orientation file reading).
  • -device_orientation <file>, same as above but for device orientations (uncompensated).
  • -disable_headtracking_file <file> can be used to input disable/enable headtracking file to the encoder. Whenever there is a change in the headtracking state (e.g., from enabling of headtracking to disabling), the appropriate PI data will be written to the IVAS payload. The file reading assumes one value per line, where (1) indicates disabling of headtracking and (0) indicates enabling of headtracking.

Decoder:

  • Use -VOIP_hf_only=1 to read the input rtpdump stream. This option should be able to read both IVAS payload format and EVS Header Full payload format.

Example:

IVAS_cod -rtpdump -SCENE_ORIENTATION ./scripts/testv/headrot_case00_3000_q.csv -masa 2 ./scripts/testv/stv1MASA2TC48c.met 128000 48 ./scripts/testv/stv1MASA2TC48c.wav ivas_rtpdump_test.bts
IVAS_dec -VOIP_hf_only=1 BINAURAL 48 ivas_rtpdump_test.bts ivas_rtpdump_out.wav

Affected operating points

Edited by vaclav

Merge request reports