michalliu / openhevc

HEVC decoder

openHEVC

openHEVC is a fork of Libav with only the files needed to decode HEVC content, it was created for research purposes. Most people will not need to use this and should use the libav HEVC decoder available at https://github.com/OpenHEVC/ffmpeg instead (see https://ffmpeg.org/documentation.html for documentation).

openHEVC in combination with GPAC is used in 3 research projects:

• [4KREPROSYS] (http://4kreprosys.com)
• [4EVER] (http://www.4ever-project.com)
• [H2B2VS] (http://h2b2vs.epfl.ch)
• AUSTRAL

What does openHEVC support?

• Main Profile (all conformance bitstreams except BUMPING)
• Main 10 Profile (except different combination of luma/chroma bitwidth)
• Range extension (4:2:2/4:4:4)
  • Bitstream aligned with April 2014 HEVC standard
• support of SHM4.1 bitstreams

What is the compiling infrastructure?

• MSVC2013
• gcc
• clang

Where is the source code of openHEVC?

• openHEVC is located at https://github.com/OpenHEVC/openHEVC.
• openHEVC is under LGPL2.1 license
• reusing ffmpeg runtime for multithreading

Where is the source code of GPAC?

• gpac is located at http://gpac.wp.mines-telecom.fr.
• gpac is under LGPL license

How to compile openHEVC on linux from source code

• execute these commands

git clone git://github.com/OpenHEVC/openHEVC.git
cd openHEVC
git checkout hevc_rext

• install yasm
• go into OpenHEVC source folder
• execute these commands

mkdir build
cd build
cmake -DCMAKE_BUILD_TYPE=RELEASE ..
make
sudo make install

How to test openHEVC on linux from source code

• Prerequisites: SDL or SDL2
• go into source folder of openHEVC
• with SDL: cd build; ./hevc -i name_of_annexB_bitstream.(bit,bin,265)
• with SDL2: cd build; ./hevc_sdl2 -i name_of_annexB_bitstream.(bit,bin,265)
  • add -n to remove the display
  • add -l layer with layer a number to select the layer in a SHVC bitstream
  • add -f xx with xx to select frame-based (0), wpp/tiles (1) or combination of frame-based and wpp (4)
  • add -p to select the number of threads when -f is activated

How to compile gpac with openHEVC on linux

• Prerequisites (see http://gpac.wp.mines-telecom.fr/2011/04/20/compiling-gpac-on-ubuntu/)
• svn checkout https://gpac.svn.sourceforge.net/svnroot/gpac/trunk
• go into gpac source folder
• execute these commands

./configure 
make
sudo make install

How to embed HEVC into MP4 file format

• use i_main, lp_main, ld_main or ra_main bitstreams from http://ftp.kw.bbc.co.uk/hevc/hm-10.0-anchors/bitstreams/
• MP4Box -add name_of_annexB_bitstream.(bit,bin,265) -fps 50 -new output.mp4
  • where fps specifies the framerate (in the case of BQMall_832x480_60_qp22.bin the framerate is 60)
• MP4Client output.mp4 # to play HEVC mp4 content

How to embed HEVC into TS

• use i_main, lp_main, ld_main or ra_main bitstreams from http://ftp.kw.bbc.co.uk/hevc/hm-10.0-anchors/bitstreams/
• go into gpac source folder
• execute these commands:

cd bin/gcc
./mp42ts -prog=hevc.mp4 -dst-file=test.ts
MP4Client test.ts # to play HEVC transport streams

openHEVC contributors

• Active contributors

  • Guillaume Martres (alias smarter - google summer of code / EPFL) - student
  • Mickaël Raulet (IETR/INSA Rennes)
  • Gildas Cocherel (IETR/INSA Rennes)
  • Wassim Hamidouche (IETR/INSA Rennes)
  • Seppo Tomperi (VTT)
  • Pierre Edouard Lepere (IETR/INSA Rennes)
  • Fernando Pescador Del Oso (UPM)
  • Jesus Caño Velasco (UPM)

• Former contributors

  • Anand Meher Kotra (IETR/INSA Rennes)

• gpac contributors

---

• see http://gpac.wp.mines-telecom.fr/about/

Publications

• Conferences:

  • Hamidouche W., Raulet M., Déforges O, « Real time SHVC decoder: Implementation and complexity analysis », in ICIP 2014 – IEEE International Conference on Image Processing

  • Hamidouche W., Raulet M., Déforges O., « Parallel SHVC Decoder: Implementation and Analysis », in ICME 2014 – IEEE International Conference on Multimedia and Expo.

  • Hamidouche W., Cocherel G. , Le Feuvre J., Raulet M. and Déforges O. , « 4K Real-time video streaming with SHVC decoder and GPAC player », in ICME 2014 – IEEE International Conference on Multimedia and Expo.

  • Hamidouche W., Raulet M., Déforges O., « Multi-core software architecture for the scalable HEVC decoder », in ICASSP 2014 – IEEE International Conference on Acoustics, Speech, and Signal Processing.

  • J. Le Feuvre, J.-M. Thiesse, M. Parmentier, M. Raulet and Ch. Daguet, « Ultra high definition HEVC DASH data set », ACM MMSys, Singapore, March 2014, pp. 7-12.

  • M. Raulet, G. Cocherel, W. Hamidouche, J. Le Feuvre, J. Gorin, S. Kervadec and J. Viéron, « HEVC Live end to end demonstration », MMSP, Pula, Italia, October 2013.