diff options
| author | wm4 <wm4@nowhere> | 2017-04-26 21:45:50 +0200 |
|---|---|---|
| committer | wm4 <wm4@nowhere> | 2017-04-26 21:45:55 +0200 |
| commit | f1c4d20e6577f32018e20efc4ab9da7d4e1ab4ac (patch) | |
| tree | b9c6c26faefce976496c527d524cd2e09a96b29f /DOCS | |
| parent | 010c7d499258c1064189b2d149ae6eca859d9ae1 (diff) | |
| download | mpv-f1c4d20e6577f32018e20efc4ab9da7d4e1ab4ac.tar.bz2 mpv-f1c4d20e6577f32018e20efc4ab9da7d4e1ab4ac.tar.xz | |
audio: move replaygain control to top-level options
af_volume is deprecated, and so are its replaygain sub-options. To make
it possible to use replaygain without deprecated options (and of course
to make it available at all after af_volume is dropped), reintroduce
them as top-level options.
This also means that they are easily changeable at runtime by using them
as properties. Change the "volume" property to use the new update
mechanism as well.
We don't actually bother sharing the implementation between new and
deprecated mechanisms, as the deprecated one will simply be deleted.
For the from_dB() functions, we mention anders' copyright, although I'm
not sure if a mere formula is copyrightable. This will have to be
determined later.
This whole change is mostly untested. Our distributed human CI will take
care of it.
Diffstat (limited to 'DOCS')
| -rw-r--r-- | DOCS/interface-changes.rst | 2 | ||||
| -rw-r--r-- | DOCS/man/af.rst | 3 | ||||
| -rw-r--r-- | DOCS/man/options.rst | 20 |
3 files changed, 25 insertions, 0 deletions
diff --git a/DOCS/interface-changes.rst b/DOCS/interface-changes.rst index 464435bcbe..aadbf159d0 100644 --- a/DOCS/interface-changes.rst +++ b/DOCS/interface-changes.rst @@ -22,6 +22,8 @@ Interface changes --- mpv 0.26.0 --- - remove remaining deprecated audio device options, like --alsa-device Some of them were removed in earlier releases. + - introduce --replaygain... options, which replace the same functionality + provided by the deprecated --af=volume:replaygain... mechanism. --- mpv 0.25.0 --- - remove opengl-cb dxva2 dummy hwdec interop (see git "vo_opengl: remove dxva2 dummy hwdec backend") diff --git a/DOCS/man/af.rst b/DOCS/man/af.rst index 9dff18ebbe..bc25a9f7b3 100644 --- a/DOCS/man/af.rst +++ b/DOCS/man/af.rst @@ -208,6 +208,9 @@ Available filters are: best to use the *Master* volume control of your sound card or the volume knob on your amplifier. + *WARNING*: This filter is deprecated. Use the top-level options like + ``--volume`` and ``--replaygain...`` instead. + *NOTE*: This filter is not reentrant and can therefore only be enabled once for every audio stream. diff --git a/DOCS/man/options.rst b/DOCS/man/options.rst index 7d3070fda0..1f66b77225 100644 --- a/DOCS/man/options.rst +++ b/DOCS/man/options.rst @@ -1182,6 +1182,26 @@ Audio Since mpv 0.18.1, this always controls the internal mixer (aka "softvol"). +``--replaygain-track=<yes|no>`` + Adjust volume gain according to the track-gain replaygain value stored + in the file metadata. + +``--replaygain-album=<yes|no>`` + Like replaygain-track, but using the album-gain value instead. + +``--replaygain-preamp=<db>`` + Pre-amplification gain in dB to apply to the selected replaygain gain + (default: 0). + +``--replaygain-clip=<yes|no>`` + Prevent clipping caused by replaygain by automatically lowering the + gain (default). Use ``--replaygain-clip=no`` to disable this. + +``--replaygain-fallback=<db>`` + Gain in dB to apply if the file has no replay gain tags. This option + is always applied if the replaygain logic is somehow inactive. If this + is applied, no other replaygain options are applied. + ``--balance=<value>`` How much left/right channels contribute to the audio. (The implementation of this feature is rather odd. It doesn't change the volumes of each |