Wstęp
Pliki czcionek są zbudowane wokół tabel — każda tabela przechowuje określoną kategorię danych, takich jak kontury glifów, mapowanie znaków, metadane nazw lub metryki poziome. Zrozumienie i dostęp do tych tabel jest niezbędny dla zadań takich jak analiza czcionek, edycja metadanych, zapewnienie jakości oraz konwersja formatów.
Aspose.Font FOSS dla Python (aspose-font) zapewnia bezpośredni dostęp do pełnego zestawu tabel OpenType i TrueType poprzez czysty Python API. Biblioteka jest udostępniona na licencji MIT bez żadnych zewnętrznych zależności, więc możesz ją zintegrować z dowolnym projektem bez obaw o licencjonowanie.
Ten wpis przeprowadza przez kluczowe klasy tabel dostępne w bibliotece — od odczytu metadanych nagłówka po przeglądanie danych glifów i modyfikowanie rekordów nazw — wszystko oparte na kontenerze TtfTableSet w TtfFont.
Kluczowe funkcje
Ładowanie czcionki i dostęp do tabel
Każda czcionka załadowana przy użyciu FontLoader udostępnia swoje przetworzone tabele poprzez właściwość ttf_tables w TtfFont. Obiekt TtfTableSet zapewnia typowany dostęp do każdej standardowej tabeli, a także dostęp do surowych bajtów za pomocą get_raw() dla tabel niestandardowych lub nierozpoznanych.
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")
Odczytywanie tabeli Head
Obiekt HeadTable przechowuje podstawowe parametry obejmujące całą czcionkę: jednostki na em, wersję, ramkę ograniczającą, datę utworzenia oraz flagi stylu. Te wartości są krytyczne dla silników renderujących i walidatorów czcionek.
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}")
Praca z tabelą Name
Obiekt NameTable zawiera wszystkie metadane czytelne dla człowieka: nazwę rodziny czcionki, styl, prawa autorskie, licencję, projektanta i opis. Możesz zapytać o rekordy według ID nazwy, pobrać zlokalizowane nazwy lub zmodyfikować wpisy w celu rebrandingu.
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")
Badanie tabeli CMap
Obiekt CmapTable mapuje punkty kodowe Unicode na identyfikatory glifów. Może zawierać wiele podtabel dla różnych kombinacji platformy i kodowania. Użyj best_subtable(), aby uzyskać najbardziej odpowiednie mapowanie dla swojego przypadku użycia.
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}")
Odczytywanie OS/2 i metryk poziomych
Obiekt Os2Table dostarcza OS/2 oraz specyficzne dla Windows metryki, w tym typograficzny ascender/descender, flagi osadzania i klasyfikację Panose. HheaTable i HmtxTable zapewniają metryki układu poziomego używane do kształtowania tekstu.
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}")
Kerning i dane glifów
KernTable przechowuje pary kerningu do regulacji poziomego odstępu. GlyfTable zawiera rzeczywiste dane konturów glifów dla czcionek TrueType. Możesz także użyć PostTable, aby rozwiązać nazwy glifów.
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}")
Szybki start
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}")
Obsługiwane formaty
| Format | Rozszerzenie | Odczyt | Zapis |
|---|---|---|---|
| TTF | .ttf | ✓ | ✓ |
| OTF | .otf | ✓ | ✓ |
| CFF | .cff | ✓ | ✓ |
| WOFF | .woff | ✓ | ✓ |
| WOFF2 | .woff2 | ✓ | ✓ |
| EOT | .eot | ✓ | — |
| TYPE1 | .pfb/.pfa | ✓ | — |
Open Source i licencjonowanie
Aspose.Font FOSS dla Python jest wydany na licencji MIT. Kod źródłowy jest dostępny na GitHub, a paczka jest opublikowana na PyPI jako aspose-font. Masz swobodę używać, modyfikować i rozpowszechniać go zarówno w projektach prywatnych, jak i komercyjnych, bez ograniczeń.
