docs(phase-1/m5.5): HiDPI correction — Xft.dpi is the real scaling mechanism

Controlled re-runs kill the M5.3 sun.java2d.uiScale verdict: the jpackage
launcher JVM picks the property up yet renders 1:1, in-process setProperty is
also inert, and 1.7.3 Window/rememberWindowState expose no scale arg (javap).
Xft.dpi IS the lever: xrdb 192 + plain bin/incido -> 1920x1016 (1090.dp
clamped), pixel RMSE 0.071 for the 2x-upscaled scale-1 crop (0.000 identical /
0.250 unscaled controls) -> glyphs render proportionally; HiDPI check CLOSED.
Also recorded: uinput virtual keyboard dropped by the compositor like XTEST
(keypress check is physical-keys-only), branch pushed to origin, and the tag
run held for user decision since v*.*.* also fires release.yml.

Verify: bin/incido under Xft.dpi=192 geometry 1920x1016, under 96 -> 1090x730
restored; magick compare RMSE 0.0707 (b6 vs 2x-a), controls 0 and 0.2497;
Main.kt --ui-scale experiment reverted (git checkout, tree was clean).
This commit is contained in:
Incido Developer committed 2026-10-06 23:52:45 +13:00
1 parent 9f6124a501
commit 765191ac8e
2 files changed
+56 -10

No files matched your search

+11 -2
View File
@@ -121,7 +121,9 @@ app version `0.4.2.0` (code 38).
(no onClick); menu members are capitalized `Item`/`Separator`/`CheckboxItem`.
* KWin under Wayland drops xdotool XTEST keys aimed at the XWayland window even
when focus probes show it focused — desktop key handling can't be injected
headless here; verify real keypresses by hand.
headless here; verify real keypresses by hand. (06/10: a kernel-level
`/dev/uinput` virtual keyboard — libinput-visible, the ydotool mechanism —
is ALSO dropped. No synthetic route works on this stack.)
* The jlink runtime inside the app-image lacks `jdk.unsupported`; DataStore's
protobuf crashes with `NoClassDefFoundError: sun/misc/Unsafe` ONLY inside the
image (`:desktopApp:run` on a full JDK never sees it). Shipped via
@@ -130,6 +132,13 @@ app version `0.4.2.0` (code 38).
* Compose 1.7.3's `nativeDistributions` DSL has no `iconFile` property; icons
travel through `packaging/incido.desktop` (app-image) or the deb install
step, not the DSL.
* HiDPI on Linux X11 = `Xft.dpi` (xrdb) ONLY. `sun.java2d.uiScale` does nothing
for Compose density here even when the jpackage launcher JVM picks it up, and
1.7.3 `Window` exposes no scale arg at all (javap-verified — its absence
surfaces as the usual overload-ambiguity lambda error). Gradle's daemon also
swallows `JAVA_TOOL_OPTIONS` before forked run-JVMs. Scale tests: direct
`bin/incido` + `xrdb`, never `gradlew run` (06/10; 2× render proven by pixel
RMSE 0.071 vs 0.250 unscaled control).
## 4. M2 — the backup bridge (next up; the product's reason to exist)
@@ -247,7 +256,7 @@ Exit criteria: one shared UI codebase; Android visually unchanged
(`assembleDebug` + on-device smoke); desktop shows the real list, editor and
settings wearing Incido's theme.
## 7. M5 — packaging and integration — **DONE** (M5.1–M5.5, run logs in `DESKTOP_FEASIBILITY.md`; pending-manual list recorded there: real keypress, uiScale eyeball, first tag run of `desktop-release.yml`, M3's phone→desktop recovery-key leg)
## 7. M5 — packaging and integration — **DONE** (M5.1–M5.5 + HiDPI correction, run logs in `DESKTOP_FEASIBILITY.md`; pending: real keypress — only physical keys work, uinput also dropped; first tag run of `desktop-release.yml` — awaiting user; M3's phone→desktop recovery-key leg. HiDPI check CLOSED: Xft.dpi route, pixel-verified)
`packageDistributionForCurrentOS` per OS on a GitHub Actions matrix (no
cross-compiling); icons, `.desktop` entry, tray + single-instance, first-run