doc: foot.ini: try to clear up the meaning of (AA)RRGGBB

This commit is contained in:
Daniel Eklöf 2021-11-13 17:22:07 +01:00
parent c0e67e7c2f
commit 0d2a429109
No known key found for this signature in database
GPG key ID: 5BBD4992C116573F

View file

@ -418,11 +418,14 @@ applications can change these at runtime.
by applications. Default: _no_. by applications. Default: _no_.
*color* *color*
Two RRGGBB values specifying the foreground (text) and background Two RRGGBB values (i.e. plain old 6-digit hex values, without
(cursor) colors for the cursor. Default: inversed foreground and prefix) specifying the foreground (text) and background (cursor)
background colors. Note that this value only applies to the block colors for the cursor.
cursor. The other cursor styles are always rendered with the
foreground color. Default: inversed foreground and background colors.
Note that this value only applies to the block cursor. The other
cursor styles are always rendered with the foreground color.
*beam-thickness* *beam-thickness*
Thickness (width) of the beam styled cursor. The value is in Thickness (width) of the beam styled cursor. The value is in
@ -470,21 +473,21 @@ applications can change these at runtime.
# SECTION: colors # SECTION: colors
This section controls the 16 ANSI colors, the default foreground This section controls the 16 ANSI colors, the default foreground and
and background colors, and the extended 256 color palette. Note that background colors, and the extended 256 color palette. Note that
applications can change these at runtime. applications can change these at runtime.
The colors are in RRGGBB format. That is, they do *not* have an alpha The colors are in RRGGBB format (i.e. plain old 6-digit hex values,
component. You can configure the background transparency with the without prefix). That is, they do *not* have an alpha component. You
_alpha_ option. can configure the background transparency with the _alpha_ option.
*foreground* *foreground*
Default RRGGBB foreground color. This is the color used when no Default foreground color. This is the color used when no ANSI
ANSI color is being used. Default: _dcdccc_. color is being used. Default: _dcdccc_.
*background* *background*
Default RRGGBB background color. This is the color used when no Default background color. This is the color used when no ANSI
ANSI color is being used. Default: _111111_. color is being used. Default: _111111_.
*regular0*, *regular1* *..* *regular7* *regular0*, *regular1* *..* *regular7*
The eight basic ANSI colors. Default: _222222_, _cc9393_, The eight basic ANSI colors. Default: _222222_, _cc9393_,
@ -512,12 +515,12 @@ _alpha_ option.
used. Default: _inverse foreground/background_. used. Default: _inverse foreground/background_.
*jump-labels* *jump-labels*
To RRGGBB values specifying the foreground (text) and background To color values specifying the foreground (text) and background
colors to use when rendering jump labels in URL mode. Default: colors to use when rendering jump labels in URL mode. Default:
_regular0 regular3_. _regular0 regular3_.
*scrollback-indicator* *scrollback-indicator*
Two RRGGBB values specifying the foreground (text) and background Two color values specifying the foreground (text) and background
(indicator itself) colors for the scrollback indicator. (indicator itself) colors for the scrollback indicator.
Default: first regular color (black) for foreground, Default: first regular color (black) for foreground,
@ -536,8 +539,16 @@ to use _SSDs_ (Server Side Decorations) when the compositor supports
it. it.
Note that unlike the colors defined in the _colors_ section, the color Note that unlike the colors defined in the _colors_ section, the color
values here are in AARRGGBB format. I.e. they contain an alpha values here are in AARRGGBB (i.e. plain old 8-digit hex values)
component. format. I.e. they contain an alpha component - 00 means completely
transparent, and ff fully opaque.
Examples:
- ffffffff: white, fully opaque
- ff000000: black, fully opaque
- 7fffffff: white, semi-transparent
- ff00ff00: green, fully opaque
*preferred* *preferred*
Which type of window decorations to prefer: *client* (CSD), Which type of window decorations to prefer: *client* (CSD),
@ -555,8 +566,7 @@ component.
titlebar. Default: _26_. titlebar. Default: _26_.
*color* *color*
Titlebar AARRGGBB color. Default: use the default _foreground_ Titlebar color. Default: use the default _foreground_ color.
color.
*font* *font*
Font to use for the title bar. This is a list of fonts, similar to Font to use for the title bar. This is a list of fonts, similar to
@ -570,10 +580,9 @@ component.
bar. Default: _0_. bar. Default: _0_.
*border-color* *border-color*
Color of border, on the format AARRGGBB. By default, the title bar Color of border. By default, the title bar color is used. If the
color is used. If the title bar color has not been set, the title bar color has not been set, the default foreground color
default foreground color (from the color scheme) is used. Default: (from the color scheme) is used. Default: _titlebar color_.
_titlebar color_.
*button-width* *button-width*
Width, in pixels (subject to output scaling), of the Width, in pixels (subject to output scaling), of the
@ -584,16 +593,16 @@ component.
use the default _background_ color. use the default _background_ color.
*button-minimize-color* *button-minimize-color*
Minimize button's background color, on the format Minimize button's background color. Default: use the default
AARRGGBB. Default: use the default _regular4_ color (blue). _regular4_ color (blue).
*button-maximize-color* *button-maximize-color*
Maximize button's background color, on the format Maximize button's background color. Default: use the default
AARRGGBB. Default: use the default _regular2_ color (green). _regular2_ color (green).
*button-close-color* *button-close-color*
Close button's background color, on the format AARRGGBB. Default: Close button's background color. Default: use the default
use the default _regular1_ color (red). _regular1_ color (red).
# SECTION: key-bindings # SECTION: key-bindings