@@ -3738,13 +3738,25 @@ Window
3738
3738
On win32, the ID is interpreted as ``HWND ``. Pass it as value cast to
3739
3739
``uint32_t `` (all Windows handles are 32-bit), this is important as mpv will
3740
3740
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.
3742
3744
3743
3745
On Android, the ID is interpreted as ``android.view.Surface ``. Pass it as a
3744
3746
value cast to ``intptr_t ``. Use with ``--vo=mediacodec_embed `` and
3745
3747
``--hwdec=mediacodec `` for direct rendering using MediaCodec, or with
3746
3748
``--vo=gpu --gpu-context=android `` (with or without ``--hwdec=mediacodec ``).
3747
3749
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
+
3748
3760
``--window-dragging=<yes|no> ``
3749
3761
Move the window when clicking on it and moving the mouse pointer (default: yes).
3750
3762
0 commit comments