Schriftarten und Typografie mit NextPDF Connect steuern

Auf einen Blick

Erstellen Sie ein Dokument mit variierender Typografie, indem Sie zwischen Textblöcken die Schriftarten wechseln. set_font legt die aktive Schriftart, den Stil und die Größe fest. Dieser Zustand bleibt für alle folgenden add_text-Aufrufe erhalten, bis Sie ihn ändern. Die benötigten Tools sind create_pdf, set_font, add_text und output_pdf — allesamt Core. Die Textzustandsparameter bestimmen, wie Glyphen gerendert werden (ISO 32000-2 §9).

Installation

composer require nextpdf/server

Binden Sie einen Transport. Drei integrierte Schriftfamilien stehen ohne zusätzliche Schriftdateien zur Verfügung: helvetica, times und courier.

Konzeptioneller Überblick

set_font erwartet family, style ("", "B", "I", "BI", "U") und size. Die gesetzte Schriftart gilt für alle späteren add_text-Aufrufe bis zum nächsten set_font-Aufruf. Es gibt kein automatisches Zurücksetzen. Wenn add_text eine font_size enthält, überschreibt dieser Wert die aktive Größe nur für diesen einen Aufruf; danach gilt wieder die set_font-Größe. Text wird von textanzeigenden Operatoren in der Reihenfolge des Content-Streams ausgegeben (ISO 32000-2 §9.4). add_text hat keinen Farbparameter. Die Textfarbe ergibt sich aus der im Grafikzustand des Dokuments gesetzten Tintenfarbe.

API-Oberfläche

Tool	Rolle	Risikostufe
`create_pdf`	Sitzung öffnen	Sicher
`set_font`	Aktive typeface/style/Größe festlegen	Vorsicht
`add_text`	Text in der aktiven Schriftart schreiben	Vorsicht
`output_pdf`	PDF rendern und zurückgeben	Genehmigung erforderlich / Prüfung (base64)

Der Tool-Katalog ist die maßgebliche Übersicht. Welche Tools Ihnen zur Verfügung stehen, hängt von der installierten Edition ab.

Codebeispiel — Schnellstart

create_pdf (A4-Hochformat) → document_id.
set_font (helvetica, B, 24), dann add_text (Titel, zentriert).
set_font (helvetica, "", 12), dann add_text (Fließtext im Blocksatz).
set_font (courier, I, 10), dann add_text (ein Code-Snippet).
output_pdf.

Codebeispiel — Produktion

Setzen Sie die Schriftart explizit vor jedem Block, bei dem die Typografie relevant ist. Verlassen Sie sich niemals auf einen über logische Abschnitte hinweg geerbten Zustand. Verwenden Sie das font_size-Override pro Aufruf nur für einmalige Hervorhebungen, da es nicht fortbesteht. Erstellen Sie das Dokument Abschnitt für Abschnitt und prüfen Sie, ob jeder add_text-Aufruf eine position zurückgibt.

Grenzfälle & Fallstricke

Unbekannte Familie. Alles außerhalb von helvetica/times/courier (zum Beispiel arial) wird abgelehnt.
Leere Familie. family muss eine nicht-leere Zeichenkette sein.
Ungültiger Stil. Verwenden Sie die Großbuchstabencodes. "bold" wird abgelehnt.
Nicht-positive Größe. size muss eine positive Zahl sein.
Die Größe pro Aufruf ist temporär. Sie verändert den set_font-Zustand nicht.

Performance

Integrierte Schriftarten erhöhen die Dateigröße nur vernachlässigbar, und die Ausgabe umfasst nur wenige KB. Das Profil ist structural.

Sicherheitshinweise

Im base64-Modus gibt es keine Dateisystemauswirkung. Da integrierte Schriftarten keine externen Schriftdateien einlesen, hat dieses Rezept keine Angriffsfläche durch Font-Parsing.

Konformität

Aussage	Spezifikation	Klausel	reference_id
Text wird von Textoperatoren in Stream-Reihenfolge angezeigt.	ISO 32000-2	§9.4
Textzustandsparameter bestimmen das Glyphen-Rendering.	ISO 32000-2	§9

Kommerzieller Kontext

Nicht zutreffend — alle Tools gehören zu Core.

Transport-Verfügbarkeit

Transport	Verfügbar	Hinweise
MCP (stdio)	Ja	`tools/call` pro Tool.
REST	Ja	Eine Operation pro Tool.
gRPC	Ja	Unärer Aufruf pro Tool.

HITL-Risikostufe

create_pdf Sicher; set_font/add_text Vorsicht; output_pdf Genehmigung erforderlich, im base64-Modus auf Prüfung herabgestuft (HITL-Risikostufen).

JSON-Umschlag des Bestätigungs-Gates

Base64-Ausgabe:

{ "allowed": true }