summaryrefslogtreecommitdiffstats
path: root/DOCS/man/input.rst
diff options
context:
space:
mode:
Diffstat (limited to 'DOCS/man/input.rst')
-rw-r--r--DOCS/man/input.rst23
1 files changed, 21 insertions, 2 deletions
diff --git a/DOCS/man/input.rst b/DOCS/man/input.rst
index c847b861b0..76678c2b3c 100644
--- a/DOCS/man/input.rst
+++ b/DOCS/man/input.rst
@@ -1224,11 +1224,30 @@ Property list
``hr-seek`` (RW)
See ``--hr-seek``.
+``mixer-active``
+ Return ``yes`` if the audio mixer is active, ``no`` otherwise. This has
+ implications for ``--softvol=no`` mode: if the mixer is active, changing
+ ``volume`` doesn't actually change anything on the system mixer. If the
+ ``--volume`` or ``--mute`` option are used, these might not be applied
+ property until the mixer becomes active either. (The options, if set, will
+ just overwrite the mixer state at audio initialization.)
+
+ While the behavior with ``mixer-active==yes`` is relatively well-defined,
+ the ``no`` case will provide possibly wrong or insignificant values.
+
+ Note that an active mixer does not necessarily imply active audio output,
+ although this is implied in the current implementation.
+
``volume`` (RW)
- Current volume (see ``--volume`` for details).
+ Current volume (see ``--volume`` for details). Also see ``mixer-active``
+ property.
+
+``volume-max``
+ Current maximum value the volume property can be set to. (This may depend
+ on the ``--softvol-max`` option.)
``mute`` (RW)
- Current mute status (``yes``/``no``).
+ Current mute status (``yes``/``no``). Also see ``mixer-active`` property.
``audio-delay`` (RW)
See ``--audio-delay``.