summaryrefslogtreecommitdiffstats
path: root/DOCS/man/en/encode.rst
diff options
context:
space:
mode:
authorRudolf Polzer <divverent@xonotic.org>2012-09-14 17:51:26 +0200
committerwm4 <wm4@nowhere>2012-09-18 21:08:20 +0200
commitf5b8b6ac126d8cef3860db16d3db8e72507a2258 (patch)
treec86a6160cee076d3a632e4d3247e566e8c064390 /DOCS/man/en/encode.rst
parent5617bf483e563aae22100c0ca1d8182f71d4f82d (diff)
downloadmpv-f5b8b6ac126d8cef3860db16d3db8e72507a2258.tar.bz2
mpv-f5b8b6ac126d8cef3860db16d3db8e72507a2258.tar.xz
encode: video encoding now supported using mencoder-like options
Diffstat (limited to 'DOCS/man/en/encode.rst')
-rw-r--r--DOCS/man/en/encode.rst134
1 files changed, 134 insertions, 0 deletions
diff --git a/DOCS/man/en/encode.rst b/DOCS/man/en/encode.rst
new file mode 100644
index 0000000000..7ebd8e6c01
--- /dev/null
+++ b/DOCS/man/en/encode.rst
@@ -0,0 +1,134 @@
+.. _encode:
+
+ENCODING
+========
+
+You can encode files from one format/codec to another using this facility.
+
+-o <filename>
+ Enables encoding mode and specifies the output file name.
+
+--of=<format>
+ Specifies the output format (overrides autodetection by the extension of
+ the file specified by -o).
+ See --of=help for a full list of supported formats.
+
+--ofopts=<options>
+ Specifies the output format options for libavformat.
+ See --ofopts=help for a full list of supported options.
+
+ Options are managed in lists. There are a few commands to manage the
+ options list.
+
+ --ofopts-add=<options1[,options2,...]>
+ Appends the options given as arguments to the options list.
+
+ --ofopts-pre=<options1[,options2,...]>
+ Prepends the options given as arguments to the options list.
+
+ --ofopts-del=<index1[,index2,...]>
+ Deletes the options at the given indexes. Index numbers start at 0,
+ negative numbers address the end of the list (-1 is the last).
+
+ --ofopts-clr
+ Completely empties the options list.
+
+--ofps=<float value>
+ Specifies the output format time base (default: 24000). Low values like 25
+ limit video fps by dropping frames.
+
+--oautofps
+ Sets the output format time base to the guessed frame rate of the input
+ video (simulates mencoder behaviour, useful for AVI; may cause frame
+ drops). Note that not all codecs and not all formats support VFR
+ encoding, and some which do have bugs when a target bitrate is
+ specified - use --ofps or --oautofps to force CFR encoding in these
+ cases.
+
+--oharddup
+ If set, the frame rate given by --ofps is attained not by skipping time
+ codes, but by duplicating frames (constant frame rate mode).
+
+--oneverdrop
+ If set, frames are never dropped. Instead, time codes of video are
+ readjusted to always increase. This may cause AV desync, though; to
+ work around this, use a high-fps time base using --ofps and absolutely
+ avoid --oautofps.
+
+--oac=<codec>
+ Specifies the output audio codec.
+ See --oac=help for a full list of supported codecs.
+
+--oaoffset=<value>
+ Shifts audio data by the given time (in seconds) by adding/removing
+ samples at the start.
+
+--oacopts=<options>
+ Specifies the output audio codec options for libavcodec.
+ See --oacopts=help for a full list of supported options.
+
+ EXAMPLE: "--oac=libmp3lame --oacopts=b=128000" selects 128kbps MP3
+ encoding.
+
+ Options are managed in lists. There are a few commands to manage the
+ options list.
+
+ --oacopts-add=<options1[,options2,...]>
+ Appends the options given as arguments to the options list.
+
+ --oacopts-pre=<options1[,options2,...]>
+ Prepends the options given as arguments to the options list.
+
+ --oacopts-del=<index1[,index2,...]>
+ Deletes the options at the given indexes. Index numbers start at 0,
+ negative numbers address the end of the list (-1 is the last).
+
+ --oacopts-clr
+ Completely empties the options list.
+
+--ovc=<codec>
+ Specifies the output video codec.
+ See --ovc=help for a full list of supported codecs.
+
+--ovoffset=<value>
+ Shifts video data by the given time (in seconds) by shifting the pts
+ values.
+
+--ocopyts
+ Copies input pts to the output video (not supported by some output
+ container formats, e.g. avi). Discontinuities are still fixed.
+ By default, audio pts are set to playback time and video pts are
+ synchronized to match audio pts, as some output formats do not support
+ anything else.
+
+--orawts
+ Copies input pts to the output video (not supported by some output
+ container formats, e.g. avi). In this modem discontinuities are not fixed
+ and all pts are passed through as-is. Never seek backwards or use multiple
+ input files in this mode!
+
+--ovcopts <options>
+ Specifies the output video codec options for libavcodec.
+ See --ovcopts=help for a full list of supported options.
+
+ EXAMPLE: "--ovc=mpeg4 --oacopts=qscale=5" selects constant quantizer scale
+ 5 for MPEG-4 encoding.
+
+ EXAMPLE: "--ovc=libx264 --ovcopts=crf=23" selects VBR quality factor 23 for
+ H.264 encoding.
+
+ Options are managed in lists. There are a few commands to manage the
+ options list.
+
+ --ovcopts-add=<options1[,options2,...]>
+ Appends the options given as arguments to the options list.
+
+ --ovcopts-pre=<options1[,options2,...]>
+ Prepends the options given as arguments to the options list.
+
+ --ovcopts-del=<index1[,index2,...]>
+ Deletes the options at the given indexes. Index numbers start at 0,
+ negative numbers address the end of the list (-1 is the last).
+
+ --ovcopts-clr
+ Completely empties the options list.