Project Chimera
Меню

Исходники

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-й процентиль относительной яркости, фона —
620-й (светлый текст на тёмном; для тёмного на светлом наоборот). Отношение —
7по формуле WCAG. Сглаживание шрифта занижает яркость букв, поэтому оценка
8скорее строже настоящей: всё, что прошло здесь, пройдёт и пипеткой.
9
10Без русской модели (`tesseract-data-rus`) кириллицу tesseract узнаёт с низкой
11уверенностью, и часть строк отсеивается порогом ниже. Проверка тогда
12выборочная: она ловит провалы, но не доказывает, что их нет.
13
14 contrast.py <снимок.png> <размеченный.png> → JSON в stdout
15"""
16
17import json
18import subprocess
19import sys
20
21from PIL import Image, ImageDraw
22
23
24def 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
29def lum(px):
30 r, g, b = px[:3]
31 return 0.2126 * lin(r) + 0.7152 * lin(g) + 0.0722 * lin(b)
32
33
34def ratio(a, b):
35 hi, lo = max(a, b), min(a, b)
36 return (hi + 0.05) / (lo + 0.05)
37
38
39def 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
59def 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
85if __name__ == "__main__":
86 main()
87