DOCS/man/input.rst: clarify hexadecimal key names

Document the syntax and mention how it can be used as Unicode
codepoints. ASCII range has worked since the feature was inplemented
in 86a87de590 and Unicode range has
worked since a63e880400.

It also works with known special keys if you know the internal values
of keys because there is no filtering in place, but this should not be
encouraged.
This commit is contained in:
nanahi
2024-12-14 12:36:51 -05:00
committed by Dudemanguy
parent 269e402579
commit 1107bdb62e

View File

@@ -120,10 +120,12 @@ is followed by a ``+`` (for example ``ctrl+q``).
Symbolic key names and modifier names are case-insensitive. Unicode key names
are case-sensitive just like how keyboard text input would produce.
Another type of key names are hexadecimal key names, that serve as fallback
for special keys that are neither unicode, nor have a special mpv defined name.
They will break as soon as mpv adds proper names for them, but can enable you
to use a key at all if that does not happen.
Another type of key names are hexadecimal key names, which start with ``0x``,
followed by the hexadecimal value of the key. The hexadecimal value can be
either a Unicode code point value, or can serve as fallback for special keys
that do not have a special mpv defined name. They will break as soon as mpv
adds proper names for them, but can enable you to use a key at all if that
does not happen.
All symbolic names are listed by ``--input-keylist``. ``--input-test`` is a
special mode that prints all input on the OSD.