Mercurial > cgi-bin > hgwebdir.cgi > PR > Applications > VSs > VSs__H264__App

comparison README.txt @ 2:897f711a7157

find changesets by author, revision, files, or words in the commit message
rearrange to work with autoconf
author Nina Engelhardt <nengel@mailbox.tu-berlin.de>
date Tue, 25 Sep 2012 15:55:33 +0200
parents
children
comparison
equal deleted inserted replaced
-1:000000000000 0:ff373de7be0b
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