mirror of
https://github.com/kovidgoyal/kitty
synced 2026-07-07 17:43:53 +02:00
68 lines
2.5 KiB
Python
68 lines
2.5 KiB
Python
#!/usr/bin/env python
|
|
# License: GPLv3 Copyright: 2020, Kovid Goyal <kovid at kovidgoyal.net>
|
|
|
|
|
|
from typing import TYPE_CHECKING, Optional
|
|
|
|
from .base import (
|
|
MATCH_TAB_OPTION,
|
|
MATCH_WINDOW_OPTION,
|
|
ArgsType,
|
|
Boss,
|
|
OpacityError,
|
|
PayloadGetType,
|
|
PayloadType,
|
|
RCOptions,
|
|
RemoteCommand,
|
|
ResponseType,
|
|
Window,
|
|
)
|
|
|
|
if TYPE_CHECKING:
|
|
from kitty.cli_stub import SetBackgroundOpacityRCOptions as CLIOptions
|
|
|
|
|
|
class SetBackgroundOpacity(RemoteCommand):
|
|
|
|
protocol_spec = __doc__ = '''
|
|
opacity+/float: A number between 0.1 and 1
|
|
match_window/str: Window to change opacity in
|
|
match_tab/str: Tab to change opacity in
|
|
all/bool: Boolean indicating operate on all windows
|
|
'''
|
|
|
|
short_desc = 'Set the background opacity'
|
|
desc = (
|
|
'Set the background opacity for the specified windows. This will only work if you have turned on'
|
|
' :opt:`dynamic_background_opacity` in :file:`kitty.conf`. The background opacity affects all kitty windows in a'
|
|
' single OS window. For example::\n\n'
|
|
' kitty @ set-background-opacity 0.5'
|
|
)
|
|
options_spec = '''\
|
|
--all -a
|
|
type=bool-set
|
|
By default, background opacity are only changed for the currently active window. This option will
|
|
cause background opacity to be changed in all windows.
|
|
|
|
''' + '\n\n' + MATCH_WINDOW_OPTION + '\n\n' + MATCH_TAB_OPTION.replace('--match -m', '--match-tab -t')
|
|
args = RemoteCommand.Args(spec='OPACITY', count=1, json_field='opacity', special_parse='parse_opacity(args[0])')
|
|
|
|
def message_to_kitty(self, global_opts: RCOptions, opts: 'CLIOptions', args: ArgsType) -> PayloadType:
|
|
opacity = max(0.1, min(float(args[0]), 1.0))
|
|
return {
|
|
'opacity': opacity, 'match_window': opts.match,
|
|
'all': opts.all, 'match_tab': opts.match_tab
|
|
}
|
|
|
|
def response_from_kitty(self, boss: Boss, window: Optional[Window], payload_get: PayloadGetType) -> ResponseType:
|
|
from kitty.fast_data_types import get_options
|
|
if not get_options().dynamic_background_opacity:
|
|
raise OpacityError('You must turn on the dynamic_background_opacity option in kitty.conf to be able to set background opacity')
|
|
windows = self.windows_for_payload(boss, window, payload_get)
|
|
for os_window_id in {w.os_window_id for w in windows if w}:
|
|
boss._set_os_window_background_opacity(os_window_id, payload_get('opacity'))
|
|
return None
|
|
|
|
|
|
set_background_opacity = SetBackgroundOpacity()
|