Merge remote-tracking branch 'ffmpeg-mt/master'
[ffmpeg.git] / mt-work / todo.txt
1 Todo
2
3 -- For other people
4 - Multithread vc1.
5 - Multithread an intra codec like mjpeg (trivial).
6 - Fix mpeg1 (see below).
7 - Try the first three items under Optimization.
8 - Fix h264 (see below).
9 - Try mpeg4 (see below).
10
11 -- Bug fixes
12
13 General critical:
14 - Error resilience has to run before ff_report_frame_progress()
15 is called. Otherwise there will be race conditions. (This might already
16 work.) In general testing error paths should be done more.
17 - 'make fate THREADS=2' doesn't pass. Most failures are due to
18 bugs in vsync in ffmpeg.c, which are currently obscuring real failures.
19
20 h264:
21 - Files that aren't parsed (e.g. mp4) and contain PAFF with two
22 field pictures in the same packet are not optimal. Modify the
23 nals_needed check so that the second field's first slice is
24 considered as needed, then uncomment the FIXME code in decode_postinit.
25 Ex: http://astrange.ithinksw.net/ffmpeg/mt-samples/PAFF-Chalet-Tire.mp4
26 - The conformance sample MR3_TANDBERG_B.264 has problems (allocated picture overflow).
27 - One 10-bit sample has problems.
28
29 mpeg4:
30 - Packed B-frames need to be explicitly split up
31 when frame threading is on. It's not very fast
32 without this.
33 - The buffer age optimization is disabled due to
34 the way buffers are allocated across threads. The
35 branch 'fix_buffer_age' has an attempt to fix it
36 which breaks ffplay.
37 - Support interlaced.
38
39 mpeg1/2:
40 - Seeking always prints "first frame not a keyframe"
41 with threads on. Currently disabled for this reason.
42
43 -- Prove correct
44
45 - decode_update_progress() in h264.c
46 race_checking branch has some work on h264,
47 but not that function. It might be worth putting
48 the branch under #ifdef DEBUG in mainline, but
49 the code would have to be cleaner.
50 - MPV_lowest_referenced_row() and co in mpegvideo.c
51 - Same in vp3.
52
53 -- Optimization
54
55 - Merge h264 decode_update_progress() with loop_filter().
56 Add CODEC_CAP_DRAW_HORIZ_BAND as a side effect.
57 - EMU_EDGE is always set for h264 PAFF+MT
58 because draw_edges() writes into the other field's
59 thread's pixels. Needs an option to skip T/B fields.
60 - Check update_thread_context() functions and make
61 sure they only copy what they need to.
62 - Try some more optimization of the "ref < 48; ref++"
63 loop in h264.c await_references(), try turning the list0/list1 check
64 above into a loop without being slower.
65 - Support frame+slice threading at the same time
66 by assigning slice_count threads for frame threads
67 to use with execute(). This is simpler but unbalanced
68 if only one frame thread uses any.
69
70 -- Features
71
72 - Support streams with width/height changing. This
73 requires flushing all current frames (and buffering
74 the input in the meantime), closing the codec and
75 reopening it. Or don't support it.
76 - Support encoding. Might need more threading primitives
77 for good ratecontrol; would be nice for audio and libavfilter too.
78 - Async decoding part 1: instead of trying to
79 start every thread at the beginning, return a picture
80 if the earliest thread is already done, but don't wait
81 for it. Not sure what effect this would have.
82 - Part 2: have an API that doesn't wait for the decoding
83 thread, only returns EAGAIN if it's not ready. What will
84 it do with the next input packet if it returns that?
85 - Have an API that returns finished pictures but doesn't
86 require sending new ones. Maybe allow NULL avpkt when
87 not at the end of the stream.
88
89 -- Samples
90
91 http://astrange.ithinksw.net/ffmpeg/mt-samples/
92
93 See yuvcmp.c in this directory to compare decoded samples.
94
95 For debugging, try commenting out ff_thread_finish_setup calls so
96 that only one thread runs at once, and then binary search+
97 scatter printfs to look for differences in codec contexts.