Начало темыИсходник

Обложки пачкой: подбор кегля двоичным поиском, контраст по WCAG и двенадцать PNG одной командой

leonixxxleonixxxНовичок·11.11.2026· 0 ответов 0 реакций

Я веду канал и раз в неделю рисую к нему обложки. Двенадцать тем — двенадцать картинок. Первый раз я честно сидел в редакторе: подвинул заголовок, подобрал кегль, чтобы влезло в две строки, поменял фон, сохранил, повторил. На четвёртой обложке поймал себя на том, что делаю ровно одно и то же действие, а отличаются только слова. На шестой понял: это не дизайн, это цикл, который просится в код.

Так появился этот проект. Он делает одну вещь: берёт список заголовков и пачку настроек, а возвращает пачку готовых PNG. Никакого редактора, никакой мыши, никакого «а тут подвину на два пикселя».

Шаблон — это данные, а не код

Первое решение, которое сэкономило больше всего времени: обложка описывается JSON-файлом. Холст, безопасное поле, фон, три зоны — заголовок, подзаголовок, акцентная полоса — и кружок с номером в углу. Всё в пикселях, всё явно.

{
  "canvas": { "w": 1280, "h": 720 },
  "margin": 56,
  "background": { "kind": "gradient", "color": "#101a2b",
                  "color2": "#2b5580", "accent": "#f0b429",
                  "direction": "diagonal" },
  "title":    { "x": 56, "y": 208, "w": 1040, "h": 244 },
  "subtitle": { "x": 56, "y": 470, "w": 1040, "h": 115 },
  "accent_bar": { "x": 56, "y": 182, "w": 179, "h": 8 },
  "badge": { "x": 1179, "y": 101, "r": 45 }
}

Почему данные, а не класс с методами: этот же файл может читать другой движок рисования. Мне это понадобилось не сразу, но понадобилось — об этом в конце, там где про Canvas.

У шаблона есть валидатор, и он не декоративный. Четыре проверки, каждая со своим текстом, потому что «KeyError» на километре стека не помогает понять, что зона уехала за край:

зона title выходит за безопасное поле: [1200..1600]x[150..350]
  не влезает в [56..1224]x[56..664]
зоны title и subtitle пересекаются: (56, 208, 1096, 452)
  против (56, 248, 1096, 363)
margin: не может быть отрицательным, пришло -8
badge: круг R=60 с центром (1270, 30) вылезает за безопасное поле

Это не пример «как могло бы быть» — это дословный вывод из транскрипта прогона, я специально ломаю шаблон четырьмя способами и печатаю то, что поймалось. Проверка идёт до рендера, поэтому пачка из двенадцати обложек не умирает на восьмой из-за опечатки в координате.

Самое интересное: подбор кегля

Вот здесь я и застрял в первый вечер. Задача звучит просто: есть коробка 1040 на 244 пикселя и строка, подбери кегль так, чтобы текст влез и по ширине, и по высоте. На практике «подобрать» — это цикл по размерам шрифта, и вопрос только в том, как его не сделать линейным.

Ответ — двоичный поиск. Диапазон 20…158 пикселей, на каждом шаге мерим настоящим шрифтом: режем строку на слова жадным переносом, считаем ширину каждой строки и высоту всего блока, сравниваем с коробкой. Влезло — запоминаем как лучший результат и идём вверх, не влезло — вниз. Семь замеров вместо ста пятидесяти девяти.

кегль  влез?  что получилось
   89   нет    сужаем вниз
   54   да     запомнили как лучший
   71   нет    сужаем вниз
   62   да     запомнили как лучший
   66   нет    сужаем вниз
   64   нет    сужаем вниз
   63   нет    сужаем вниз
итог: 62 px, строк 3

Четыре разных заголовка на одной и той же коробке дают четыре разных кегля — 90, 95, 62 и 45 пикселей. Последний — это слово из сорока символов без единого пробела, «ПостоянныйТекстБезПробеловВсёЕщёВлезает»: переносить его негде, поэтому работает только кегль, и он ужимается до 45. Ширина при этом 1027 из 1040 — влезло впритык, но влезло.

Три вещи, которые пришлось добавить после первых тестов.

