Документация
Docs/ru/reference/font-format/index.md
Сгенерированный справочник форматов шрифтов
Сгенерированный справочник. Не редактируйте его напрямую. Обновите
BuildTools/FontFormatInterface.json, затем выполнитеpython BuildTools/docs_font_format.py --write.
| Индекс | Форматы | FOFNT | BMFont | Привязка | Компоновка | Отрисовка | Проверка | Канонический JSON | Руководство |
Этот справочник описывает принадлежащие Engine дескрипторы шрифтов, клиентскую привязку, компоновку и отрисовку текста, масштабирование и проверку. Выбор шрифтов и типографическая политика проекта остаются вне контракта.
Состояние контракта
| Поле | Значение |
|---|---|
| Стабильность | experimental |
| Политика поддержки | Два runtime-формата дескрипторов и поведение клиентской компоновки поддерживаются, но остаются экспериментальными; подключаемые проекты владеют выбором шрифтов, покрытием глифов, типографикой, слотами GUI и визуальной приёмкой. |
| Исходный манифест | BuildTools/FontFormatInterface.json |
| Дайджест контракта | 76258828339a7603add4ae984ecf8d557484940d4d92fdadd8e0d950135ec3bc |
| Runtime-дескрипторы | .fofnt, .fnt |
| Максимальная версия FOFNT | 2 |
| Версия binary BMFont | 3 |
| Клиентский атлас | IfaceSprites |
| Справочник | Записи | Назначение |
|---|---|---|
| Formats | 3 | Роли дескрипторов и поддерживаемые суффиксы ресурсов. |
| FOFNT | 13 | Ключи текстового дескриптора и метрики глифов. |
| BMFont | 9 | Принимаемые блоки binary v3 и преобразования метрик. |
| Binding | 8 | Raw-copy, слоты, атлас, масштаб и поведение при запуске. |
| Layout | 9 | TextFormat, перенос, выравнивание, измерение и fallback глифов. |
| Rendering | 7 | Подготовка текстуры, рамки, эффекты, теги цвета и кеш. |
| Validation | 8 | Режимы отказа и исполняемые gate проверки. |
Граница ответственности
Включено:
- текстовые дескрипторы .fofnt и их метрики глифов
- дескрипторы binary BMFont v3 .fnt, принимаемые клиентом
- доставка raw-copy и отдельно запечённые изображения шрифтов
- диспетчеризация Game.BindFont, слоты шрифтов, размещение в атласе и startup-fallback
- уменьшение при привязке, преобразование в оттенки серого, создание обводки и эффекты
- флаги TextFormat, перенос, выравнивание, измерение, встроенные цвета и кеширование
- основанная на исходниках диагностика и маршрутизация проверки
Исключено:
- имена шрифтов, каталоги слотов, назначения GUI и типографическая политика подключаемого проекта
- лицензирование шрифтов, права на распространение и приёмка покрытия глифов для конкретных языков
- текстовые и XML-дескрипторы BMFont, которые runtime не разбирает
- семантика конфигурации инструмента авторинга .bmfc
- векторные шрифты и runtime-растеризация TTF/OTF, отсутствующая в клиенте
- проектные пакеты локализации и авторские отображаемые строки