doc/muxers: Document use case of mpegts muxer option tables_version
authorAndrey Utkin <andrey.krieger.utkin@gmail.com>
Sun, 4 Aug 2013 09:25:57 +0000 (12:25 +0300)
committerMichael Niedermayer <michaelni@gmx.at>
Sun, 4 Aug 2013 11:35:54 +0000 (13:35 +0200)
Signed-off-by: Michael Niedermayer <michaelni@gmx.at>
doc/muxers.texi

index a3a1878..d204188 100644 (file)
@@ -535,6 +535,18 @@ Preserve original timestamps, if value is set to 1. Default value is -1, which
 results in shifting timestamps so that they start from 0.
 @item -tables_version @var{number}
 Set PAT, PMT and SDT version (default 0, valid values are from 0 to 31, inclusively).
+This option allows updating stream structure so that standard consumer may
+detect the change. To do so, reopen output AVFormatContext (in case of API
+usage) or restart ffmpeg instance, cyclically changing tables_version value:
+@example
+ffmpeg -i source1.ts -codec copy -f mpegts -tables_version 0 udp://1.1.1.1:1111
+ffmpeg -i source2.ts -codec copy -f mpegts -tables_version 1 udp://1.1.1.1:1111
+...
+ffmpeg -i source3.ts -codec copy -f mpegts -tables_version 31 udp://1.1.1.1:1111
+ffmpeg -i source1.ts -codec copy -f mpegts -tables_version 0 udp://1.1.1.1:1111
+ffmpeg -i source2.ts -codec copy -f mpegts -tables_version 1 udp://1.1.1.1:1111
+...
+@end example
 @end table
 
 Option mpegts_flags may take a set of such flags: