diff mbox

[FFmpeg-devel] doc/ffmpeg: add documentation for the disposition option

Message ID 20161111002712.25263-1-ffmpeg-dev@c-14.de
State Accepted
Commit cd5da01daab7813f8215b1215cfe4cfcdc7a1ab4
Headers show

Commit Message

Simon Thelen Nov. 11, 2016, 12:27 a.m. UTC
Signed-off-by: Simon Thelen <ffmpeg-dev@c-14.de>
---
 doc/ffmpeg.texi | 34 ++++++++++++++++++++++++++++++++++
 1 file changed, 34 insertions(+)

Comments

Michael Niedermayer Nov. 14, 2016, 12:23 a.m. UTC | #1
On Fri, Nov 11, 2016 at 01:27:12AM +0100, Simon Thelen wrote:
> Signed-off-by: Simon Thelen <ffmpeg-dev@c-14.de>
> ---
>  doc/ffmpeg.texi | 34 ++++++++++++++++++++++++++++++++++
>  1 file changed, 34 insertions(+)

applied

thx


[...]
diff mbox

Patch

diff --git a/doc/ffmpeg.texi b/doc/ffmpeg.texi
index fd8a0c1..4b159fd 100644
--- a/doc/ffmpeg.texi
+++ b/doc/ffmpeg.texi
@@ -357,6 +357,40 @@  To set the language of the first audio stream:
 ffmpeg -i INPUT -metadata:s:a:0 language=eng OUTPUT
 @end example
 
+@item -disposition[:stream_specifier] @var{value} (@emph{output,per-stream})
+Sets the disposition for a stream.
+
+This option overrides the disposition copied from the input stream. It is also
+possible to delete the disposition by setting it to 0.
+
+The following dispositions are recognized:
+@table @option
+@item default
+@item dub
+@item original
+@item comment
+@item lyrics
+@item karaoke
+@item forced
+@item hearing_impaired
+@item visual_impaired
+@item clean_effects
+@item captions
+@item descriptions
+@item metadata
+@end table
+
+For example, to make the second audio stream the default stream:
+@example
+ffmpeg -i in.mkv -disposition:a:1 default out.mkv
+@end example
+
+To make the second subtitle stream the default stream and remove the default
+disposition from the first subtitle stream:
+@example
+ffmpeg -i INPUT -disposition:s:0 0 -disposition:s:1 default OUTPUT
+@end example
+
 @item -program [title=@var{title}:][program_num=@var{program_num}:]st=@var{stream}[:st=@var{stream}...] (@emph{output})
 
 Creates a program with the specified @var{title}, @var{program_num} and adds the specified