Alap betűtípus-kezelés

Alap betűtípus-kezelés

Ez az útmutató bemutatja, hogyan töltsünk be betűtípusokat fájlútvonalakból vagy bájt tömbökből, hogyan olvassuk el a metaadat-tulajdonságokat, hogyan térképezzük le a Unicode kódpontokat glif-azonosítókra, hogyan szerezzük be a glifeket, és hogyan dolgozzunk változó betűtípus tengelyekkel és névvel ellátott példányokkal.

FontLoader az elsődleges belépési pont minden betűtípus betöltési művelethez. Miután egy betűtípust betöltöttünk, a Font alaposztály hozzáférést biztosít a metaadatokhoz, a kódoláshoz, a glif eléréséhez és a metrikákhoz anélkül, hogy bináris tábla elemzést igényelne.

Betűtípusok betöltése

FontLoader.open(source, font_type, collection_index) betölt egy betűtípust fájlútvonalról automatikus formátumfelismeréssel. FontLoader.load(source, font_type, collection_index) nyers bájtokat fogad memóriában vagy hálózati munkafolyamatokhoz.

from aspose_font import FontLoader

# From a file path — format auto-detected
font = FontLoader.open("Roboto-Regular.ttf")

# From raw bytes — useful for in-memory or network workflows
with open("OpenSans-Regular.otf", "rb") as f:
    font = FontLoader.load(f.read())

Betűtípus metaadatok olvasása

Betöltés után a Font objektum font_name, font_family, font_style és num_glyphs tulajdonságokat tesz elérhetővé gyors áttekintéshez, anélkül hogy manuális táblaelemzést végezne.

from aspose_font import FontLoader

font = FontLoader.open("MyFont.ttf")
print(font.font_name)    # full PostScript name
print(font.font_family)  # family name
print(font.font_style)   # style name e.g. "Regular", "Bold"
print(font.num_glyphs)   # total glyph count

Glifkódolás

FontEncoding leképezi a Unicode kódpontokat a glifazonosítókra. Használja a unicode_to_gid(cp) egyetlen kódpont feloldásához, vagy a get_all_codepoints() a betűtípusban leképezett minden kódpont felsorolásához.

from aspose_font import FontLoader

font = FontLoader.open("OpenSans-Regular.otf")

# Map a single code point
gid = font.encoding.unicode_to_gid(0x41)  # GID for 'A'

# Enumerate all mapped code points
all_cps = font.encoding.get_all_codepoints()
print(f"Font covers {len(all_cps)} Unicode code points")

Glifhozzáférés

GlyphAccessor glifobjektumokat kér le ID, Unicode vagy szöveges karakterlánc alapján.

from aspose_font import FontLoader

font = FontLoader.open("OpenSans-Regular.otf")

glyph = font.glyph_accessor.get_glyph_by_id(gid)
glyph_a = font.glyph_accessor.get_glyph_by_unicode(0x41)
glyphs = font.glyph_accessor.get_glyphs_for_text("Hello")
all_ids = font.glyph_accessor.get_all_glyph_ids()

Változó betűtípusok

Változó betűtípusok esetén (amelyek fvar táblát tartalmaznak), a TtfFont közvetlenül elérhetővé teszi a tengelydefiníciókat és a névvel ellátott példányokat.

from aspose_font import FontLoader
from aspose_font import TtfFont

loaded = FontLoader.load("Roboto-VariableFont_wdth,wght.ttf")
ttf: TtfFont = loaded.font

# Check if the font is variable
if ttf.is_variable:
    # List all variation axes
    for axis in ttf.variable_axes:
        print(f"{axis.tag}  range: {axis.min_value}..{axis.max_value}  default: {axis.default_value}")

    # Look up a single axis by tag
    wght = ttf.get_axis("wght")
    if wght:
        print(f"Weight axis: {wght.min_value}..{wght.max_value}")

    # Enumerate named instances (e.g. Bold, Condensed)
    for inst in ttf.named_instances:
        print(f"Instance: name_id={inst.name_id}  coordinates={inst.coordinates}")

Magasabb szintű példányosítási munkafolyamatokhoz a SmartInstancer egyetlen objektumba foglalja a tengelyek felsorolását és a névvel ellátott példányok feloldását:

from aspose_font import FontLoader
from aspose_font import SmartInstancer

loaded = FontLoader.load("Roboto-VariableFont_wdth,wght.ttf")
instancer = SmartInstancer(loaded.font)

print(f"Axes: {[a.tag for a in instancer.axes]}")
print(f"Named instances: {len(instancer.named_instances)}")

Tippek és bevált gyakorlatok

• Gyorsítótárazza a betöltött Font objektumokat, amikor ugyanazt a betűtípusfájlt többször dolgozza fel
• Használja a FontLoader.load(bytes) -t hálózati vagy adatbázis munkafolyamatokhoz, hogy elkerülje az ideiglenes fájlokat
• Ellenőrizze a num_glyphs értékét a részhalmazolás előtt, hogy megbecsülje a részhalmaz utáni lefedettséget
• A get_all_glyph_ids() hasznos a teljes glifkészlet iterálásához

Gyakori problémák

FAQ

Támogatja a FontLoader a WOFF2-t?

Igen. A FontLoader.open() és a FontLoader.load() egyaránt elfogadja a WOFF2 fájlokat, és automatikusan felismeri a formátumot.

Betölthetek betűtípust egy URL-ről?

Nem közvetlenül. Töltsd le a betűtípus bájtjait a urllib vagy a requests segítségével, és add át őket a FontLoader.load(bytes) számára.

A betöltés szálbiztos?

Minden FontLoader.open() hívás egy független Font objektumot ad vissza. A különálló objektumokon történő egyidejű hívások biztonságosak.

API Reference összefoglaló

Lásd még:

• Aspose.Font — Enterprise Documentation