summaryrefslogtreecommitdiffstats
path: root/DOCS/man/options.rst
diff options
context:
space:
mode:
authorwm4 <wm4@nowhere>2017-04-26 21:45:50 +0200
committerwm4 <wm4@nowhere>2017-04-26 21:45:55 +0200
commitf1c4d20e6577f32018e20efc4ab9da7d4e1ab4ac (patch)
treeb9c6c26faefce976496c527d524cd2e09a96b29f /DOCS/man/options.rst
parent010c7d499258c1064189b2d149ae6eca859d9ae1 (diff)
downloadmpv-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/man/options.rst')
-rw-r--r--DOCS/man/options.rst20
1 files changed, 20 insertions, 0 deletions
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