Текст и шрифты

Самый быстрый текст в движке — ebitenutil.DebugPrint из пакета ebitenutil: одна строка кода, никакой настройки, шрифт вшит в движок картинкой. Уроки про клавиатуру и примеры движка пользуются им для отладочных строк неслучайно: вывод TPS и FPS в угол экрана не требует ни одного импорта шрифтов. Но у бесплатности есть цена, и она прописана в документации дословно: DebugPrint умеет только символы из диапазона U+0000–U+00FF — базовая латиница, цифры и Latin-1. Ни кириллицы, ни акцентов, ни символа валюты.

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

Первый настоящий API — пакет text из самого движка: Ebitengine текст рисует функцией text.Draw(dst, str, face, x, y, clr), где face — реализация интерфейса font.Face стандартной библиотеки. Готовую реализацию без файлов даёт пакет golang.org/x/image/font/basicfont: Face7x13 — моноширинный растровый шрифт семь на тринадцать пикселей, самый частый гость первых проектов. Цвет передаётся аргументом color.Color, а координаты x, y указывают не на левый верхний угол надписи, а на базовую линию первой буквы — начало отсчёта глифов, о котором легко споткнуться, выравнивая текст по краю экрана.

У пакета есть два свойства, которые важно знать до написания HUD. Перенос строки работает: символ перевода строки отправляет текст на следующую строку, высота которой берётся из метрик шрифта — Metrics().Height. И второй: вызывать Draw каждый кадр безопасно для производительности — документация обещает это прямо, потому что глифы кэшируются и переиспользуются, а не пересоздаются. Но у API есть статус: с версии 2.7 пакет помечен как Deprecated — движок предлагает text/v2, и классический text.Draw остаётся рабочим способом быстро вывести латиницу, однако новым кодам прямая дорога в следующий раздел.

Классическому API нужны не только растровые лица: font.Face можно собрать и из векторного TTF через пакет golang.org/x/image/font/opentype — Parse разбирает байты шрифта в opentype.Font (это псевдоним sfnt.Font), NewFace строит font.Face с опциями размера в пунктах, DPI и хинтинга. Это старший путь до text/v2: он рабочий, но кэш и метрики лица остаётся вести самому, и для новых проектов он проигрывает следующему разделу по всем пунктам, кроме независимости от движка.

Ещё нюанс, записанный в документации пакета прямо: переданный font.Face пакет держит у себя и никогда не выпускает — известная проблема #498. Для одного-двух шрифтов на игру это неважно, но создавать лица в цикле по числу надписей не стоит: они не освободятся никогда.

Пакет text/v2 — рекомендуемый путь с версии 2.7, и его центральное понятие — источник шрифта: text.GoTextFaceSource. Конструктор text.NewGoTextFaceSource принимает io.Reader и разбирает файл OpenType или TrueType — те самые TTF, которые лежат в папке со шрифтами любой системы. Источник разбирается один раз при старте, кэширует глифы внутри себя и живёт до конца игры. Поверх источника создаётся лицо — text.GoTextFace: обязательные поля Source и Size в пикселях, плюс необязательные Direction и Language для направления письма и языковых подсказок; одно и то же лицо можно смело создавать на каждый вызов Draw — это дешёвая маленькая структура, а кэш глифов живёт в источнике, а не в лице.

Отрисовка — text.Draw(screen, str, face, op), где op — *text.DrawOptions, embed-структура: внутри ebiten.DrawImageOptions с GeoM и ColorScale плюс LayoutOptions с межстрочным расстоянием LineSpacing. Отличие в позиционировании стоит запомнить сразу: v2 кладёт в точку перевода левый верхний угол области текста, а не базовую линию, как классический пакет — перенесённый код со старыми координатами уедет вверх. Сам файл шрифта вшивается в бинарник через embed, как картинки четвёртого урока, и игра не зависит от шрифтов, установленных в системе игрока.

Цвет в text/v2 задаётся ColorScale из опций отрисовки — тем же механизмом, что тонирует спрайты: op.ColorScale.ScaleWithColor(color.RGBA{...}) перекрашивает белые глифы шрифта. Размер — поле Size лица, и здесь у кэша есть характер: картинки глифов создаются для каждого размера отдельно, поэтому плавно растущий текст — дюжина размеров за секунду — завалит кэш пересозданиями. Размер меняйте дискретно: двадцать четыре, тридцать два, сорок восемь, как уровни заголовков в интерфейсе, а не интерполяцией каждый кадр.

Для выравнивания пакет даёт измерение: text.Measure(str, face, lineSpacing) возвращает ширину и высоту области, которую займёт текст, а text.Advance — ширину одной строки; с версии 2.10 Advance помечен как Deprecated в пользу AdvanceAt для позиционирования каретки, а Measure остаётся основным инструментом вёрстки. Центрированный заголовок меню — это Measure плюс пара делений: x := (viewW - w) / 2. Для прогрева кэша перед первым кадром есть text.CacheGlyphs: вызвать его на старте со всеми строками интерфейса — и первый кадр с текстом не заплатит за создание глифов. Только помните, что функция тяжёлая: она создаёт все подпиксельные варианты глифов сразу, и в обычной игре Draw создаёт и кэширует глифы сам — прогрев оправдан, когда первый кадр критичен. Measure работает по данным шрифта и не рисует ничего: три вызова в кадре дешевле одной пробной отрисовки ради ширины.

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

Меню и пауза — следующий уровень применения: заголовок по центру через Measure, пункты выбора, подсказки клавиш — весь интерфейс меню строится тем же вызовом Draw, что и счёт. Сцены и их переходы разберёт ближайший урок, а пока зафиксируйте ещё одно правило: шрифт — ассет с лицензией. Шрифты из примеров движка — M+ 1p, Press Start 2P, Terminus TTF — поставляются на свободных лицензиях, и правила их использования соберёт урок про ассеты и лицензии: лицензия шрифта читается так же внимательно, как лицензия спрайтов.