diff options
author | nanahi <130121847+na-na-hi@users.noreply.github.com> | 2024-02-12 03:45:20 -0500 |
---|---|---|
committer | Dudemanguy <random342@airmail.cc> | 2024-02-15 16:44:32 +0000 |
commit | e19061605f7858a0639134aa4744809c5e151ae2 (patch) | |
tree | a4342cd72442164bda3fa7423cb241643c20dc12 | |
parent | 690dc201ad07aae68b42fd368384990a18ddd86f (diff) | |
download | mpv-e19061605f7858a0639134aa4744809c5e151ae2.tar.bz2 mpv-e19061605f7858a0639134aa4744809c5e151ae2.tar.xz |
DOCS: document --input-preprocess-wheel option
Document the use cases for enabling or disabling the wheel preprocessing.
Also note that this option has no effect on any filtering already done
by the OS/driver.
-rw-r--r-- | DOCS/interface-changes.rst | 1 | ||||
-rw-r--r-- | DOCS/man/options.rst | 14 |
2 files changed, 15 insertions, 0 deletions
diff --git a/DOCS/interface-changes.rst b/DOCS/interface-changes.rst index d71f14910c..ef1742007d 100644 --- a/DOCS/interface-changes.rst +++ b/DOCS/interface-changes.rst @@ -30,6 +30,7 @@ Interface changes - add `--volume-gain`, `--volume-gain-min`, and `--volume-gain-max` options - add `current-gpu-context` property - add `--secondary-sub-ass-override` option + - add `--input-preprocess-wheel` option - remove shared-script-properties (user-data is a replacement) - add `--secondary-sub-delay`, decouple secondary subtitles from `--sub-delay` diff --git a/DOCS/man/options.rst b/DOCS/man/options.rst index 131319c9aa..6a11f18944 100644 --- a/DOCS/man/options.rst +++ b/DOCS/man/options.rst @@ -4195,6 +4195,20 @@ Input implemented. Whether media keys work when the mpv window is focused is implementation-defined. +``--input-preprocess-wheel=<yes|no>`` + Preprocess ``WHEEL_*`` events so that while scrolling on the horizontal + or vertical direction, the events aren't generated for another direction + even when the two directions are scrolled together (default: yes). + + This preprocessing can be beneficial for preventing accidentally seeking + while changing the volume by scrolling on a touchpad with the default + keybind. Due to the deadzone mechanism used, disabling the preprocessing + allows for diagonal scrolling (such as panning) and potentially reduces + input latency. + + Note that disabling the preprocessing does not affect any filtering done + by the OS/driver before these events are delivered to mpv, if any. + ``--input-right-alt-gr``, ``--no-input-right-alt-gr`` (macOS and Windows only) Use the right Alt key as Alt Gr to produce special characters. If disabled, |