mirror of
https://github.com/wez/wezterm.git
synced 2025-01-04 11:42:53 +03:00
76 lines
2.1 KiB
Markdown
76 lines
2.1 KiB
Markdown
# `window:set_config_overrides(overrides)`
|
|
|
|
{{since('20210314-114017-04b7cedd')}}
|
|
|
|
Changes the set of configuration overrides for the window.
|
|
The config file is re-evaluated and any CLI overrides are
|
|
applied, followed by the keys and values from the `overrides`
|
|
parameter.
|
|
|
|
This can be used to override configuration on a per-window basis;
|
|
this is only useful for options that apply to the GUI window, such
|
|
as rendering the GUI.
|
|
|
|
Each call to `window:set_config_overrides` will emit the
|
|
[window-config-reloaded](../window-events/window-config-reloaded.md) event for
|
|
the window. If you are calling this method from inside the handler
|
|
for `window-config-reloaded` you should take care to only call `window:set_config_overrides`
|
|
if the actual override values have changed to avoid a loop.
|
|
|
|
In this example, a key assignment (`CTRL-SHIFT-E`) is used to toggle the use of
|
|
ligatures in the current window:
|
|
|
|
```lua
|
|
local wezterm = require 'wezterm'
|
|
|
|
wezterm.on('toggle-ligature', function(window, pane)
|
|
local overrides = window:get_config_overrides() or {}
|
|
if not overrides.harfbuzz_features then
|
|
-- If we haven't overridden it yet, then override with ligatures disabled
|
|
overrides.harfbuzz_features = { 'calt=0', 'clig=0', 'liga=0' }
|
|
else
|
|
-- else we did already, and we should disable out override now
|
|
overrides.harfbuzz_features = nil
|
|
end
|
|
window:set_config_overrides(overrides)
|
|
end)
|
|
|
|
return {
|
|
keys = {
|
|
{
|
|
key = 'E',
|
|
mods = 'CTRL',
|
|
action = wezterm.action.EmitEvent 'toggle-ligature',
|
|
},
|
|
},
|
|
}
|
|
```
|
|
|
|
In this example, a key assignment (`CTRL-SHIFT-B`) is used to toggle opacity
|
|
for the window:
|
|
|
|
```lua
|
|
local wezterm = require 'wezterm'
|
|
|
|
wezterm.on('toggle-opacity', function(window, pane)
|
|
local overrides = window:get_config_overrides() or {}
|
|
if not overrides.window_background_opacity then
|
|
overrides.window_background_opacity = 0.5
|
|
else
|
|
overrides.window_background_opacity = nil
|
|
end
|
|
window:set_config_overrides(overrides)
|
|
end)
|
|
|
|
return {
|
|
keys = {
|
|
{
|
|
key = 'B',
|
|
mods = 'CTRL',
|
|
action = wezterm.action.EmitEvent 'toggle-opacity',
|
|
},
|
|
},
|
|
}
|
|
```
|
|
|