ffmpeg/doc
Philip Langdale 22b25b3ea5 avcodec: Add explicit capability flag for encoder flushing
Previously, there was no way to flush an encoder such that after
draining, the encoder could be used again. We generally suggested
that clients teardown and replace the encoder instance in these
situations. However, for at least some hardware encoders, the cost of
this tear down/replace cycle is very high, which can get in the way of
some use-cases - for example: segmented encoding with nvenc.

To help address that use case, we added support for calling
avcodec_flush_buffers() to nvenc and things worked in practice,
although it was not clearly documented as to whether this should work
or not. There was only one previous example of an encoder implementing
the flush callback (audiotoolboxenc) and it's unclear if that was
intentional or not. However, it was clear that calling
avocdec_flush_buffers() on any other encoder would leave the encoder in
an undefined state, and that's not great.

As part of cleaning this up, this change introduces a formal capability
flag for encoders that support flushing and ensures a flush call is a
no-op for any other encoder. This allows client code to check if it is
meaningful to call flush on an encoder before actually doing it.

I have not attempted to separate the steps taken inside
avcodec_flush_buffers() because it's not doing anything that's wrong
for an encoder. But I did add a sanity check to reject attempts to
flush a frame threaded encoder because I couldn't wrap my head around
whether that code path was actually safe or not. As this combination
doesn't exist today, we'll deal with it if it ever comes up.
2020-04-15 14:54:42 -07:00
..
doxy
examples examples/avio_dir_cmd: drop support for move/delete operations 2020-03-16 09:23:37 +01:00
.gitignore
APIchanges avcodec: Add explicit capability flag for encoder flushing 2020-04-15 14:54:42 -07:00
Doxyfile
Makefile
authors.texi
bitstream_filters.texi doc/bitstream_filters: Fix copy an paste typo 2019-11-05 21:21:32 +01:00
bootstrap.min.css
build_system.txt tools: add a fuzzer tool for bitstream filters 2019-12-05 20:49:15 -03:00
codecs.texi avcodec: add an AVCodecContext flag to export PRFT side data on demand 2020-02-22 23:19:07 -03:00
decoders.texi avcodec/libzvbi-teletextdec: add option to set default G0 character set 2020-02-24 00:14:21 +01:00
default.css
demuxers.texi doc/demuxers: update mov section 2020-03-06 11:05:30 +05:30
developer.texi doc/developer.texi: Add variadic macros to allowed C language features 2020-03-26 19:29:54 +01:00
devices.texi
doxy-wrapper.sh
encoders.texi avcodec/libaomenc.c: Add a libaom command-line option 'tune' 2020-04-11 15:12:34 -07:00
errno.txt
faq.texi
fate.texi
fate_config.sh.template
ffmpeg-bitstream-filters.texi
ffmpeg-codecs.texi
ffmpeg-devices.texi
ffmpeg-filters.texi
ffmpeg-formats.texi
ffmpeg-protocols.texi
ffmpeg-resampler.texi
ffmpeg-scaler.texi
ffmpeg-utils.texi
ffmpeg.texi doc/ffmpeg: Document device selection for Vulkan 2020-02-09 20:36:45 +00:00
ffmpeg.txt
ffplay.texi ffplay: always show stats at all log levels if requested by user 2020-04-04 15:17:24 +05:30
ffprobe.texi
ffprobe.xsd
fftools-common-opts.texi avutil/log: drop support for NO_COLOR environment variable 2020-02-09 20:31:44 +01:00
filter_design.txt
filters.texi doc/filters: clarify metadata and logging for blackdetect 2020-04-13 11:23:24 +05:30
formats.texi avformat: Add max_probe_packets option 2019-11-03 11:52:32 +01:00
general.texi doc/general: update avisynth docs with a way to install just the headers using CMake 2020-04-05 11:51:08 +02:00
git-howto.texi
indevs.texi avdevice/decklink: deprecate the -list_devices option 2020-01-03 18:13:22 +01:00
issue_tracker.txt
lexicon
libav-merge.txt
libavcodec.texi
libavdevice.texi
libavfilter.texi
libavformat.texi
libavutil.texi
libswresample.texi
libswscale.texi
mailing-list-faq.texi
metadata.texi
mips.txt
multithreading.txt pthread_frame: merge the functionality for normal decoder init and init_thread_copy 2020-04-10 15:24:54 +02:00
muxers.texi avformat/hlsenc: add hls_fmp4_init_resend option 2020-04-15 12:45:16 +08:00
nut.texi
optimization.txt
outdevs.texi doc/outdevs: Mention "sdl2" alias for "sdl". 2020-01-26 13:15:07 +01:00
patchwork
platform.texi
print_options.c
protocols.texi avformat/libzmq: Make default pkt_size value consistent with amqp 2020-03-09 22:07:18 +01:00
rate_distortion.txt
resampler.texi
scaler.texi
snow.txt
style.min.css
swresample.txt
swscale.txt
t2h.init
t2h.pm
tablegen.txt
texi2pod.pl
texidep.pl
undefined.txt
utils.texi doc/utils: add hexadecagonal channel layout 2019-10-19 13:00:36 +05:30
writing_filters.txt