From b18f02d1ad5e5ce4031438f1cd0f1f3aaaf83003 Mon Sep 17 00:00:00 2001 From: wm4 Date: Sun, 1 Dec 2013 00:12:10 +0100 Subject: 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. --- DOCS/man/en/af.rst | 12 +++++++++--- DOCS/man/en/ao.rst | 6 ++++++ DOCS/man/en/vf.rst | 6 ++++++ DOCS/man/en/vo.rst | 6 ++++++ 4 files changed, 27 insertions(+), 3 deletions(-) (limited to 'DOCS') 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=`` + 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=`` 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=`` + 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=`` 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=`` + 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=`` + Set defaults for each driver. + .. note:: See ``--vo=help`` for a list of compiled-in video output drivers. -- cgit v1.2.3