Download Latest Version svc-demux-mux.zip (75.5 kB)
Email in envelope

Get an email when there's a new version of SVC Demux & Mux

Home
Name Modified Size InfoDownloads / Week
README.md 2013-09-20 3.9 kB
bitstream-reordering.jpg 2013-09-20 73.9 kB
svc-demux-mux.zip 2013-09-20 75.5 kB
svc_demux.py 2013-09-20 7.7 kB
svc_mux.py 2013-09-20 3.0 kB
Totals: 5 Items   164.0 kB 0

SVC Demux & Mux

Intro

Tools for Scalable Video Coding (SVC) bitstream reordering to support Dynamic Adaptive Streaming over HTTP (DASH).

  • Demultiplexer for SVC-DASH. Splits the SVC bitstream into chunks, one per layer. Also generates an MPD. This tool is deployed at the server.
  • Re-Multiplexer for SVC-DASH. Reorders SVC layer chunks into a single SVC bitstream. This tool is deployed at the client (after the DASH client, before the SVC decoder).

In SVC-based DASH, the SVC layers are provided in multiple representations. A normal SVC bitstream has enhancement layers located at each frame. For SVC-DASH each temporal segment is split into multiple chunks, one per layer. Each of the chunks contains several frames for one layer.

Bitstream Reordering

Segmentation of SVC bitstream for DASH. SVC layers in (a) original bitstream and (b) segmentation for DASH.

Both tools are implemented as Python scripts.

Application

Server Side

To split the SVC bitstream into its layers:

python svc_demux.py file.264

The output will be stored as "file.264.seg0-L0.264", "file.264.seg0-L1.264", "file.264.seg0-L2.264", etc.

The Media Presentation Description (MPD) will be stored as "file.264.mpd"

To generate segments of 2-seconds at 25 fps (i.e., 50 frames per segment):

python svc_demux.py file.264 50

The output will be stored as "file.264.seg0-L<x>.264", "file.264.seg1-L<x>.264", etc.

To adjust parameters such as resolution (e.g., 352x288), frame rate (e.g., 25 fps), and baseURL:

python svc_demux.py file.264 50 352 288 25 http://example.com/

Client Side

To re-multiplex the SVC layers into a single SVC bitstream with correct NALU ordering:

python svc_mux.py out_file.264   file.264.seg0-L0.264 file.264.seg0-L1.264 file.264.seg0-L2.264 out_file.264

Notes

  • Demultiplexer: SVC bitstreams must have constant IDR rate. MPD generation only supports quality scalability, i.e., spatial layers are currently not represented correctly in the MPD.
  • Re-Multiplexer: Does currently not work with input pipes because we cannot detect the actual end of the stream (in contrast to temporary silence).
  • The tools were tested with Python 2.7 and 3.2.3.

Credits

Author: Michael Grafl <michael(dot)grafl(at)itec(dot)aau(dot)at>, Alpen-Adria-Universität Klagenfurt

This work was supported in part by the EC in the context of the ALICANTE project (FP7-ICT-248652). http://www.ict-alicante.eu/

License

The MIT License

Copyright (c) 2013 Michael Grafl

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

Source: README.md, updated 2013-09-20