Lettertypen en tekststijlen beheren via NextPDF Connect

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	Veilig
`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	reference_id
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 Veilig; 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 }