Skip to content

Commit

Permalink
doc: list cases that trigger unredirect
Browse files Browse the repository at this point in the history
unredir-if-possible doesn't just happen for fullscreen windows, be more
accurate.

Signed-off-by: Yuxuan Shui <yshuiv7@gmail.com>
  • Loading branch information
yshui committed Jan 17, 2023
1 parent 1926b6d commit 364463f
Showing 1 changed file with 7 additions and 1 deletion.
8 changes: 7 additions & 1 deletion man/picom.1.asciidoc
Original file line number Diff line number Diff line change
Expand Up @@ -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.
Expand Down

0 comments on commit 364463f

Please sign in to comment.