diff options
author | NRK <nrk@disroot.org> | 2022-11-22 21:42:30 +0600 |
---|---|---|
committer | Dudemanguy <random342@airmail.cc> | 2022-12-05 02:03:25 +0000 |
commit | 25b66256d7ff48254b2055a066e29f260414112f (patch) | |
tree | a650e5cbbfedfdffbffa723fd01a6388c723dd25 /DOCS | |
parent | 4574dd5dc6ff75b1fc693afceec59fbcd51ccd4c (diff) | |
download | mpv-25b66256d7ff48254b2055a066e29f260414112f.tar.bz2 mpv-25b66256d7ff48254b2055a066e29f260414112f.tar.xz |
player: add window-id property
currently only supported on x11.
one practical use-case of this is wanting to embed something (such as
dmenu) into the mpv window to use as a menu/selection. there might be
other use-cases as well (e.g doing some shenanigans with `xdotool` or
whatnot).
it's currently possible to:
* listen for 'current-window-scale' change (to check if the
window has been created or not)
* call an external tool like `xdo` or `xdotool` and grab the xid
from mpv's pid.
however it adds unnecessary dependency on external tools when mpv is
fully capable of easily providing this information.
closes: #10918
Diffstat (limited to 'DOCS')
-rw-r--r-- | DOCS/man/input.rst | 4 |
1 files changed, 4 insertions, 0 deletions
diff --git a/DOCS/man/input.rst b/DOCS/man/input.rst index 9e9557afd5..e11beae92c 100644 --- a/DOCS/man/input.rst +++ b/DOCS/man/input.rst @@ -2652,6 +2652,10 @@ Property list Any of these properties may be unavailable or set to dummy values if the VO window is not created or visible. +``window-id`` + Read-only - mpv's window id. May not always be available, i.e due to window + not being opened yet or not being supported by the VO. + ``mouse-pos`` Read-only - last known mouse position, normalizd to OSD dimensions. |