diff options
author | wm4 <wm4@nowhere> | 2019-11-21 23:01:56 +0100 |
---|---|---|
committer | wm4 <wm4@nowhere> | 2019-11-22 01:15:08 +0100 |
commit | 21f2468d67e11eff7ede0d85fa6f4ab5c4f7de84 (patch) | |
tree | 0eccc529be050bdfe602ccbbcebdc04f4f193e71 /DOCS/man/input.rst | |
parent | eab5457e47389d5eeb79010f2f35e4d6613df86f (diff) | |
download | mpv-21f2468d67e11eff7ede0d85fa6f4ab5c4f7de84.tar.bz2 mpv-21f2468d67e11eff7ede0d85fa6f4ab5c4f7de84.tar.xz |
input: add text produced by key to script key events
Particularly for "any_unicode" mappings, so they don't have to
special-case keys like '#' and ' ', which are normally mapped to
symbolic names for input.conf reasons. (Though admittedly, this is a
pretty minor thing, since API users could map these manually.)
Diffstat (limited to 'DOCS/man/input.rst')
-rw-r--r-- | DOCS/man/input.rst | 10 |
1 files changed, 9 insertions, 1 deletions
diff --git a/DOCS/man/input.rst b/DOCS/man/input.rst index 81126efd43..02264f0eda 100644 --- a/DOCS/man/input.rst +++ b/DOCS/man/input.rst @@ -971,8 +971,13 @@ Input Commands that are Possibly Subject to Change 2. The name of the binding (as established above). 3. The key state as string (see below). 4. The key name (since mpv 0.15.0). + 5. The text the key would produce, or empty string if not applicable. - The key state consists of 2 letters: + The 5th argument is only set if no modifiers are present (using the shift + key with a letter is normally not emitted as having a modifier, and results + in upper case text instead, but some backends may mess up). + + The key state consists of 2 characters: 1. One of ``d`` (key was pressed down), ``u`` (was released), ``r`` (key is still down, and was repeated; only if key repeat is enabled for this @@ -980,6 +985,9 @@ Input Commands that are Possibly Subject to Change 2. Whether the event originates from the mouse, either ``m`` (mouse button) or ``-`` (something else). + Future versions can add more arguments and more key state characters to + support more input peculiarities. + ``ab-loop`` Cycle through A-B loop states. The first command will set the ``A`` point (the ``ab-loop-a`` property); the second the ``B`` point, and the third |