diff options
Diffstat (limited to 'docs/macos.md')
| -rw-r--r-- | docs/macos.md | 34 |
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. |
