Skip to content

Commit

Permalink
new blur stuff
Browse files Browse the repository at this point in the history
  • Loading branch information
vaxerski committed Aug 3, 2023
1 parent 2888304 commit 7548311
Showing 1 changed file with 36 additions and 29 deletions.
65 changes: 36 additions & 29 deletions pages/Configuring/Variables.md
Original file line number Diff line number Diff line change
Expand Up @@ -79,12 +79,6 @@ Prefer using `input:sensitivity` over `general:sensitivity` to avoid bugs, espec
| active_opacity | opacity of active windows. (0.0 - 1.0) | float | 1.0 |
| inactive_opacity | opacity of inactive windows. (0.0 - 1.0) | float | 1.0 |
| fullscreen_opacity | opacity of fullscreen windows. (0.0 - 1.0) | float | 1.0 |
| blur | enable kawase window background blur | bool | true |
| blur_size | blur size (distance) | int | 8 |
| blur_passes | the amount of passes to perform | int | 1 |
| blur_ignore_opacity | make the blur layer ignore the opacity of the window | bool | false |
| blur_new_optimizations | whether to enable further optimizations to the blur. Recommended to leave on, as it will massively improve performance. | bool | true |
| blur_xray | if enabled, floating windows will ignore tiled windows in their blur. Only available if blur_new_optimizations is true. Will reduce overhead on floating blur significantly. | bool | false |
| drop_shadow | enable drop shadows on windows | bool | true |
| shadow_range | Shadow range ("size") in layout px | int | 4 |
| shadow_render_power | (1 - 4), in what power to render the falloff (more power, the faster the falloff) | int | 3 |
Expand All @@ -99,14 +93,45 @@ Prefer using `input:sensitivity` over `general:sensitivity` to avoid bugs, espec
| dim_around | how much the `dimaround` window rule should dim by. 0.0 - 1.0 | float | 0.4 |
| screen_shader | a path to a custom shader to be applied at the end of rendering. See `examples/screenShader.frag` for an example. | str | \[\[Empty\]\] |

{{< hint type=info >}}
## Blur
_subcategory decoration:blur:_

`blur_size` and `blur_passes` have to be at least 1.
| name | description | type | default |
|---|---|---|---|
| enabled | enable kawase window background blur | bool | true |
| size | blur size (distance) | int | 8 |
| passes | the amount of passes to perform | int | 1 |
| ignore_opacity | make the blur layer ignore the opacity of the window | bool | false |
| new_optimizations | whether to enable further optimizations to the blur. Recommended to leave on, as it will massively improve performance. | bool | true |
| xray | if enabled, floating windows will ignore tiled windows in their blur. Only available if blur_new_optimizations is true. Will reduce overhead on floating blur significantly. | bool | false |
| noise | how much noise to apply. 0.0 - 1.0 | float | 0.0117 |
| contrast | contrast modulation for blur. 0.0 - 2.0 | float | 0.8916 |
| brightness | brightness modulation for blur. 0.0 - 2.0 | float | 0.8172 |

Increasing `blur_passes` is necessary to prevent blur looking wrong on higher `blur_size` values,
but remember that higher `blur_passes` will require more strain on the GPU.
{{< hint type=important >}}
A subcategory is a nested category:

```ini
decoration {
# ...
# ...

It will, however, cause zero overhead on tiled windows if using `blur_new_optimizations`.
blur {
# ...
# ...
}
}
```

Doing `decoration:blur {` is **invalid**!
{{< /hint >}}

{{< hint type=info >}}

`blur:size` and `blur:passes` have to be at least 1.

Increasing `blur:passes` is necessary to prevent blur looking wrong on higher `blur:size` values,
but remember that higher `blur:passes` will require more strain on the GPU.

{{< /hint >}}

Expand Down Expand Up @@ -194,24 +219,6 @@ _Subcategory `input:touchpad:`_
| drag_lock | When enabled, lifting the finger off for a short time while dragging will not drop the dragged item. [libinput#tap-and-drag](https://wayland.freedesktop.org/libinput/doc/latest/tapping.html#tap-and-drag) | bool | false |
| tap-and-drag | Sets the tap and drag mode for the touchpad | bool | false |

{{< hint type=important >}}
A subcategory is a nested category:

```ini
input {
# ...
# ...

touchpad {
# ...
# ...
}
}
```

Doing `input:touchpad {` is **invalid**!
{{< /hint >}}

## Touchdevice

_Subcategory `input:touchdevice:`_
Expand Down

0 comments on commit 7548311

Please sign in to comment.