[FFmpeg-cvslog] doc/ffmpeg: document reinit_filter

[Gyan Doshi]

ffmpeg | branch: master | Gyan Doshi <ffmpeg at gyani.pro> | Thu Jun 10 10:11:52 2021 +0530| [99bbf4a5be77edbde4106a459475cb7973d027c7] | committer: Gyan Doshi

doc/ffmpeg: document reinit_filter

> http://git.videolan.org/gitweb.cgi/ffmpeg.git/?a=commit;h=99bbf4a5be77edbde4106a459475cb7973d027c7
---

 doc/ffmpeg.texi | 10 ++++++++++
 1 file changed, 10 insertions(+)

diff --git a/doc/ffmpeg.texi b/doc/ffmpeg.texi
index 9feabe6517..7827291755 100644
--- a/doc/ffmpeg.texi
+++ b/doc/ffmpeg.texi
@@ -759,6 +759,16 @@ This option is similar to @option{-filter}, the only difference is that its
 argument is the name of the file from which a filtergraph description is to be
 read.
 
+ at item -reinit_filter[:@var{stream_specifier}] @var{integer} (@emph{input,per-stream})
+This boolean option determines if the filtergraph(s) to which this stream is fed gets
+reinitialized when input frame parameters change mid-stream. This option is enabled by
+default as most video and all audio filters cannot handle deviation in input frame properties.
+Upon reinitialization, existing filter state is lost, like e.g. the frame count @code{n}
+reference available in some filters. Any frames buffered at time of reinitialization are lost.
+The properties where a change triggers reinitialization are,
+for video, frame resolution or pixel format;
+for audio, sample format, sample rate, channel count or channel layout.
+
 @item -filter_threads @var{nb_threads} (@emph{global})
 Defines how many threads are used to process a filter pipeline. Each pipeline
 will produce a thread pool with this many threads available for parallel processing.