Lettertypen en tekststijlen beheren

In een oogopslag

Maak een document met meerdere tekststijlen door per tekstblok van lettertype te wisselen. set_font stelt het actieve lettertype, de stijl en de grootte in. Die status geldt voor elke volgende add_text-aanroep totdat je die wijzigt. Je hebt create_pdf, set_font, add_text en output_pdf nodig — allemaal Core-tools. Tekststatusparameters bepalen de weergave van glyphs (ISO 32000-2 §9).

Installatie

composer require nextpdf/server

Koppel een transportlaag. Je kunt drie ingebouwde lettertypefamilies gebruiken zonder lettertypebestanden toe te voegen: helvetica, times en courier.

Conceptueel overzicht

set_font accepteert family, style ("", "B", "I", "BI", "U") en size. Het lettertype dat je instelt, geldt voor elke latere add_text-aanroep totdat je set_font opnieuw aanroept. Er vindt geen automatische reset plaats. Als add_text een font_size bevat, overschrijft die waarde de actieve grootte alleen voor die ene aanroep. Daarna geldt de grootte van set_font weer voor de volgende aanroep. Tekst wordt weergegeven via text-showing-operatoren in de volgorde van de content-stream (ISO 32000-2 §9.4). add_text heeft geen kleurparameter. De tekstkleur wordt bepaald door de inktkleur van de graphics-state van het document.

API-oppervlak

Tool	Rol	Risiconiveau
`create_pdf`	Sessie openen	Voorzichtig
`set_font`	Actieve typeface/style/size instellen	Voorzichtig
`add_text`	Tekst in het actieve lettertype schrijven	Voorzichtig
`output_pdf`	De PDF weergeven en retourneren	Goedkeuring vereist / Review (base64)

De toolcatalogus is de gezaghebbende catalogus. De tools die je kunt gebruiken, zijn afhankelijk van het geïnstalleerde niveau.

Codevoorbeeld — Snelstart

create_pdf (A4 staand) → document_id.
set_font (helvetica, B, 24), gevolgd door add_text (titel, gecentreerd).
set_font (helvetica, "", 12), gevolgd door add_text (uitgevulde bodytekst).
set_font (courier, I, 10), gevolgd door add_text (een codefragment).
output_pdf.

Codevoorbeeld — Productie

Stel het lettertype expliciet in vóór elk blok waarvoor typografie belangrijk is. Vertrouw nooit op overgeërfde status tussen logische secties. Gebruik een font_size-override per aanroep alleen voor eenmalige nadruk, omdat die niet behouden blijft. Stel het document sectie voor sectie samen en controleer of elke add_text een position retourneert.

Randgevallen en valkuilen

Onbekende familie. Elke waarde buiten helvetica/times/courier (bijvoorbeeld arial) wordt afgewezen.
Lege familie. family moet een niet-lege string zijn.
Ongeldige stijl. Gebruik de hoofdlettercodes. "bold" wordt afgewezen.
Niet-positieve grootte. size moet een positief getal zijn.
De grootte per aanroep is tijdelijk. Die wijzigt de set_font-status niet.

Prestaties

Ingebouwde lettertypen voegen nauwelijks gewicht toe en de uitvoer blijft enkele KB. Het profiel is structural.

Beveiligingsnotities

De base64-modus heeft geen bijwerkingen op het bestandssysteem. Ingebouwde lettertypen laden geen externe lettertypebestanden, dus dit recipe heeft geen aanvalsoppervlak voor het parseren van lettertypen.

Conformiteit

Verklaring	Specificatie	Clausule
Tekst wordt weergegeven door tekstoperatoren in stream-volgorde.	ISO 32000-2	§9.4
Tekststatusparameters bepalen de weergave van glyphs.	ISO 32000-2	§9

Commerciële context

Niet van toepassing — alle tools zijn Core.

Beschikbaarheid van transportlagen

Transport	Beschikbaar	Opmerkingen
MCP (stdio)	Ja	`tools/call` per tool.
REST	Ja	Eén operatie per tool.
gRPC	Ja	Unary per tool.

HITL-risiconiveau

create_pdf Voorzichtig; set_font/add_text Voorzichtig; output_pdf Goedkeuring vereist, in de base64-modus verlaagd naar Review (HITL-risiconiveaus).

JSON-envelop van de bevestigingspoort

Base64-uitvoer:

{ "allowed": true }