You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: docs/wiki/Window-Effects.md
+16Lines changed: 16 additions & 0 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -62,3 +62,19 @@ Non-xray effects are currently experimental because they have some known limitat
62
62
63
63
- They disappear during window open/close animations and while dragging a tiled window.
64
64
Fixing this requries a refactor to the niri rendering code to defer offscreen rendering, and possibly other refactors.
65
+
66
+
### Implementation notes
67
+
68
+
The `ext-background-effect` protocol supports any wl_surface.
69
+
We currently implement it only for toplevels, layer surfaces, and pop-ups, which should cover the vast majority of what's actually used by applications.
70
+
71
+
For pop-ups, effects default to *non-xray* because pop-ups generally appear on top of windows.
72
+
73
+
In particular, the following surface types don't support `ext-background-effect`.
74
+
They can be implemented as the need arises.
75
+
76
+
- Subsurfaces. Would require implementing `clip-to-geometry` support for background effects.
77
+
- Lock surfaces. Not useful as it would just show our red locked session background.
78
+
- Cursor and drag-and-drop icon.
79
+
The main challenge here will be screencasts where the cursor is rendered separately.
80
+
This is problematic because non-xray effects require rendering the whole scene in one go rather than separately.
0 commit comments