87 строк · 4 КиБ
tools/ui-matrix/contrast.py
| 1 | #!/usr/bin/env python3 |
| 2 | """Оценка контраста текста на снимках интерфейса (docs/UI-DESIGN-SPEC.md, 3.4). |
| 3 | |
| 4 | Рамки слов берутся у tesseract (язык не важен: нужны места, а не текст). В |
| 5 | каждой рамке яркость букв — 95-й процентиль относительной яркости, фона — |
| 6 | 20-й (светлый текст на тёмном; для тёмного на светлом наоборот). Отношение — |
| 7 | по формуле WCAG. Сглаживание шрифта занижает яркость букв, поэтому оценка |
| 8 | скорее строже настоящей: всё, что прошло здесь, пройдёт и пипеткой. |
| 9 | |
| 10 | Без русской модели (`tesseract-data-rus`) кириллицу tesseract узнаёт с низкой |
| 11 | уверенностью, и часть строк отсеивается порогом ниже. Проверка тогда |
| 12 | выборочная: она ловит провалы, но не доказывает, что их нет. |
| 13 | |
| 14 | contrast.py <снимок.png> <размеченный.png> → JSON в stdout |
| 15 | """ |
| 16 | |
| 17 | import json |
| 18 | import subprocess |
| 19 | import sys |
| 20 | |
| 21 | from PIL import Image, ImageDraw |
| 22 | |
| 23 | |
| 24 | def lin(c): |
| 25 | c /= 255.0 |
| 26 | return c / 12.92 if c <= 0.04045 else ((c + 0.055) / 1.055) ** 2.4 |
| 27 | |
| 28 | |
| 29 | def lum(px): |
| 30 | r, g, b = px[:3] |
| 31 | return 0.2126 * lin(r) + 0.7152 * lin(g) + 0.0722 * lin(b) |
| 32 | |
| 33 | |
| 34 | def ratio(a, b): |
| 35 | hi, lo = max(a, b), min(a, b) |
| 36 | return (hi + 0.05) / (lo + 0.05) |
| 37 | |
| 38 | |
| 39 | def boxes(path): |
| 40 | tsv = subprocess.run( |
| 41 | ["tesseract", path, "-", "--psm", "11", "tsv"], |
| 42 | capture_output=True, text=True, check=True, |
| 43 | ).stdout.splitlines() |
| 44 | head = tsv[0].split("\t") |
| 45 | for line in tsv[1:]: |
| 46 | row = dict(zip(head, line.split("\t"))) |
| 47 | if row.get("level") != "5" or not row.get("text", "").strip(): |
| 48 | continue |
| 49 | x, y, w, h = (int(row[k]) for k in ("left", "top", "width", "height")) |
| 50 | # Значки tesseract тоже принимает за «слова»: они квадратные и с |
| 51 | # низкой уверенностью. Оставляем только то, что похоже на текст. |
| 52 | text = row["text"].strip() |
| 53 | if float(row.get("conf", -1)) < 20 or sum(ch.isalnum() for ch in text) < 2: |
| 54 | continue |
| 55 | if w >= 1.2 * h and 8 <= h <= 120: |
| 56 | yield x, y, w, h |
| 57 | |
| 58 | |
| 59 | def main(): |
| 60 | src, out = sys.argv[1], sys.argv[2] |
| 61 | im = Image.open(src).convert("RGB") |
| 62 | px = im.load() |
| 63 | marked = im.copy() |
| 64 | draw = ImageDraw.Draw(marked) |
| 65 | results = [] |
| 66 | for x, y, w, h in boxes(src): |
| 67 | vals = sorted(lum(px[i, j]) for i in range(x, x + w) for j in range(y, y + h)) |
| 68 | if len(vals) < 40: |
| 69 | continue |
| 70 | lo, hi, mid = vals[int(len(vals) * 0.2)], vals[int(len(vals) * 0.95)], vals[len(vals) // 2] |
| 71 | # Светлый текст на тёмном фоне: фон ближе к медиане, чем буквы. |
| 72 | text, bg = (hi, lo) if mid - lo < hi - mid else (lo, hi) |
| 73 | r = ratio(text, bg) |
| 74 | large = h >= 24 |
| 75 | need = 3.0 if large else 4.5 |
| 76 | results.append({"box": [x, y, w, h], "ratio": round(r, 2), "need": need}) |
| 77 | if r < need: |
| 78 | draw.rectangle([x - 2, y - 2, x + w + 2, y + h + 2], outline=(255, 40, 40), width=3) |
| 79 | marked.save(out) |
| 80 | fails = [r for r in results if r["ratio"] < r["need"]] |
| 81 | worst = min(results, key=lambda r: r["ratio"] / r["need"], default=None) |
| 82 | print(json.dumps({"words": len(results), "fails": len(fails), "worst": worst}, ensure_ascii=False)) |
| 83 | |
| 84 | |
| 85 | if __name__ == "__main__": |
| 86 | main() |
| 87 |