From 364463feaf89fa0b7ad82f15af6576400b6daec4 Mon Sep 17 00:00:00 2001 From: Yuxuan Shui Date: Tue, 17 Jan 2023 02:56:28 +0000 Subject: [PATCH] doc: list cases that trigger unredirect unredir-if-possible doesn't just happen for fullscreen windows, be more accurate. Signed-off-by: Yuxuan Shui --- man/picom.1.asciidoc | 8 +++++++- 1 file changed, 7 insertions(+), 1 deletion(-) diff --git a/man/picom.1.asciidoc b/man/picom.1.asciidoc index b4ff69b6..fdf0198d 100644 --- a/man/picom.1.asciidoc +++ b/man/picom.1.asciidoc @@ -134,7 +134,13 @@ OPTIONS Use EWMH '_NET_ACTIVE_WINDOW' to determine currently focused window, rather than listening to 'FocusIn'/'FocusOut' event. Might have more accuracy, provided that the WM supports it. *--unredir-if-possible*:: - Unredirect all windows if a full-screen opaque window is detected, to maximize performance for full-screen windows. Known to cause flickering when redirecting/unredirecting windows. + Unredirect all windows in some cases. Known to cause flickering when redirecting/unredirecting windows. Currently, unredirecting is triggered by following conditions: + * If the top level window is taking up the entire screen. In multi-monitor setup, this means ALL monitors. + * If there is no window. + * If a window is fullscreen according to its WM hints. (can be disabled with *--no-ewmh-fullscreen*). + * If a window requests to bypass the compositor ('_NET_WM_BYPASS_COMPOSITOR'). + Windows are also unredirected unconditionally when monitors are powered off, regardless if *--unredir-if-possible* is set. + *--unredir-if-possible-delay* 'MILLISECONDS':: Delay before unredirecting the window, in milliseconds. Defaults to 0.