From cc69650e76269a3b419e6a73eb06e12284e91974 Mon Sep 17 00:00:00 2001 From: wm4 Date: Wed, 31 May 2017 17:42:03 +0200 Subject: af, vf: improvements to libavfilter bridge Add the "lavfi-" prefix (details see manpage additons). Tag the filter name as "(lavfi)" in the verbose filter list output. --- DOCS/man/af.rst | 3 +++ DOCS/man/vf.rst | 12 +++++++++--- 2 files changed, 12 insertions(+), 3 deletions(-) (limited to 'DOCS') diff --git a/DOCS/man/af.rst b/DOCS/man/af.rst index bc25a9f7b3..b56fc919a1 100644 --- a/DOCS/man/af.rst +++ b/DOCS/man/af.rst @@ -15,6 +15,9 @@ syntax is: wrapper, which gives you access to most of libavfilter's filters. This includes all filters that have been ported from MPlayer to libavfilter. + The ``--vf`` description describes how libavfilter can be used and how to + workaround deprecated mpv filters. + See ``--vf`` group of options for info on how ``--af-defaults``, ``--af-add``, ``--af-pre``, ``--af-del``, ``--af-clr``, and possibly others work. diff --git a/DOCS/man/vf.rst b/DOCS/man/vf.rst index 2d53fc4ce2..64e5c0c0cd 100644 --- a/DOCS/man/vf.rst +++ b/DOCS/man/vf.rst @@ -49,13 +49,14 @@ normal filter parameters. .. note:: - To get a full list of available video filters, see ``--vf=help``. + To get a full list of available video filters, see ``--vf=help`` and + http://ffmpeg.org/ffmpeg-filters.html . Also, keep in mind that most actual filters are available via the ``lavfi`` wrapper, which gives you access to most of libavfilter's filters. This includes all filters that have been ported from MPlayer to libavfilter. - Most filters are deprecated in some ways, unless they're only available + Most builtin filters are deprecated in some ways, unless they're only available in mpv (such as filters which deal with mpv specifics, or which are implemented in mpv only). @@ -66,6 +67,11 @@ normal filter parameters. everything accepted by vf_lavfi's ``graph`` option will be accepted by ``--vf``.) + You can also prefix the filter name with ``lavfi-`` to force the wrapper. + This is helpful if the filter name collides with a deprecated mpv builtin + filter. For example ``--vf=lavfi-scale=args`` would use libavfilter's + ``scale`` filter over mpv's deprecated builtin one. + Video filters are managed in lists. There are a few commands to manage the filter list. @@ -92,7 +98,7 @@ With filters that support it, you can access parameters by their name. Sets a named parameter to the given value. Use on and off or yes and no to set flag parameters. -Available filters are: +Available mpv-only filters are: ``crop[=w:h:x:y]`` Crops the given part of the image and discards the rest. Useful to remove -- cgit v1.2.3