diff options
author | Anton Khirnov <anton@khirnov.net> | 2011-08-08 14:29:37 +0200 |
---|---|---|
committer | Anton Khirnov <anton@khirnov.net> | 2011-08-16 06:17:02 +0200 |
commit | 92f1940e998bfb6bc9e1fad1aa8b9c51e5bfec8c (patch) | |
tree | f11832b519dcb1ee2070c18f4db1f0640d76a2fc /doc | |
parent | ff884c79ee16def93a3daa709f44ed65046e03df (diff) | |
download | ffmpeg-streaming-92f1940e998bfb6bc9e1fad1aa8b9c51e5bfec8c.zip ffmpeg-streaming-92f1940e998bfb6bc9e1fad1aa8b9c51e5bfec8c.tar.gz |
avconv: replace -vcodec/-acodec/-scodec with a better system.
The new option doesn't depend on its placement wrt -new* options (which
don't exist anymore) and works in a similar way as per-stream AVOptions.
-[vas]codec remain as aliases to -codec:[vas]
Diffstat (limited to 'doc')
-rw-r--r-- | doc/avconv.texi | 53 |
1 files changed, 38 insertions, 15 deletions
diff --git a/doc/avconv.texi b/doc/avconv.texi index a190cbe..56d244d 100644 --- a/doc/avconv.texi +++ b/doc/avconv.texi @@ -97,6 +97,34 @@ input file name @item -y Overwrite output files. +@item -c[:@var{stream_type}][:@var{stream_index}] @var{codec} +@item -codec[:@var{stream_type}][:@var{stream_index}] @var{codec} +Select an encoder (when used before an output file) or a decoder (when used +before an input file) for one or more streams. @var{codec} is the name of a +decoder/encoder or a special value @code{copy} (output only) to indicate that +the stream is not to be reencoded. + +@var{stream_type} may be 'v' for video, 'a' for audio, 's' for subtitle and 'd' +for data streams. @var{stream_index} is a global zero-based stream index if +@var{stream_type} isn't given, otherwise it counts only streams of the given +type. If @var{stream_index} is omitted, this option applies to all streams of +the given type or all streams of any type if @var{stream_type} is missing as +well (note that this only makes sense when all streams are of the same type or +@var{codec} is @code{copy}). + +For example +@example +avconv -i INPUT -map 0 -c:v libx264 -c:a copy OUTPUT +@end example +encodes all video streams with libx264 and copies all audio streams. + +For each stream, the last matching @code{c} option is applied, so +@example +avconv -i INPUT -map 0 -c copy -c:v:1 libx264 -c:a:137 libvorbis OUTPUT +@end example +will copy all the streams except the second video, which will be encoded with +libx264, and the 138th audio, which will be encoded with libvorbis. + @item -t @var{duration} Restrict the transcoded/captured video sequence to the duration specified in seconds. @@ -159,9 +187,6 @@ avconv -i myfile.avi -target vcd -bf 2 /tmp/vcd.mpg @item -dframes @var{number} Set the number of data frames to record. -@item -scodec @var{codec} -Force subtitle codec ('copy' to copy stream). - @item -slang @var{code} Set the ISO 639 language code (3 letters) of the current subtitle stream. @@ -282,8 +307,7 @@ It is of little use elsewise. @item -bufsize @var{size} Set video buffer verifier buffer size (in bits). @item -vcodec @var{codec} -Force video codec to @var{codec}. Use the @code{copy} special value to -tell that the raw codec data must be copied as is. +Set the video codec. This is an alias for @code{-codec:v}. @item -sameq Use same quantizer as source (implies VBR). @@ -296,8 +320,8 @@ at the exact requested bitrate. On pass 1, you may just deactivate audio and set output to null, examples for Windows and Unix: @example -avconv -i foo.mov -vcodec libxvid -pass 1 -an -f rawvideo -y NUL -avconv -i foo.mov -vcodec libxvid -pass 1 -an -f rawvideo -y /dev/null +avconv -i foo.mov -c:v libxvid -pass 1 -an -f rawvideo -y NUL +avconv -i foo.mov -c:v libxvid -pass 1 -an -f rawvideo -y /dev/null @end example @item -passlogfile @var{prefix} @@ -541,7 +565,7 @@ Show QP histogram. @item -vbsf @var{bitstream_filter} Bitstream filters available are "dump_extra", "remove_extra", "noise", "h264_mp4toannexb", "imxdump", "mjpegadump", "mjpeg2jpeg". @example -avconv -i h264.mp4 -vcodec copy -vbsf h264_mp4toannexb -an out.h264 +avconv -i h264.mp4 -c:v copy -vbsf h264_mp4toannexb -an out.h264 @end example @item -force_key_frames @var{time}[,@var{time}...] Force key frames at the specified timestamps, more precisely at the first @@ -571,8 +595,7 @@ and is mapped to the corresponding demuxer options. @item -an Disable audio recording. @item -acodec @var{codec} -Force audio codec to @var{codec}. Use the @code{copy} special value to -specify that the raw codec data must be copied as is. +Set the audio codec. This is an alias for @code{-codec:a}. @item -alang @var{code} Set the ISO 639 language code (3 letters) of the current audio stream. @end table @@ -612,7 +635,7 @@ Bitstream filters available are "dump_extra", "remove_extra", "noise", "mp3comp" @table @option @item -scodec @var{codec} -Force subtitle codec ('copy' to copy stream). +Set the subtitle codec. This is an alias for @code{-codec:s}. @item -slang @var{code} Set the ISO 639 language code (3 letters) of the current subtitle stream. @item -sn @@ -620,7 +643,7 @@ Disable subtitle recording. @item -sbsf @var{bitstream_filter} Bitstream filters available are "mov2textsub", "text2movsub". @example -avconv -i file.mov -an -vn -sbsf mov2textsub -scodec copy -f rawvideo sub.txt +avconv -i file.mov -an -vn -sbsf mov2textsub -c:s copy -f rawvideo sub.txt @end example @end table @@ -677,7 +700,7 @@ For example, to select the stream with index 2 from input file index 6 from input @file{b.mov} (specified by the identifier "1:6"), and copy them to the output file @file{out.mov}: @example -avconv -i a.mov -i b.mov -vcodec copy -acodec copy -map 0:2 -map 1:6 out.mov +avconv -i a.mov -i b.mov -c copy -map 0:2 -map 1:6 out.mov @end example To select all video and the third audio stream from an input file: @@ -945,7 +968,7 @@ stream, in the order of the definition of output streams. You can transcode decrypted VOBs: @example -avconv -i snatch_1.vob -f avi -vcodec mpeg4 -b 800k -g 300 -bf 2 -acodec libmp3lame -ab 128k snatch.avi +avconv -i snatch_1.vob -f avi -c:v mpeg4 -b 800k -g 300 -bf 2 -c:a libmp3lame -ab 128k snatch.avi @end example This is a typical DVD ripping example; the input is a VOB file, the @@ -989,7 +1012,7 @@ only formats accepting a normal integer are suitable. You can put many streams of the same type in the output: @example -avconv -i test1.avi -i test2.avi -map 0.3 -map 0.2 -map 0.1 -map 0.0 -vcodec copy -acodec copy -vcodec copy -acodec copy test12.nut +avconv -i test1.avi -i test2.avi -map 0.3 -map 0.2 -map 0.1 -map 0.0 -c copy test12.nut @end example The resulting output file @file{test12.avi} will contain first four streams from |