diff options
Diffstat (limited to 'DOCS/man/encode.rst')
| -rw-r--r-- | DOCS/man/encode.rst | 49 |
1 files changed, 18 insertions, 31 deletions
diff --git a/DOCS/man/encode.rst b/DOCS/man/encode.rst index 4c885ea168..26f3d6cbc8 100644 --- a/DOCS/man/encode.rst +++ b/DOCS/man/encode.rst @@ -15,11 +15,11 @@ You can encode files from one format/codec to another using this facility. 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. + This is a key/value list option. See `List Options`_ for details. - ``--ofopts-add=<options1[,options2,...]>`` - Appends the options given as arguments to the options list. + ``--ofopts-add=<option>`` + Appends the option given as an argument to the options list. (Passing + multiple options is currently still possible, but deprecated.) ``--ofopts=""`` Completely empties the options list. @@ -28,10 +28,6 @@ You can encode files from one format/codec to another using this facility. 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. Deprecated. - ``--oacopts=<options>`` Specifies the output audio codec options for libavcodec. See ``--oacopts=help`` for a full list of supported options. @@ -41,27 +37,19 @@ You can encode files from one format/codec to another using this facility. "``--oac=libmp3lame --oacopts=b=128000``" selects 128 kbps MP3 encoding. - Options are managed in lists. There are a few commands to manage the - options list. + This is a key/value list option. See `List Options`_ for details. - ``--oacopts-add=<options1[,options2,...]>`` - Appends the options given as arguments to the options list. + ``--oacopts-add=<option>`` + Appends the option given as an argument to the options list. (Passing + multiple options is currently still possible, but deprecated.) ``--oacopts=""`` Completely empties the options list. -``--oafirst`` - Force the audio stream to become the first stream in the output. - By default, the order is unspecified. Deprecated. - ``--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. Deprecated. - ``--ovcopts=<options>`` Specifies the output video codec options for libavcodec. See --ovcopts=help for a full list of supported options. @@ -74,28 +62,23 @@ You can encode files from one format/codec to another using this facility. ``"--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. + This is a key/value list option. See `List Options`_ for details. - ``--ovcopts-add=<options1[,options2,...]>`` - Appends the options given as arguments to the options list. + ``--ovcopts-add=<option>`` + Appends the option given as an argument to the options list. (Passing + multiple options is currently still possible, but deprecated.) ``--ovcopts=""`` Completely empties the options list. -``--ovfirst`` - Force the video stream to become the first stream in the output. - By default, the order is unspecified. Deprecated. - ``--orawts`` Copies input pts to the output video (not supported by some output container formats, e.g. AVI). In this mode, discontinuities are not fixed and all pts are passed through as-is. Never seek backwards or use multiple input files in this mode! -``--no-ocopy-metadata`` - Turns off copying of metadata from input files to output files when - encoding (which is enabled by default). +``--ocopy-metadata=<yes|no>`` + Copy metadata from input files to output files when encoding (default: yes). ``--oset-metadata=<metadata-tag[,metadata-tag,...]>`` Specifies metadata to include in the output file. @@ -103,6 +86,8 @@ You can encode files from one format/codec to another using this facility. FLAC allow almost arbitrary keys, while support in MP4 and MP3 is more limited. + This is a key/value list option. See `List Options`_ for details. + .. admonition:: Example "``--oset-metadata=title="Output title",comment="Another tag"``" @@ -112,6 +97,8 @@ You can encode files from one format/codec to another using this facility. Specifies metadata to exclude from the output file when copying from the input file. + This is a string list option. See `List Options`_ for details. + .. admonition:: Example "``--oremove-metadata=comment,genre``" |