From d4863fc1a83ceab1d75469b406a2c67e5659b2a0 Mon Sep 17 00:00:00 2001 From: Anton Khirnov Date: Thu, 28 Jul 2011 16:47:38 +0200 Subject: cmdutils: allow precisely specifying a stream for AVOptions. --- doc/fftools-common-opts.texi | 17 +++++++++++++++++ 1 file changed, 17 insertions(+) (limited to 'doc') diff --git a/doc/fftools-common-opts.texi b/doc/fftools-common-opts.texi index ba91b87e72..8ffc3299ce 100644 --- a/doc/fftools-common-opts.texi +++ b/doc/fftools-common-opts.texi @@ -114,5 +114,22 @@ muxer: ffmpeg -i input.flac -id3v2_version 3 out.mp3 @end example +You can precisely specify which stream(s) should the codec AVOption apply to by +appending a stream specifier of the form +@option{[:@var{stream_type}][:@var{stream_index}]} to the option name. +@var{stream_type} is 'v' for video, 'a' for audio and 's' for subtitle streams. +@var{stream_index} is a global stream index when @var{stream_type} isn't +given, otherwise it counts streams of the given type only. As always, the index +is zero-based. For example +@example +-foo -- applies to all applicable streams +-foo:v -- applies to all video streams +-foo:a:2 -- applies to the third audio stream +-foo:0 -- applies to the first stream +@end example + Note -nooption syntax cannot be used for boolean AVOptions, use -option 0/-option 1. + +Note2 old undocumented way of specifying per-stream AVOptions by prepending +v/a/s to the options name is now obsolete and will be removed soon. -- cgit v1.2.3