[FFmpeg-cvslog] doc/bitstream_filters: document dump_extra

[Stefano Sabatini]

ffmpeg | branch: master | Stefano Sabatini <stefasab at gmail.com> | Tue Jul 16 15:34:02 2013 +0200| [34322ab27a5008ffc6081b945bd1bc602ea7495c] | committer: Stefano Sabatini

doc/bitstream_filters: document dump_extra

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

 doc/bitstream_filters.texi |   26 ++++++++++++++++++++++++++
 1 file changed, 26 insertions(+)

diff --git a/doc/bitstream_filters.texi b/doc/bitstream_filters.texi
index fe3c910..315fe33 100644
--- a/doc/bitstream_filters.texi
+++ b/doc/bitstream_filters.texi
@@ -32,6 +32,32 @@ Remove zero padding at the end of a packet.
 
 @section dump_extra
 
+Add extradata to the beginning of the filtered packets.
+
+The additional argument specifies which packets should be filtered.
+It accepts the values:
+ at table @samp
+ at item a
+add extradata to all key packets, but only if @var{local_header} is
+set in the @option{flags2} codec context field
+
+ at item k
+add extradata to all key packets
+
+ at item e
+add extradata to all packets
+ at end table
+
+If not specified it is assumed @samp{k}.
+
+For example the following @command{ffmpeg} command forces a global
+header (thus disabling individual packet headers) in the H.264 packets
+generated by the @code{libx264} encoder, but corrects them by adding
+the header stored in extradata to the key packets:
+ at example
+ffmpeg -i INPUT -map 0 -flags:v +global_header -c:v libx264 -bsf:v dump_extra out.ts
+ at end example
+
 @section h264_mp4toannexb
 
 Convert an H.264 bitstream from length prefixed mode to start code