Bezeichnung
doc:LoadTTFont -- lädt eine TrueType-Schriftart aus einer Datei
Übersicht
font = doc:LoadTTFont(filename, embedding[, index])
Beschreibung
doc:LoadTTFont() lädt eine TrueType-Schriftart aus einer externen Datei und registriert sie im Dokumentobjekt. Wenn das optionale Argument index auf einen positiven Wert gesetzt ist, lädt dieser Befehl stattdessen die TrueType-Schriftart am angegebenen Index aus einer TrueType-Sammeldatei.

Wenn doc:LoadTTFont() erfolgreich ist, gibt er den Namen einer Schriftart zurück. Andernfalls wird Nil zurückgegeben und der Fehler-Handler wird aufgerufen.

Eingaben
filename
Pfad zu einer TrueType-Schriftart (.ttf) oder TrueType-Schriftartensammlung (.ttc)
embedding
wenn dieser Parameter auf True gesetzt ist, werden die Glyphendaten der Schriftart eingebettet, ansonsten werden nur die Matrixdaten in die PDF-Datei aufgenommen.
index
optional: Index der Schriftart, die aus der TrueType-Schriftartensammlung geladen werden soll (Voreingestellt ist -1).
Rückgabewerte
font
Name der Schriftart als Zeichenkette
Fehler
#HPDF_INVALID_DOCUMENT - Eine ungültige Dokument-Kennung wurde festgelegt.

#HPDF_FAILED_TO_ALLOC_MEM - Speicherzuordnung ist fehlgeschlagen.

#HPDF_FONT_EXISTS - Die gleichnamige Schriftart ist bereits registriert.

#HPDF_INVALID_TTC_INDEX - Der im Index-Parameter angegebene Wert überschreitet die Anzahl der Schriftarten.

#HPDF_INVALID_TTC_FILE - Die .ttc-Datei konnte nicht geladen werden.

#HPDF_TTF_INVALID_CMAP - Die .ttf-Datei konnte nicht geladen werden.

#HPDF_TTF_INVALID_FORMAT - Die .ttf-Datei konnte nicht geladen werden.

#HPDF_TTF_MISSING_TABLE - Die .ttf-Datei konnte nicht geladen werden.

#HPDF_TTF_CANNOT_EMBEDDING_FONT - Die Schriftart erlaubt keine Einbettung.

Navigation zeigen