summaryrefslogtreecommitdiff
path: root/docs/effects.md
diff options
context:
space:
mode:
Diffstat (limited to 'docs/effects.md')
-rw-r--r--docs/effects.md13
1 files changed, 13 insertions, 0 deletions
diff --git a/docs/effects.md b/docs/effects.md
index 08fd3d88..c8e5c7a7 100644
--- a/docs/effects.md
+++ b/docs/effects.md
@@ -13,6 +13,19 @@ its text. A dim touches only the unfocused
panes, with the same floor, and the focused pane's text is never at less
contrast than theirs (tests in src/draw.zig).
+**Density.** A pixel shell draws every size given in pixels in logical
+pixels, `dp()` in gui.zig (SDL's window display scale, rounded, at least
+one; `PARDES_TEST_SCALE` forces one in a harness, and a test window is 1x
+otherwise): the rules (`rule_px`), the tag rule, the grip's ring and its
+dirty gap and mode bars, the rail's gap to the text and its minimum, the
+thumb's inset, the rim, a bar cursor's minimum width, underline and
+strikethrough thickness, the rule-grab margin, and the Crt's scanline and
+mask periods (`pardesScale`). Left as they are: what is measured in cells
+or the tagline (the rail's width, `rail_px` scaled with the tagline; Lift's
+blur and offsets; every motion, in cells), Shadertoy's iResolution,
+fragCoord and iMouse (the display's pixels, as ghostty's), and the pet and
+touch debug overlays.
+
Each effect of docs/render-pipeline.md §9 lands behind its own switch, off,
and is kept only after a feel review (§8.4): a frame series on the virtual
clock, a recording, and a verdict — keep, polish or drop — with one line of