Skip to content

Commit 77dee9b

Browse files
na-na-hikasper93
authored andcommitted
DOCS/man/options: add usage note for --wid=0 for win32
1 parent 7a5ecf1 commit 77dee9b

File tree

1 file changed

+13
-1
lines changed

1 file changed

+13
-1
lines changed

DOCS/man/options.rst

Lines changed: 13 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -3738,13 +3738,25 @@ Window
37383738
On win32, the ID is interpreted as ``HWND``. Pass it as value cast to
37393739
``uint32_t`` (all Windows handles are 32-bit), this is important as mpv will
37403740
not accept negative values. mpv will create its own window and set the
3741-
wid window as parent, like with X11.
3741+
wid window as parent, like with X11. The value ``0`` is interpreted
3742+
specially, and mpv will draw on top of the desktop wallpaper and below
3743+
desktop icons.
37423744

37433745
On Android, the ID is interpreted as ``android.view.Surface``. Pass it as a
37443746
value cast to ``intptr_t``. Use with ``--vo=mediacodec_embed`` and
37453747
``--hwdec=mediacodec`` for direct rendering using MediaCodec, or with
37463748
``--vo=gpu --gpu-context=android`` (with or without ``--hwdec=mediacodec``).
37473749

3750+
.. note::
3751+
3752+
On win32, if desktop wallpaper transition occurs (e.g. setting desktop
3753+
slideshow of multiple images in Windows settings) and an ID value ``0``
3754+
is used, Windows may sometimes destroy the window mpv is attached to.
3755+
mpv will simply treat this as a quit signal in this case.
3756+
3757+
To prevent this from happening, set a static desktop wallpaper,
3758+
such as single image or pure color.
3759+
37483760
``--window-dragging=<yes|no>``
37493761
Move the window when clicking on it and moving the mouse pointer (default: yes).
37503762

0 commit comments

Comments
 (0)