From d9d128694e77f0b250ab39c1e85a0f5e6ed5872f Mon Sep 17 00:00:00 2001
From: SoSeDiK <mrsosedik@gmail.com>
Date: Mon, 8 Apr 2024 01:19:17 +0300
Subject: [PATCH] Per-window fullscreen opacity (#577)

---
 pages/Configuring/Using-hyprctl.md       |  2 ++
 pages/Configuring/Window-Rules.md        | 18 ++++++++++++------
 pages/Useful Utilities/Screen-Sharing.md |  2 +-
 3 files changed, 15 insertions(+), 7 deletions(-)

diff --git a/pages/Configuring/Using-hyprctl.md b/pages/Configuring/Using-hyprctl.md
index 931a7c9..db1ceb6 100644
--- a/pages/Configuring/Using-hyprctl.md
+++ b/pages/Configuring/Using-hyprctl.md
@@ -210,6 +210,8 @@ Prop List:
 | alpha | float 0.0 - 1.0 |
 | alphainactiveoverride | 0/1, makes the next setting be override instead of multiply |
 | alphainactive | float 0.0 - 1.0 |
+| alphafullscreenoverride | 0/1, makes the next setting be override instead of multiply |
+| alphafullscreen | float 0.0 - 1.0 |
 | activebordercolor | color, -1 means not set |
 | inactivebordercolor | color, -1 means not set |
 
diff --git a/pages/Configuring/Window-Rules.md b/pages/Configuring/Window-Rules.md
index 7e1b719..2ec5a17 100644
--- a/pages/Configuring/Window-Rules.md
+++ b/pages/Configuring/Window-Rules.md
@@ -132,7 +132,7 @@ Dynamic rules are re-evaluated every time a property changes.
 
 | Rule | Description |
 | ---- | ----------- |
-| opacity \[a\] | additional opacity multiplier. Options for a: `float` -> sets an opacity OR `float float` -> sets activeopacity and inactiveopacity respectively. You can also add `override` after an opacity to make it override instead of a multiplier. (e.g. `1.0 override 0.5 override`) |
+| opacity \[a\] | additional opacity multiplier. Options for a: `float` -> sets an overall opacity OR `float float` -> sets activeopacity and inactiveopacity respectively, OR `float float float` -> sets activeopacity, inactiveopacity and fullscreenopacity respectively. |
 | opaque | forces the window to be opaque (can be toggled with the toggleopaque dispatcher) |
 | forcergbx | makes hyprland ignore the alpha channel of all the window's surfaces, effectively making it _actually, fully 100% opaque_ |
 | animation \[style\] (\[opt\]) | forces an animation onto a window, with a selected opt. Opt is optional. |
@@ -188,7 +188,7 @@ windowrule = noblur,^(firefox)$ # disables blur for firefox
 windowrule = move cursor -50% -50%,^(kitty)$ # moves kitty to the center of the cursor
 windowrulev2 = bordercolor rgb(FF0000) rgb(880808),fullscreen:1 # set bordercolor to red if window is fullscreen
 windowrulev2 = bordercolor rgb(FFFF00),title:^(.*Hyprland.*)$ # set bordercolor to yellow when title contains Hyprland
-windowrule = opacity 1.0 override 0.5 override,^(kitty)$ # set opacity to 1.0 active and 0.5 inactive for kitty
+windowrule = opacity 1.0 override 0.5 override 0.8 override,^(kitty)$ # set opacity to 1.0 active, 0.5 inactive and 0.8 fullscreen for kitty
 windowrule = rounding 10,^(kitty)$ # set rounding to 10 for kitty
 windowrulev2 = stayfocused, class:^(pinentry-) # fix pinentry losing focus
 ```
@@ -209,8 +209,8 @@ windowrulev2 = opacity 0.8 0.8,class:^(kitty)$
 windowrulev2 = opacity 0.5 0.5,floating:1
 ```
 
--> all kitty windows will have opacity 0.8, except if they are floating. Then
-they will have opacity 0.5. -> all floating windows will have opacity 0.5.
+-> all non-fullscreen kitty windows will have opacity 0.8, except if they are floating. Then
+they will have opacity 0.5. -> all non-fullscreen floating windows will have opacity 0.5.
 
 ```ini
 windowrulev2 = opacity 0.5 0.5,floating:1
@@ -222,11 +222,17 @@ other floating windows will have opacity 0.5.
 
 {{< callout type=info >}}
 
-Opacity is _always_ a PRODUCT of all opacities. E.g. `active_opacity` to 0.5 and
+Opacity is a PRODUCT of all opacities by default. E.g. `active_opacity` to 0.5 and
 windowrule opacity to 0.5 will result in a total opacity 0.25. You are allowed
 to set opacities over 1, but any opacity product over 1 will cause graphical
 glitches. E.g. `0.5 * 2 = 1`, and it will be fine, `0.5 * 4` will cause
-graphical glitches.
+graphical glitches. You can use `override` after an opacity to make it override
+instead of a multiplier. E.g. to set active and inactive opacity to 0.8,
+and make fullscreen fully opaque regardless of other opacity rules:
+
+```ini
+windowrulev2 = opacity 0.8 override 0.8 override 1.0 override,^(kitty)$
+```
 
 {{< /callout >}}
 
diff --git a/pages/Useful Utilities/Screen-Sharing.md b/pages/Useful Utilities/Screen-Sharing.md
index 7e9c8ca..e568870 100644
--- a/pages/Useful Utilities/Screen-Sharing.md	
+++ b/pages/Useful Utilities/Screen-Sharing.md	
@@ -37,7 +37,7 @@ the same effect. See
 more information. For example:
 
 ```ini
-windowrulev2 = opacity 0.0 override 0.0 override,class:^(xwaylandvideobridge)$
+windowrulev2 = opacity 0.0 override,class:^(xwaylandvideobridge)$
 windowrulev2 = noanim,class:^(xwaylandvideobridge)$
 windowrulev2 = noinitialfocus,class:^(xwaylandvideobridge)$
 windowrulev2 = maxsize 1 1,class:^(xwaylandvideobridge)$