1 App: h264dec

2

3 This application decodes H.264 raw videos.

4

5 Build Sequential/Pthreads:

6

7 autoreconf -i -f

8 mkdir build

9 cd build

10 ../configure --enable-ssse3 --enable-sdl2

11 make

12

13 Build OmpSs:

14

15 autoreconf -i -f

16 mkdir build

17 cd build-ss

18 ../configure CC=sscc --enable-ssse3 --enable-sdl2

19 make

20

21 ssse3 enables assembler optimizations up to ssse3 (optional)

22 sdl enables a rudimentary viewing capability (optional)

23

24 Usage Sequential/Pthreads:

25 ./h264dec -i $(INPUT_VIDEO) -s

26 ./h264dec -i $(INPUT_VIDEO) -t $(THREADS)

27

28 Usage OmpSs:

29 NX_PES=<numthreads> ./h264dec -i <inputfile> -e <num parallel entropy frames> -z <width> <height> --static-3d

30

31 -e specify the number of entropy decode pipeline buffers and should be ideally

32 the same as the number of threads.

33

34 -z allows to set the MB reconstruction grouped block size. A size between 6 by 6 to 10 by 10

35 was found to strike a good balance between overhead and parallelism, but is machine and input

36 dependent.

37

38 --static-3d performs overlapping wavefront decoding.

39

40 General usage:

41 -d displays output

42 -f fullscreen

43 -o $(OUT_FILE) write raw YUV

44 -v show framerate

45

46

47 The INPUT_VIDEOs are in "inputs_encore", but should be able to decode any raw H.264 stream using

48 one slice per frame, non-interlaced, and CABAC, YUV420.

49

50

51 Integrated OmpSs player demo

52 ----------------------------

53 NOTE: for the player demo SDL2 must be installed.

54

55 1. Go to the OmpSs build directory (/home/cchi/Projects/ffmpeg_smp/build-ss)

56

57 2. Launch the H.264 decoder with the desired options:

58

59 NX_PES=<numthreads> ./h264dec <inputfile> -v (verbose) -e <num parallel entropy frames> -z <width> <height> -d (display) -f (fullscreen)

60

61 note that <num parallel entropy frames> should be equal or higher than <numthreads> for optimal performance

62

63 Examples:

64

65 NX_PES=7 ./h264dec -i ../../h264_movies/park_joy_2160px5.h264 -v -z 8 8 -df -e 9

66 NX_PES=7 ./h264dec -i ../../h264_movies/big_buck_bunny_1080p24.h264 -v -d -z 6 6 -e 9

67

68 Interacting with the program

69 ----------------------------

70 <CTRL+F> Fullscreen mode

71 <ESCAPE> Window mode

72 <SPACE> Pause/resume

73 <M> Show/hide macroblock borders

74 <arrows> When macroblock borders are shown resizes the macroblocks

75 <ALT+F4> Close

76

77 Force close in case of lockup

78 -----------------------------

79 On a terminal: killall -9 h264dec