@@ -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