summaryrefslogtreecommitdiff
path: root/docs/macos.md
diff options
context:
space:
mode:
Diffstat (limited to 'docs/macos.md')
-rw-r--r--docs/macos.md34
1 files changed, 3 insertions, 31 deletions
diff --git a/docs/macos.md b/docs/macos.md
index 9b8f82ec..d767dce2 100644
--- a/docs/macos.md
+++ b/docs/macos.md
@@ -722,18 +722,12 @@ A theme with `bg = null` — the curated `dark`, and every vendored
`*_transparent` — declares no background of its own. In a terminal that means
"wear whatever the terminal is wearing"; a window has nothing to wear, so
`pardes_theme_bg` answers `PARDES_COLOR_DEFAULT` and the host goes see-through:
-`window.isOpaque = false`, a clear background colour, and an
-`NSVisualEffectView` (`.underWindowBackground`, `.behindWindow`, `.active`)
-behind the grid when `WindowBlur` is enabled. `PardesView` stops painting the ground at all — it *clears*,
+`window.isOpaque = false` and a clear background colour. `PardesView` stops painting the ground at all — it *clears*,
because AppKit does not blank a non-opaque view — and any cell whose background
is still the default resolves to `bgClear` and is skipped by the run loop.
Reversed cells are not: a reverse puts the text colour in the background, and
text is a real colour that paints.
-The blur is a **sibling** of the grid inside a plain container, never its
-parent. Hiding a superview hides its subviews, so a nested backdrop drew a
-blank window for every opaque theme the moment it was hidden.
-
`WindowOpacity <0..100>` sets one background coverage throughout the frame.
Background fills replace existing coverage, so overlapping ground, cell, tag
and context layers cannot increase the requested opacity. The window itself
@@ -741,7 +735,7 @@ stays clear below 100%; a second tinted window backdrop would compound it.
Text and cursor ink stay opaque. PDFs render onto a transparent MuPDF pixmap,
which preserves the coverage of text, paths, photos, and highlights. The host
paints paper at `WindowOpacity`, then composites PDF content at its original
-opacity. Blank paper therefore reveals the blurred backdrop while lettering
+opacity. Blank paper therefore reveals the desktop while lettering
stays readable even at `WindowOpacity 0`. Paper is white with `PdfTint` disabled
and uses the theme background otherwise. Explicit PDF background rectangles
and scanned page images remain content: this does not guess paper from pixel
@@ -753,30 +747,8 @@ destination by source coverage, then add the image at the requested opacity.
Theme colours and attachment rasters are interpreted as sRGB. The PDF paper
separation is currently macOS-specific; other hosts keep the opaque raster path.
-`WindowBlur <0..100>` controls the strength of that native backdrop independently
-of `WindowOpacity`. It is a macOS-only builtin, also accepted in the startup
-config and reported by `DumpConfig`. It defaults to 0 (off); 100 shows the full
-AppKit material and intermediate values blend the material with the unblurred
-backdrop using the effect view's alpha. An opaque themed background hides the
-effect; lowering `WindowOpacity` makes the remembered strength visible again.
-For example:
-
-```text
-WindowOpacity 71
-WindowBlur 60
-```
-
-This is material strength, not a Gaussian radius in pixels. AppKit's public
-`NSVisualEffectView` API chooses its own blur and tint for the material. It
-samples behind the window; text and cursors are drawn in a separate sibling
-above the effect and remain sharp. macOS accessibility settings such as Reduce
-Transparency can override the material's appearance. `WindowBlur 0` also turns
-off the formerly implicit blur for background-less themes; set it to 100 to
-restore that appearance. The compositor must be checked in a live window:
-offscreen grid captures cannot verify behind-window blur.
-
`test/macos-snapshots/rendering-parity.snap` checks background colour and alpha,
-regular and bottom tags, compact context separators, and PDF fit, tint and
+tags, compact context separators, and PDF fit, tint and
scrolling. Its native-metrics mode uses backing pixels like the shipping app;
the older grid-only tests keep their display-independent point metrics.