summaryrefslogtreecommitdiffstats
path: root/DOCS
diff options
context:
space:
mode:
authorwm4 <wm4@nowhere>2013-09-19 14:32:47 +0200
committerwm4 <wm4@nowhere>2013-09-20 13:23:25 +0200
commitb8e42ae13c511855fcba0b6b795d55b37e461665 (patch)
treef7090d8218894692ac600da6e7d6e62c382d1731 /DOCS
parent234d967bed3784657279052e23fdfa751ae1e7fc (diff)
downloadmpv-b8e42ae13c511855fcba0b6b795d55b37e461665.tar.bz2
mpv-b8e42ae13c511855fcba0b6b795d55b37e461665.tar.xz
mixer: restore volume with playback resume
Note that this is intentionally never done if the AO or softvolume is different, or if the current volume control method is thought to control system wide volume (such as ALSA) or otherwise user controllable (such as PulseAudio). The intention is to keep things robust and to avoid messing with the user's audio settings as far as possible, while still providing the ability to resume volume if it makes sense.
Diffstat (limited to 'DOCS')
-rw-r--r--DOCS/man/en/options.rst12
1 files changed, 12 insertions, 0 deletions
diff --git a/DOCS/man/en/options.rst b/DOCS/man/en/options.rst
index f9a75779f7..ac07a9a1ba 100644
--- a/DOCS/man/en/options.rst
+++ b/DOCS/man/en/options.rst
@@ -2596,6 +2596,18 @@
Set the startup volume. A value of -1 (the default) will not change the
volume. See also ``--softvol``.
+``--volume-restore-data=<string>``
+ Used internally for use by playback resume (e.g. with ``quit_watch_later``).
+ Restoring value has to be done carefully, because different AOs as well as
+ softvol can have different value ranges, and we don't want to restore
+ volume if setting the volume changes it system wide. The normal options
+ (like ``--volume``) would always set the volume. This option was added for
+ restoring volume in a safer way (by storing the method used to set the
+ volume), and is not generally useful. Its semantics are considered private
+ to mpv.
+
+ Do not use.
+
``--wid=<ID>``
(X11 and Windows only)
This tells mpv to attach to an existing window. The ID is interpreted as