RepoMirrors/mpv
1
0
Fork 0
mirror of https://github.com/mpv-player/mpv synced 2025-01-25 17:13:21 +00:00
Code Issues Releases Wiki Activity

manpage: clarify --af=format

Browse Source
This commit is contained in:
Kevin Mitchell 2015-04-15 03:48:05 -07:00
parent e1e46cc81a
commit 3f8b8b8c0c
1 changed files with 16 additions and 14 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

30
DOCS/man/af.rst
View File

@ -225,14 +225,21 @@ Available filters are:
automatically up- and downmix standard channel layouts. automatically up- and downmix standard channel layouts.
``format=format:srate:channels:out-format:out-srate:out-channels`` ``format=format:srate:channels:out-format:out-srate:out-channels``
Force a specific audio format/configuration without actually changing the Does not do any format conversion itself. Rather, it may cause the
audio data. Keep in mind that the filter system might auto-insert actual filter system to insert necessary conversion filters before or after this
conversion filters before or after this filter if needed. filter if needed. It is primarily useful for controlling the audio format
going into other filters. To specify the format for audio output, see
``--audio-format``, ``--audio-samplerate``, and ``--audio-channels``. This
filter is able to force a particular format, whereas ``--audio-*``
may be overridden by the ao based on output compatibility.
All parameters are optional. The first 3 parameters restrict what the filter All parameters are optional. The first 3 parameters restrict what the filter
accepts as input. The ``out-`` parameters change the audio format, without accepts as input. They will therefore cause conversion filters to be
actually doing a conversion. The data will be 'reinterpreted' by the inserted before this one. The ``out-`` parameters tell the filters or audio
filters or audio outputs following this filter. outputs following this filter how to interpret the data without actually
doing a conversion. Setting these will probably just break things unless you
really know you want this for some reason, such as testing or dealing with
broken media.
``<format>`` ``<format>``
Force conversion to this format. Use ``--af=format=format=help`` to get Force conversion to this format. Use ``--af=format=format=help`` to get
@ -252,14 +259,9 @@ Available filters are:
``<out-channels>`` ``<out-channels>``
See also ``--audio-format``, ``--audio-samplerate``, and *NOTE*: this filter used to be named ``force``. The old ``format`` filter
``--audio-channels`` for related options. Keep in mind that used to do conversion itself, unlike this one which lets the filter system
``--audio-channels`` does not actually force the number of handle the conversion.
channels in most cases, while this filter can do this.
*NOTE*: this filter used to be named ``force``. Also, unlike the old
``format`` filter, this does not do any actual conversion anymore.
Conversion is done by other, automatically inserted filters.
``convert24`` ``convert24``
Filter for internal use only. Converts between 24-bit and 32-bit sample Filter for internal use only. Converts between 24-bit and 32-bit sample