Первая — лестница. Если текст не влезает в три строки даже минимальным кеглем, глупо сразу ставить многоточие: иногда хватает одной лишней строки. Порядок такой: три строки, четыре, пять, и только потом обрезка. Ступень записывается в результат, чтобы потом было видно, какой ценой достался кегль.

Вторая — многоточие. Обрезка идёт двоичным поиском по длине префикса: берём половину строки, добавляем «…», проверяем, влезло ли; если да — пробуем длиннее. Это единственный способ не делать сто замеров на одно слово.

Третья, самая скучная и самая важная — мерить тем же вызовом, которым рисуешь. Ширина строки берётся из getlength, высота — из getbbox, и в тестах есть отдельная проверка, которая заново считает чернила каждой строки через getbbox и сравнивает с коробкой. Не потому что я не доверяю своему коду, а потому что «намерили одним API, нарисовали другим» — классический способ получить вылезший за край текст на продакшене.

Тестов на это тридцать девять штук, включая кириллицу, смешанный регистр, пустую строку, слово в сорок символов и монотонность: если коробка шире, кегль не может стать меньше. Всего в проекте 129 тестов, все зелёные.

Контраст: не «на глаз», а по формуле

Вторая вещь, которую глазом не проверишь. Текст на градиенте может оказаться нечитаемым в одном углу и нормальным в другом, и «мне кажется, нормально» — не аргумент.

Считаю по WCAG: канал sRGB переводится в линейное значение, потом яркость как 0.2126 R + 0.7152 G + 0.0722 B, потом отношение (Lmax + 0.05) / (Lmin + 0.05). Проверка на известных значениях: белый на чёрном даёт ровно 21.0000, #767676 на белом — 4.5422 против эталонных 4.54, #595959 — 7.0047 против 7.00. Расхождение в третьем знаке, и то из-за округления эталона.

Порядок в рендере получился не сразу. Сначала я рисовал текст, а потом думал про контраст — то есть проверял уже испорченное. Правильно наоборот: нарисовать фон, замерить среднюю яркость зоны заголовка, выбрать из белого и чёрного тот, у кого контраст выше, и только потом рисовать буквы.

Дальше вылез неприятный факт. Минимум у пары «белый или чёрный» — 4.58:1, это точка, где оба варианта равны. Значит, порог 7:1 (AAA) на средних тонах недостижим в принципе, сколько ни выбирай. На сером фоне 128,128,128 белый даёт 3.95:1 — формально «читаемо», по факту грязно.

Поэтому появилась подложка. Если лучший из двух цветов не дотягивает до 7:1, под зону заголовка кладётся полупрозрачный прямоугольник — тёмный под белый текст, светлый под чёрный — и замер повторяется. На том же сером фоне: было 3.95:1, стало 12.94:1, текст выбрался чёрный. Подложка — не украшение, это единственный способ добрать контраст, не меняя палитру.

Пачка

Дальше всё просто: CSV с колонками title, subtitle, badge, двенадцать строк, двенадцать комбинаций холста, палитры и стиля фона. Три холста — горизонтальный 1280 на 720, квадрат 800 на 800 и вертикальная история 1080 на 1920. Три палитры — холодная синяя, почти чёрная с красным акцентом, тёмно-зелёная с мятным. Плюс два стиля фона: градиент и заливка.

 #  пресет                     канва      кегль стр контраст      мс
--------------------------------------------------------------------
 1  tg-post/nord/gradient      1280x720     90   2   12.50:1   328.2
 2  square/coal/gradient       800x800     86   2   15.79:1   277.9
 3  story/moss/gradient        1080x1920   126   3   13.34:1   690.2
 4  tg-post/coal/gradient      1280x720     95   2   15.78:1   286.9
 5  square/moss/gradient       800x800     67   3   12.54:1   285.6
 6  story/nord/gradient        1080x1920   165   3   13.41:1   479.9
 7  tg-post/moss/solid         1280x720     95   2   16.89:1   126.7
 8  square/nord/solid          800x800     88   2   17.43:1   120.1
 9  story/coal/solid           1080x1920   119   3   18.11:1   216.1
10  tg-post/coal/solid         1280x720     95   2   18.11:1   134.3
11  square/moss/solid          800x800     67   3   16.89:1   162.7
12  story/nord/solid           1080x1920   165   3   17.43:1   249.3

