Files
MeshTerm/scripts/ladders/contrast.py
T
Jean-Pierre MartineauandClaude Opus 5.5 a493a6a5eb Keep the calibration ladders in scripts/ladders, with the method
A ladder draws the candidates for a visual value side by side through
MeshTerm's own renderer and live constants, so JP can choose by eye.
The two that set constants are kept: hue_ladder.py (the node wheel's
lightness, 0.72 on 2026-10-29) and seam_ladder.py (SEAM_BLUR, rebuilt
from the 2026-09-16 tool), with contrast.py for the measurement that
comes first and ladderkit.py for what they share.

launch.ps1 opens a ladder in a new Windows Terminal window and waits
for the ladder's marker file; -Snap also takes a screenshot through
snap.ps1. It avoids the three traps that broke the launches this week:
wt quoting a forwarded command line as one file name, the tab
inheriting Claude Code's NO_COLOR=1, and Rich falling back to the
16-colour console API when virtual terminal processing is off. The
README explains the method and the traps.

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
2026-10-29 01:10:16 -04:00

65 lines
2.6 KiB
Python

# SPDX-License-Identifier: Apache-2.0
"""The contrast between the label and the fill of each node chip, as a table.
python scripts/ladders/contrast.py # each 16th byte of the live spectrum
python scripts/ladders/contrast.py --step 1 # all 256 bytes
python scripts/ladders/contrast.py --hsv # the HSV wheel of before 2026-10-29
This script is not a ladder. It is the measurement that comes before one: it shows the
problem as numbers. Three measures are in the table: the OKLab difference in lightness, the
WCAG 2 ratio, and the APCA ``Lc`` (refer to ``ladderkit.apca``). On the HSV wheel, the APCA
contrast went from 19 (blue) to 64 (yellow). This number started the hue ladder.
"""
from __future__ import annotations
import argparse
from hue_ladder import hsv_hex
from ladderkit import apca, console, wcag
from rich.text import Text
from meshterm.ui import oklab, theme
from meshterm.ui.pathline import _chip_fill
def main() -> None:
"""Print the table and the range of each measure."""
parser = argparse.ArgumentParser(description="Label-on-fill contrast of the node chips.")
parser.add_argument("--step", type=int, default=16, help="show each Nth byte")
parser.add_argument("--hsv", action="store_true", help="measure the HSV wheel of before")
args = parser.parse_args()
con = console(width=120)
colour_of = hsv_hex if args.hsv else (lambda byte: theme._NODE_SPECTRUM[byte])
rows = []
for byte in range(256):
label = colour_of(byte)
fill = _chip_fill(label)
lab_l, fill_l = oklab.from_hex(label)[0], oklab.from_hex(fill)[0]
rows.append((byte, label, fill, lab_l, fill_l, wcag(label, fill), apca(label, fill)))
header = "byte chip label fill L label/fill ΔL WCAG APCA"
con.print(Text(header, style="bold"))
for byte, label, fill, lab_l, fill_l, ratio, lc in rows[:: args.step]:
line = Text(f" {byte:02x} ")
line.append(f" {byte:02x} ", style=f"bold {label} on {fill}")
line.append(
f" {label} {fill} {lab_l:.2f} / {fill_l:.2f} {lab_l - fill_l:.2f}"
f" {ratio:4.2f} {lc:5.1f}"
)
con.print(line)
for name, index in (("L label", 3), ("WCAG", 5), ("APCA", 6)):
low, high = min(rows, key=lambda r: r[index]), max(rows, key=lambda r: r[index])
con.print(
Text(
f"{name:8} min {low[index]:6.2f} (byte {low[0]:02x})"
f" max {high[index]:6.2f} (byte {high[0]:02x})",
style="#a2a2a2",
)
)
if __name__ == "__main__":
main()