How to Work with TTF Fonts in Python

TrueType fonts (.ttf) are the most common font format. Aspose.Font FOSS for Python loads them as TtfFont instances, giving access to tables, variable font axes, glyph data, and conversion utilities.

Step-by-Step Guide

Step 1: Install the Package

pip install "aspose-font>=1.0.0"

Step 2: Import Required Classes

from aspose_font.loader import FontLoader
from aspose_font.ttf.font import TtfFont

Step 3: Load and Inspect a TTF Font

ttf_font: TtfFont = FontLoader.open("Roboto-Regular.ttf")
print(ttf_font.font_name)
print(ttf_font.font_family)
print(ttf_font.num_glyphs)

Step 4: Read the kern Table

ttf_font: TtfFont = FontLoader.open("Roboto-Regular.ttf")
kern = ttf_font.ttf_tables.kern
print("kern present:", kern is not None)

Step 5: Instantiate a Variable Font

from aspose_font.loader import FontLoader
from aspose_font.ttf.font import TtfFont

ttf_font: TtfFont = FontLoader.open("Roboto-VariableFont_wdth,wght.ttf")
if ttf_font.is_variable:
    static = ttf_font.instantiate({"wght": 700.0})
    print("Instantiated:", static.font_name)

Step 6: Convert to WOFF2

from aspose_font.loader import FontLoader
from aspose_font.converter import FontConverter
from aspose_font import FontType

font = FontLoader.open("Roboto-Regular.ttf")
woff2 = FontConverter.convert(font, FontType.WOFF2)

Common Issues and Fixes

AttributeError: Font has no attribute ttf_tables — Use ttf_font: TtfFont = FontLoader.open(...). The ttf_tables property is on TtfFont, not the base Font.

is_variable is False on a variable font — Some variable fonts use a non-standard fvar table format. Check ttf_font.fvar is not None as an alternative.

instantiate() raises KeyError — The axis tag must be a registered 4-char tag (e.g. "wght", "wdth"). Check ttf_font.axes for available tags.

Frequently Asked Questions

What is the difference between TTF and OTF?

OTF and TTF share the same binary container (SFNT). OTF fonts typically use CFF outlines while TTF fonts use TrueType quadratic curves. Both are loaded by FontLoader.open().

Can I get kern pairs from a TTF font?

Yes. Use TtfFont.get_kern_pairs() to get a list of KernPair objects.

Does the library support font collections (.ttc)?

Yes. Use FontLoader.open(source, collection_index=N) to select a specific font from a TTC collection file.