mirror of
https://github.com/wez/wezterm.git
synced 2024-11-22 04:56:12 +03:00
docs: win32_system_backdrop
refs: #3528 refs: https://github.com/wez/wezterm/issues/1614
This commit is contained in:
parent
163dfd7d9a
commit
38da9d7e51
@ -24,6 +24,7 @@ As features stabilize some brief notes about them will accumulate here.
|
||||
#### New
|
||||
|
||||
* [window:keyboard_modifiers](config/lua/window/keyboard_modifiers.md) #3444
|
||||
* [win32_system_backdrop](config/lua/config/win32_system_backdrop.md). Thanks to @kingavatar! #3528 #1614
|
||||
|
||||
#### Fixed
|
||||
|
||||
|
@ -22,3 +22,6 @@ config.macos_window_background_blur = 20
|
||||
![Screenshot](../../../screenshots/wezterm-macos-background-blur.png)
|
||||
|
||||
The default value for `macos_window_background_blur` is `0`.
|
||||
|
||||
See also [win32_system_backdrop](win32_system_backdrop.md) for a similar
|
||||
effect on Windows.
|
||||
|
14
docs/config/lua/config/win32_acrylic_accent_color.md
Normal file
14
docs/config/lua/config/win32_acrylic_accent_color.md
Normal file
@ -0,0 +1,14 @@
|
||||
---
|
||||
tags:
|
||||
- appearance
|
||||
---
|
||||
|
||||
# `win32_acrylic_accent_color = COLOR`
|
||||
|
||||
{{since('nightly')}}
|
||||
|
||||
When combined with `win32_system_backdrop = "Acrylic"` on Windows systems
|
||||
earlier than build 22621, this option specifies the accent color used with
|
||||
the *Acrylic* composition effect.
|
||||
|
||||
See also [win32_system_backdrop](win32_system_backdrop.md).
|
62
docs/config/lua/config/win32_system_backdrop.md
Normal file
62
docs/config/lua/config/win32_system_backdrop.md
Normal file
@ -0,0 +1,62 @@
|
||||
---
|
||||
tags:
|
||||
- appearance
|
||||
---
|
||||
|
||||
# `win32_system_backdrop = SETTING`
|
||||
|
||||
{{since('nightly')}}
|
||||
|
||||
When combined with `window_background_opacity`, chooses from available
|
||||
window background effects provided by Windows.
|
||||
|
||||
The possible values for `win32_system_backdrop` are:
|
||||
|
||||
* `"Auto"` - the system chooses. In practice, this is the same as `"Disable"`. This is the default value.
|
||||
* `"Disable"` - disable backdrop effects.
|
||||
* `"Acrylic"` - enable the *Acrylic* blur-behind-window effect. Available on Windows 10 and 11.
|
||||
* `"Mica"` - enable the *Mica* effect, available on Windows 11 build 22621 and later.
|
||||
* `"Tabbed"` - enable the *Tabbed* effect, available on Windows 11 build 22621 and later.
|
||||
|
||||
On Windows systems earlier than build 22621, the *Acrylic* affect can be
|
||||
adjusted using [win32_acrylic_accent_color](win32_acrylic_accent_color.md).
|
||||
More recent versions of Windows do not permit configuring the accent color
|
||||
for *Acrylic*, so that option has no effect there.
|
||||
|
||||
The *Acrylic* setting uses more resources than the others.
|
||||
|
||||
You need to reduce the `window_background_opacity` to a value lower than `1.0`
|
||||
for the backdrop effect to work. For best results with both `"Mica"` and
|
||||
`"Tabbed"`, setting `window_background_opacity = 0` is recommended.
|
||||
|
||||
See also [macos_window_background_blur](macos_window_background_blur.md) for
|
||||
a similar effect on macOS.
|
||||
|
||||
## Acrylic
|
||||
|
||||
```lua
|
||||
config.window_background_opacity = 0
|
||||
config.win32_system_backdrop = 'Acrylic'
|
||||
```
|
||||
|
||||
![Acrylic Effect](../../../screenshots/wezterm-acrylic.png)
|
||||
|
||||
## Mica
|
||||
|
||||
```lua
|
||||
config.window_background_opacity = 0
|
||||
config.win32_system_backdrop = 'Mica'
|
||||
```
|
||||
|
||||
![Mica Effect](../../../screenshots/wezterm-mica.png)
|
||||
|
||||
## Tabbed
|
||||
|
||||
```lua
|
||||
config.window_background_opacity = 0
|
||||
config.win32_system_backdrop = 'Tabbed'
|
||||
```
|
||||
|
||||
![Tabbed Effect](../../../screenshots/wezterm-tabbed.png)
|
||||
|
||||
|
BIN
docs/screenshots/wezterm-acrylic.png
Normal file
BIN
docs/screenshots/wezterm-acrylic.png
Normal file
Binary file not shown.
After Width: | Height: | Size: 223 KiB |
BIN
docs/screenshots/wezterm-mica.png
Normal file
BIN
docs/screenshots/wezterm-mica.png
Normal file
Binary file not shown.
After Width: | Height: | Size: 92 KiB |
BIN
docs/screenshots/wezterm-tabbed.png
Normal file
BIN
docs/screenshots/wezterm-tabbed.png
Normal file
Binary file not shown.
After Width: | Height: | Size: 131 KiB |
Loading…
Reference in New Issue
Block a user