wiki: Emphasize non-xray warnings

This commit is contained in:
Ivan Molodetskikh
2026-04-18 12:02:25 +03:00
parent ce9dd33213
commit f4ebbc8017
2 changed files with 8 additions and 4 deletions
+3
View File
@@ -944,6 +944,9 @@ See the [window effects page](./Window-Effects.md) for an overview of background
```kdl
// Make floating windows use the regular blur (if enabled),
// while tiled windows keep using the efficient xray blur.
//
// Warning: non-xray blur is currently experimental and has known limitations.
// In particular, it doesn't work during window opening and closing animations.
window-rule {
match is-floating=true
+5 -4
View File
@@ -62,10 +62,11 @@ You can disable xray with `xray false` background effect window rule.
This gives you the normal kind of blur where everything below a window is blurred.
Keep in mind that non-xray blur and other non-xray effects are more expensive as niri has to recompute them any time you move the window, or the contents underneath change.
Non-xray effects are currently experimental because they have some known limitations.
- They disappear during window open/close animations and while dragging a tiled window.
Fixing this requries a refactor to the niri rendering code to defer offscreen rendering, and possibly other refactors.
> [!WARNING]
> Non-xray effects are currently experimental because they have some known limitations.
>
> - They disappear during window open/close animations and while dragging a tiled window.
> Fixing this requries a refactor to the niri rendering code to defer offscreen rendering, and possibly other refactors.
### Implementation notes