Что видно из таблицы. Контраст гуляет от 12.50 до 18.11 — и это не случайность, а следствие палитры: чем темнее фон, тем выше число. Подложка не понадобилась ни разу, все три палитры изначально тёмные. Строк на двенадцать обложек ушло тридцать, максимум три на заголовок — лестница и многоточие в этой пачке не пригодились.

И про время. Весь прогон — 3373 миллисекунды, в среднем 281 на обложку. Самая быстрая — квадрат 800 на 800, 120 мс; самая медленная — история 1080 на 1920, 690 мс. Разница втрое, и это ровно разница в числе пикселей: узкое место здесь не алгоритм подбора кегля (семь замеров — это доли миллисекунды), а отрисовка и сжатие PNG. Градиент по строкам пишется вручную: 720 строк для горизонтального холста, 1920 для истории.

Контактный лист собран тем же Pillow из тех же файлов, что лежат в папке, — никакой отдельной «красивой» версии для скриншота. Двенадцать ячеек, двенадцать разных sha256; проверил, что ни одна картинка не повторяется, иначе в списке комбинаций была бы ошибка.

Честно про «на Canvas»

Тема называется «обложки на Canvas», и вот тут надо договорить до конца, потому что иначе получится обман.

Браузерного Canvas в этом проекте нет. Ни одной строки не исполнил ни Chrome, ни node, ни playwright — в прогоне только python и Pillow. Все двенадцать обложек нарисованы локально, в PNG, на диск. Если вы искали сниппет с ctx.fillText, который можно вставить в страницу, — это не он.

«На Canvas» здесь про подход, а не про реализацию. Раскладка описана данными: зоны, доли холста, безопасное поле. Один и тот же JSON-шаблон годится для двух движков — Pillow (ImageDraw, шрифт из TTF) и Canvas2D (fillRect, createLinearGradient, measureText, fillText, toBlob). Общая часть — сам шаблон и правило подбора кегля. Различается один вызов: font.getlength() против ctx.measureText().width.

И вот здесь я не буду делать вид, что всё проверено: совпадение метрик этих двух движков я не мерил. Они оба читают один TTF, но браузер ещё и применяет свой шейпинг, хинтинг и субпиксельное позиционирование. Скорее всего, строка той же длины получит тот же кегль, но «скорее всего» — это не измерение, а догадка, и я её так и называю.

Что ещё не проверено

Шрифт. Взят Segoe UI Bold из системной папки Windows. Если его нет, код берёт Arial, потом Tahoma, потом Verdana, а если нет ни одного — падает с внятной ошибкой, а не подставляет встроенный растровый шрифт. Все кегли в этой статье получены с Segoe UI; на Arial числа будут другими, потому что метрики другие. Это не баг, это свойство любого текстового рендера.

Кернинг и лигатуры. Ширина считается через getlength — это advance FreeType без сложного шейпинга. Лигатуры не подставляются, оптический кернинг не включается. Для кириллицы в Segoe UI это ничего не меняет, но если подставить шрифт с лигатурами, нарисованная строка может оказаться шире измеренной. Запаса под это не заложено — только строгое «блок не больше коробки».

Чего в коде нет

Поворота текста, обводки, теней, вставки картинок внутрь зон. Нет RTL и вертикального набора. Нет кэша шрифтов между процессами — каждый рендер заново открывает TTF, и на пачке это заметно, но пока не мешает. Нет потоков: двенадцать обложек рисуются последовательно, и на этой машине это три с половиной секунды, что быстрее, чем я успею переключиться в другое окно.

Из очевидного, что я бы добавил первым: проверку, что после подстановки подложки текст всё ещё попадает в зону (сейчас он попадает, потому что зона не двигается, но это совпадение, а не гарантия), и предупреждение, если заголовок ушёл на четвёртую строку — молчаливая лестница удобна ровно до момента, когда вёрстка поехала.

А в остальном — двенадцать обложек теперь делаются одной командой, и это ровно то, чего я хотел в тот вечер, когда подвинул заголовок на два пикселя в четвёртый раз.

лучше один раз прогнать, чем сто раз подумать

Исходники
cover-batch.zipЗарегистрируйтесь и поставьте реакцию на сообщение — исходник откроется.48 КБ

Комментарии

0
Пока нет комментариев. Войдите, чтобы ответить первым.