lavc: add a bitstream filter for extracting extradata from packets
[ffmpeg.git] / doc / bitstream_filters.texi
index 6e7f878..7ddf52e 100644 (file)
@@ -21,6 +21,24 @@ Below is a description of the currently available bitstream filters.
 
 @section dump_extradata
 
+@section extract_extradata
+
+Extract the in-band extradata.
+
+Certain codecs allow the long-term headers (e.g. MPEG-2 sequence headers,
+or H.264/HEVC (VPS/)SPS/PPS) to be transmitted either "in-band" (i.e. as a part
+of the bitstream containing the coded frames) or "out of band" (e.g. on the
+container level). This latter form is called "extradata" in Libav terminology.
+
+This bitstream filter detects the in-band headers and makes them available as
+extradata.
+
+@table @option
+@item remove
+When this option is enabled, the long-term headers are removed from the
+bitstream after extraction.
+@end table
+
 @section h264_mp4toannexb
 
 @section imx_dump_header