Введение
Файлы шрифтов построены вокруг таблиц — каждая таблица хранит определённую категорию данных, таких как контуры глифов, сопоставления символов, метаданные названий или горизонтальные метрики. Понимание и доступ к этим таблицам необходимы для задач, таких как анализ шрифтов, редактирование метаданных, контроль качества и конвертация форматов.
Aspose.Font FOSS for Python (aspose-font) дает вам прямой доступ к полному набору таблиц OpenType и TrueType через чистый Python API. Библиотека распространяется под лицензией MIT без внешних зависимостей, поэтому вы можете интегрировать её в любой проект без лицензионных проблем.
В этом посте рассматриваются ключевые классы таблиц, доступные в библиотеке — от чтения метаданных заголовка до инспекции данных глифов и изменения записей имён — всё это поддерживается контейнером TtfTableSet на TtfFont.
Ключевые возможности
Загрузка шрифта и доступ к таблицам
Каждый шрифт, загруженный с помощью FontLoader, раскрывает свои разобранные таблицы через свойство ttf_tables объекта TtfFont. Объект TtfTableSet предоставляет типизированный доступ к каждой стандартной таблице, а также доступ к необработанным байтам через get_raw() для пользовательских или нераспознанных таблиц.
import aspose_font
font = aspose_font.FontLoader.open("MyFont.ttf")
tables = font.ttf_tables
# Typed table access
head = tables.head
name = tables.name
cmap = tables.cmap
# Raw bytes for any table tag
raw_os2 = tables.get_raw("OS/2")
Чтение таблицы Head
HeadTable хранит фундаментальные параметры, охватывающие весь шрифт: units per em, revision, bounding box, creation date и style flags. Эти значения критически важны для движков рендеринга и валидаторов шрифтов.
import aspose_font
font = aspose_font.FontLoader.open("MyFont.ttf")
head = font.ttf_tables.head
print(f"Units per em: {head.units_per_em}")
print(f"Revision: {head.font_revision}")
print(f"Bounding box: ({head.x_min}, {head.y_min}) to ({head.x_max}, {head.y_max})")
print(f"Mac style flags: {head.mac_style}")
print(f"Glyph data format: {head.glyph_data_format}")
Работа с таблицей Name
NameTable содержит все человеко-читаемые метаданные: название семейства шрифта, стиль, авторские права, лицензию, дизайнера и описание. Вы можете запрашивать записи по name ID, получать локализованные имена или изменять записи для ребрендинга.
import aspose_font
font = aspose_font.FontLoader.open("MyFont.ttf")
name_table = font.ttf_tables.name
# Read the font family name (name ID 1)
family = name_table.best_name(1, ["en"])
print(f"Family: {family}")
# List all localized versions of the full name (name ID 4)
localized = name_table.localized_names(4)
for lang, value in localized.items():
print(f" {lang}: {value}")
# Replace the font family name
name_table.replace_name(1, "MyCustomFamily")
Проверка таблицы CMap
CmapTable отображает Unicode-коды в glyph ID. Он может содержать несколько подтаблиц для разных комбинаций платформ и кодировок. Используйте best_subtable(), чтобы получить наиболее подходящее сопоставление для вашего случая.
import aspose_font
font = aspose_font.FontLoader.open("MyFont.ttf")
cmap = font.ttf_tables.cmap
# Get the best Unicode subtable
subtable = cmap.best_subtable()
print(f"Platform: {subtable.platform_id}, Encoding: {subtable.encoding_id}")
# Look up the glyph ID for 'A'
gid = subtable.get_gid(ord("A"))
print(f"Glyph ID for 'A': {gid}")
Чтение OS/2 и горизонтальных метрик
Os2Table предоставляет OS/2 и специфичные для Windows метрики, включая типографический ascender/descender, флаги внедрения и классификацию Panose. HheaTable и HmtxTable предоставляют метрики горизонтального расположения, используемые для формирования текста.
import aspose_font
font = aspose_font.FontLoader.open("MyFont.ttf")
os2 = font.ttf_tables.os2
hhea = font.ttf_tables.hhea
print(f"Typo ascender: {os2.s_typo_ascender}")
print(f"Typo descender: {os2.s_typo_descender}")
print(f"Embedding flags (fsType): {os2.fs_type}")
print(f"Panose: {os2.panose.hex()}")
print(f"Hhea ascender: {hhea.ascender}")
print(f"Max advance width: {hhea.advance_width_max}")
print(f"Number of hmetrics: {hhea.number_of_hmetrics}")
Кернинг и данные глифов
KernTable хранит пары кернинга для корректировки горизонтального интервала. GlyfTable содержит фактические данные контуров глифов для шрифтов TrueType. Вы также можете использовать PostTable для разрешения имён глифов.
import aspose_font
font = aspose_font.FontLoader.open("MyFont.ttf")
# Kerning lookup
kern = font.ttf_tables.kern
if kern:
pairs = kern.pairs
print(f"Total kern pairs: {len(pairs)}")
# Look up a specific pair by glyph IDs
adjustment = kern.get(36, 57)
print(f"Kern adjustment: {adjustment}")
# Glyph name from post table
post = font.ttf_tables.post
if post:
glyph_name = post.glyph_name(0)
print(f"Glyph 0 name: {glyph_name}")
Быстрый старт
git clone https://github.com/aspose-font-foss/Aspose.Font-FOSS-for-Python.git
cd Aspose.Font-FOSS-for-Python
pip install -e .import aspose_font
# Load any TTF or OTF font
font = aspose_font.FontLoader.open("MyFont.ttf")
tables = font.ttf_tables
# Print basic table info
print(f"Font: {font.font_name}")
print(f"Family: {font.font_family}")
print(f"Glyphs: {font.num_glyphs}")
print(f"Units/em: {tables.head.units_per_em}")
# Read name table entries
name_table = tables.name
for name_id in [0, 1, 2, 4, 5, 6]:
value = name_table.best_name(name_id, ["en"])
if value:
print(f" Name ID {name_id}: {value}")
# Check character coverage
cmap = tables.cmap
subtable = cmap.best_subtable()
for char in "ABCabc012":
gid = subtable.get_gid(ord(char))
print(f" '{char}' -> glyph {gid}")
Поддерживаемые форматы
| Формат | Расширение | Чтение | Запись |
|---|---|---|---|
| TTF | .ttf | ✓ | ✓ |
| OTF | .otf | ✓ | ✓ |
| CFF | .cff | ✓ | ✓ |
| WOFF | .woff | ✓ | ✓ |
| WOFF2 | .woff2 | ✓ | ✓ |
| EOT | .eot | ✓ | — |
| TYPE1 | .pfb/.pfa | ✓ | — |
Открытый исходный код и лицензирование
Aspose.Font FOSS для Python выпущен под лицензией MIT. Исходный код доступен на GitHub, а пакет опубликован на PyPI как aspose-font. Вы свободно можете использовать, модифицировать и распространять его в личных и коммерческих проектах без ограничений.
