summaryrefslogtreecommitdiffstats
path: root/DOCS
diff options
context:
space:
mode:
authorwm4 <wm4@nowhere>2015-01-12 12:08:48 +0100
committerwm4 <wm4@nowhere>2015-01-12 12:08:48 +0100
commitfc95678d8d9bbd325c715c1660db918f35c164d2 (patch)
tree002c7864f625ee534a9374d823168384615c40eb /DOCS
parent2e531aaf1427b2d3f6182047d7a396636e0d9fd5 (diff)
downloadmpv-fc95678d8d9bbd325c715c1660db918f35c164d2.tar.bz2
mpv-fc95678d8d9bbd325c715c1660db918f35c164d2.tar.xz
x11: support XEmbed
Seems to work with GtkSocket and passing the gtk_socket_get_id() value via "wid" option to mpv. One caveat is that using <tab> to move input focus from mpv to GTK does not work. It seems we would have to interpret <tab> ourselves in this case. I'm not sure if we really should do this - it would probably require emulating some other typical conventions too. I'm not sure if an embedder could do something about this on the toolkit level, but in theory it would be possible, so leave it as is for now.
Diffstat (limited to 'DOCS')
-rw-r--r--DOCS/man/options.rst15
1 files changed, 9 insertions, 6 deletions
diff --git a/DOCS/man/options.rst b/DOCS/man/options.rst
index 106a233bd1..f2b646cbaf 100644
--- a/DOCS/man/options.rst
+++ b/DOCS/man/options.rst
@@ -2304,7 +2304,7 @@ Input
``--input-vo-keyboard=<yes|no>``
Disable all keyboard input on for VOs which can't participate in proper
- keyboard input dispatching. This currently affects X11. Generally useful for
+ keyboard input dispatching. May not affect all VOs. Generally useful for
embedding only.
On X11, a sub-window with input enabled grabs all keyboard input as long
@@ -2316,11 +2316,14 @@ Input
behavior, but naively embedding foreign windows breaks it.
The only way to handle this reasonably is using the XEmbed protocol, which
- was designed to solve these problems. But Qt has questionable support, and
- mpv doesn't implement it yet.
-
- As a workaround, this option is disabled by default in libmpv. (Note that
- ``input-default-bindings`` is disabled by default in libmpv as well.)
+ was designed to solve these problems. GTK provides ``GtkSocket``, which
+ supports XEmbed. Qt doesn't seem to provide anything working in newer
+ versions.
+
+ If the embedder supports XEmbed, input should work with default settings
+ and with this option disabled. Note that ``input-default-bindings`` is
+ disabled by default in libmpv as well - it should be enabled if you want
+ the mpv default key bindings.
(This option was renamed from ``--input-x11-keyboard``.)