summaryrefslogtreecommitdiffstats
path: root/DOCS
diff options
context:
space:
mode:
authorwm4 <wm4@nowhere>2013-12-01 00:12:10 +0100
committerwm4 <wm4@nowhere>2013-12-01 00:12:10 +0100
commitb18f02d1ad5e5ce4031438f1cd0f1f3aaaf83003 (patch)
treeb723192a213fbdb0b64a742c91bc106237e5d539 /DOCS
parentaaddcb702ef93eac9087852202a59f91abb31433 (diff)
downloadmpv-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.rst12
-rw-r--r--DOCS/man/en/ao.rst6
-rw-r--r--DOCS/man/en/vf.rst6
-rw-r--r--DOCS/man/en/vo.rst6
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.