]> git.sesse.net Git - ffmpeg/blobdiff - doc/multithreading.txt
pixdesc: Fix AVCOL_TRC_BT2020_12 name
[ffmpeg] / doc / multithreading.txt
index a1068425cd84cbfe01fa96dbf7c8cd61cc360f09..9b27b108c6163b5d864033d4a4d6d76012913dc5 100644 (file)
@@ -1,7 +1,7 @@
-FFmpeg multithreading methods
+Libav multithreading methods
 ==============================================
 
-FFmpeg provides two methods for multithreading codecs.
+Libav provides two methods for multithreading codecs.
 
 Slice threading decodes multiple parts of a frame at the same time, using
 AVCodecContext execute() and execute2().
@@ -57,6 +57,11 @@ which re-allocates them for other threads.
 Add CODEC_CAP_FRAME_THREADS to the codec capabilities. There will be very little
 speed gain at this point but it should work.
 
+If there are inter-frame dependencies, so the codec calls
+ff_thread_report/await_progress(), set AVCodecInternal.allocate_progress. The
+frames must then be freed with ff_thread_release_buffer().
+Otherwise leave it at zero and decode directly into the user-supplied frames.
+
 Call ff_thread_report_progress() after some part of the current picture has decoded.
 A good place to put this is where draw_horiz_band() is called - add this if it isn't
 called anywhere, as it's useful too and the implementation is trivial when you're