summaryrefslogtreecommitdiff
path: root/docs/config.md
diff options
context:
space:
mode:
Diffstat (limited to 'docs/config.md')
-rw-r--r--docs/config.md20
1 files changed, 18 insertions, 2 deletions
diff --git a/docs/config.md b/docs/config.md
index ebedc4d0..96281cd5 100644
--- a/docs/config.md
+++ b/docs/config.md
@@ -129,7 +129,7 @@ such a shell there when it is the column's only one and nobody has typed
into it (no scrollback, cursor still on the first prompt line), the boot's
placeholder giving its rows to the document. Bare `BootShell` flips it, as
bare `Placement` does: a setting that chooses among words (`on`/`off`
-switches, `Placement`, `BootShell`, `Crt`, `Lift`, `Motion`,
+switches, `Placement`, `BootShell`, `Crt`, `Bloom`, `Vignette`, `Grain`, `Lift`, `Motion`,
`ShaderAnimation`) steps to its
next value when written bare, as its word clicked in a tag does, and a value
it does not take is refused with the values it takes, which `/commands` also
@@ -144,7 +144,7 @@ colour whole by half way (graphical frontends slide it out from under the
tagline as it fades up; a terminal only fades it in), stays until the next key or click as it
always has, then lingers for `MessageLinger` milliseconds (default 800) before
it dissolves into the page. `MessageFall` (default 180) and `MessageDissolve`
-(default 300) set how long the fall and the dissolve take, also in
+(default 150: leaving is quicker than arriving) set how long the fall and the dissolve take, also in
milliseconds; each timing is at most 60000, and `Config` reports all three. `MessageLinger 0` with
`MessageAnimation off` restores the old behaviour, a message cleared by the
very input that follows it. An updated line on a row already showing one swaps
@@ -549,6 +549,20 @@ the chain empty the pass is bypassed. CRT works in linear light with restrained
scanlines, mask, bloom and vignette, and no curvature, so clicks land where
they are drawn.
+Three more bundled passes take the same levels, each off by default and
+each costing nothing while off:
+
+```text
+Bloom 2 the brightest ink glows a little (only what is brighter than
+ the page; a dual Kawase blur at half size and down)
+Vignette 2 the window's corners fall a little into shade
+Grain 2 the page's own ground takes a fine, still grain, like paper
+```
+
+None of them touches a tag, a grip, a notice or the cursor, and each is
+capped per theme so text and the selection keep their own contrast or 4.5
+(docs/effects.md).
+
The focused pane can stand off the page (SDL GUI, off by default):
```text
@@ -558,6 +572,8 @@ Lift auto a shadow on a light page; on a dark one the others recede
Lift off
InactiveDim 30 the unfocused panes' text fades 30% toward its ground
Motion smooth off, crisp, smooth (the default), bouncy or playful
+SelectionGlow on a soft halo of the selection's colour round it in the body,
+ fading in over 100 ms, never over a tag, a grip or the cursor
CursorBlink on the cursor blinks, solid while typing and half a second
after, eased at each edge, solid after 10 idle seconds
GripWidth 150 the grip's button and the scrollbar under it, percent of the