diff options
author | wm4 <wm4@nowhere> | 2013-12-01 00:12:10 +0100 |
---|---|---|
committer | wm4 <wm4@nowhere> | 2013-12-01 00:12:10 +0100 |
commit | b18f02d1ad5e5ce4031438f1cd0f1f3aaaf83003 (patch) | |
tree | b723192a213fbdb0b64a742c91bc106237e5d539 /DOCS | |
parent | aaddcb702ef93eac9087852202a59f91abb31433 (diff) | |
download | mpv-b18f02d1ad5e5ce4031438f1cd0f1f3aaaf83003.tar.bz2 mpv-b18f02d1ad5e5ce4031438f1cd0f1f3aaaf83003.tar.xz |
options: add options that set defaults for af/vf/ao/vo
There are some use cases for this. For example, you can use it to set
defaults of automatically inserted filters (like af_lavrresample). It's
also useful if you have a non-trivial VO configuration, and want to use
--vo to quickly change between the drivers without repeating the whole
configuration in the --vo argument.
Diffstat (limited to 'DOCS')
-rw-r--r-- | DOCS/man/en/af.rst | 12 | ||||
-rw-r--r-- | DOCS/man/en/ao.rst | 6 | ||||
-rw-r--r-- | DOCS/man/en/vf.rst | 6 | ||||
-rw-r--r-- | DOCS/man/en/vo.rst | 6 |
4 files changed, 27 insertions, 3 deletions
diff --git a/DOCS/man/en/af.rst b/DOCS/man/en/af.rst index ab1e7cab8c..03c0780390 100644 --- a/DOCS/man/en/af.rst +++ b/DOCS/man/en/af.rst @@ -11,6 +11,12 @@ syntax is: To get a full list of available audio filters, see ``--af=help``. +You can also set defaults for each filter. The defaults are applied before the +normal filter parameters. + +``--af-defaults=<filter1[=parameter1:parameter2:...],filter2,...>`` + Set defaults for each filter. + Audio filters are managed in lists. There are a few commands to manage the filter list: @@ -50,9 +56,9 @@ Available filters are: entries. (default: no) ``no-detach`` Do not detach if input and output audio format/rate/channels match. - You should add this option if you specify additional parameters, as - automatically inserted lavrresample instances will use the default - settings. + (If you just want to set defaults for this filter that will be used + even by automatically inserted lavrresample instances, you should + prefer setting them with ``--af-defaults=lavrresample:...``.) ``o=<string>`` Set AVOptions on the SwrContext or AVAudioResampleContext. These should be documented by FFmpeg or Libav. diff --git a/DOCS/man/en/ao.rst b/DOCS/man/en/ao.rst index 592d2de94f..df2c33e119 100644 --- a/DOCS/man/en/ao.rst +++ b/DOCS/man/en/ao.rst @@ -10,6 +10,12 @@ syntax is: If the list has a trailing ',', mpv will fall back on drivers not contained in the list. Suboptions are optional and can mostly be omitted. +You can also set defaults for each driver. The defaults are applied before the +normal driver parameters. + +``--ao-defaults=<driver1[:parameter1:parameter2:...],driver2,...>`` + Set defaults for each driver. + .. note:: See ``--ao=help`` for a list of compiled-in audio output drivers. diff --git a/DOCS/man/en/vf.rst b/DOCS/man/en/vf.rst index 64ea051391..4c1423f9d2 100644 --- a/DOCS/man/en/vf.rst +++ b/DOCS/man/en/vf.rst @@ -7,6 +7,12 @@ syntax is: ``--vf=<filter1[=parameter1:parameter2:...],filter2,...>`` Setup a chain of video filters. +You can also set defaults for each filter. The defaults are applied before the +normal filter parameters. + +``--vf-defaults=<filter1[=parameter1:parameter2:...],filter2,...>`` + Set defaults for each filter. + Many parameters are optional and set to default values if omitted. To explicitly use a default value, set a parameter to '-1'. Parameters ``w:h`` means width x height in pixels, ``x:y`` means x;y position counted from the diff --git a/DOCS/man/en/vo.rst b/DOCS/man/en/vo.rst index fd14c6a128..3d6bc0095f 100644 --- a/DOCS/man/en/vo.rst +++ b/DOCS/man/en/vo.rst @@ -10,6 +10,12 @@ syntax is: If the list has a trailing ',', mpv will fall back on drivers not contained in the list. Suboptions are optional and can mostly be omitted. +You can also set defaults for each driver. The defaults are applied before the +normal driver parameters. + +``--vo-defaults=<driver1[:parameter1:parameter2:...],driver2,...>`` + Set defaults for each driver. + .. note:: See ``--vo=help`` for a list of compiled-in video output drivers. |