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:

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
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.

seeliu/openHEVC