summaryrefslogtreecommitdiff
path: root/docs/macos.md
diff options
context:
space:
mode:
authorGabriel Schneider <[email protected]>2026-11-05 23:27:29 -0300
committerGabriel Schneider <[email protected]>2026-11-05 23:58:31 -0300
commitcd3627307740896426830423598d2e1a8e27b024 (patch)
tree8cb845c8da5d07c15d9d234f285bff9cffb83449 /docs/macos.md
parent342650183a54dcfcdce6ca4d45d6fdf48b2d1c1c (diff)
downloadpardes-cd3627307740896426830423598d2e1a8e27b024.tar.gz
pardes-cd3627307740896426830423598d2e1a8e27b024.zip
settings #5, three behaviour knobs go, each the value it had by default: ProgramEsc (in a raw terminal Esc goes back a pane and Shift-Esc is the program's Esc; keys.zig's at-the-prompt Esc, which only ProgramEsc reached, goes), JumpScope (Back and Forward keep to the focused pane's file first; Jump.jumpBy's scope test goes) and WindowBlur (the macOS window draws no blur: macos.zig's pardes_window_blur, its header line, and AppDelegate.swift's NSVisualEffectView backdrop go, built nowhere here; Capabilities.window_blur with them); deleted tests: "with ProgramEsc raw tty Escape only leaves at a shell prompt", "modes: with JumpScope all, Ctrl-o and Ctrl-i take every place in the order it was jumped to, and bare JumpScope is file again", "window blur defaults off and validates without changing opacity", macos.zig's "mac window blur builtin reaches the ABI without changing opacity", and the JumpScope all half of "settings: Back and Forward written to exec keep to the focused file"; rewritten: dump's settings test on Wrap, the PDF jump test without its scope check, other-files' jump to a closed file from the +Jumps listing (no file to keep to); the reference, guide, helix-keys and macos docs lose the three; no golden changes; gates on tui: core-test 961/961, behaviour-test 240/240, unit-test 1476/1477, pane-test 171/172, snap all 105 scripts ok, process-test 0 of 37 failed; gui unit-test 1520/1521
Co-Authored-By: Claude Fable 5.1 <[email protected]> Claude-Session: https://claude.ai/code/session_016Y9MNAtZenFv4weoMD3cge
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.