diff options
Diffstat (limited to 'DOCS/man/vf.rst')
| -rw-r--r-- | DOCS/man/vf.rst | 66 |
1 files changed, 45 insertions, 21 deletions
diff --git a/DOCS/man/vf.rst b/DOCS/man/vf.rst index 027ac6f55f..a989ad5445 100644 --- a/DOCS/man/vf.rst +++ b/DOCS/man/vf.rst @@ -44,19 +44,17 @@ The exact syntax is: the ``lavfi`` filter, which uses a very similar syntax as mpv (MPlayer historically) to specify filters and their parameters. +.. note:: + + ``--vf`` can only take a single track as input, even if the filter supports + dynamic input. Filters that require multiple inputs can't be used. + Use ``--lavfi-complex`` for such a use case. This also applies for ``--af``. + Filters can be manipulated at run time. You can use ``@`` labels as described above in combination with the ``vf`` command (see `COMMAND INTERFACE`_) to get more control over this. Initially disabled filters with ``!`` are useful for this as well. -You can also set defaults for each filter. The defaults are applied before the -normal filter parameters. This is deprecated and never worked for the -libavfilter bridge. - -``--vf-defaults=<filter1[=parameter1:parameter2:...],filter2,...>`` - Set defaults for each filter. (Deprecated. ``--af-defaults`` is deprecated - as well.) - .. note:: To get a full list of available video filters, see ``--vf=help`` and @@ -110,11 +108,6 @@ filter list. from the list if it was present. Matching of filters works as described in ``--vf-remove``. -``--vf-del=filter`` - Sort of like ``--vf-remove``, but also accepts an index number. Index - numbers start at 0, negative numbers address the end of the list (-1 is the - last). Deprecated. - ``--vf-clr`` Completely empties the filter list. @@ -141,6 +134,11 @@ Available mpv-only filters are: For a list of available formats, use ``--vf=format=fmt=help``. + .. note:: + + Conversion between hardware formats is supported in some cases. + eg: ``cuda`` to ``vulkan``, or ``vaapi`` to ``vulkan``. + ``<convert=yes|no>`` Force conversion of color parameters (default: no). @@ -164,6 +162,9 @@ Available mpv-only filters are: If input and output video parameters are the same, conversion is always skipped. + When converting between hardware formats, this parameter has no effect, + and the only conversion that is done is the format conversion. + .. admonition:: Examples ``mpv test.mkv --vf=format:colormatrix=ycgco`` @@ -203,10 +204,13 @@ Available mpv-only filters are: Available color spaces are: :auto: automatic selection (default) - :bt.601: ITU-R BT.601 (SD) - :bt.709: ITU-R BT.709 (HD) - :bt.2020-ncl: ITU-R BT.2020 non-constant luminance system - :bt.2020-cl: ITU-R BT.2020 constant luminance system + :bt.601: ITU-R Rec. BT.601 (SD) + :bt.709: ITU-R Rec. BT.709 (HD) + :bt.2020-ncl: ITU-R Rec. BT.2020 (non-constant luminance) + :bt.2020-cl: ITU-R Rec. BT.2020 (constant luminance) + :bt.2100-pq: ITU-R Rec. BT.2100 ICtCp PQ variant + :bt.2100-hlg: ITU-R Rec. BT.2100 ICtCp HLG variant + :dolbyvision: Dolby Vision :smpte-240m: SMPTE-240M ``<colorlevels>`` @@ -312,6 +316,10 @@ Available mpv-only filters are: Whether or not to include Dolby Vision metadata (default: yes). If disabled, any Dolby Vision metadata will be stripped from frames. + ``<hdr10plus=yes|no>`` + Whether or not to include HDR10+ metadata (default: yes). If + disabled, any HDR10+ metadata will be stripped from frames. + ``<film-grain=yes|no>`` Whether or not to include film grain metadata (default: yes). If disabled, any film grain metadata will be stripped from frames. @@ -568,13 +576,19 @@ Available mpv-only filters are: completely broken (e.g. 0 or NaN). Even if the value is correct, if another filter changes the real FPS (by dropping or inserting frames), the value of this variable will not be useful. Note that - the ``--fps`` command line option overrides this value. + the ``--container-fps-override`` command line option overrides this value. Useful for some filters which insist on having a FPS. ``display_fps`` Refresh rate of the current display. Note that this value can be 0. + ``display_res`` + Resolution of the current display. This is an integer array with the + first entry corresponding to the width and the second entry corresponding + to the height. These values can be 0. Note that this will not respond to + monitor changes and may not work on all platforms. + ``vavpp`` VA-API video post processing. Requires the system to support VA-API, i.e. Linux/BSD only. Works with ``--vo=vaapi`` and ``--vo=gpu`` only. @@ -751,12 +765,22 @@ Available mpv-only filters are: read information from this filter instead. ``gpu=...`` - Convert video to RGB using the OpenGL renderer normally used with - ``--vo=gpu``. This requires that the EGL implementation supports off-screen - rendering on the default display. (This is the case with Mesa.) + Convert video to RGB using the Vulkan or OpenGL renderer normally used with + ``--vo=gpu``. In case of OpenGL, this requires that the EGL implementation + supports off-screen rendering on the default display. (This is the case with + Mesa.) Sub-options: + ``api=<type>`` + The value ``type`` selects the rendering API. You can also pass + ``help`` to get a complete list of compiled in backends. + + egl + EGL (default if available) + vulkan + Vulkan + ``w=<pixels>``, ``h=<pixels>`` Size of the output in pixels (default: 0). If not positive, this will use the size of the first filtered input frame. |