Lay-outstatus inspecteren met NextPDF Connect

In een oogopslag

Inspecteer tijdens een sessie de lay-outstatus van een document, zodat je met vertrouwen beslissingen over positionering kunt nemen. preview_layout — opnieuw geverifieerd aan de hand van het tool-register van de server, waar PreviewLayoutTool de protocolnaam preview_layout beschikbaar stelt — is een alleen-lezen, idempotente query. De query rendert geen PDF, verplaatst de cursor niet en kan zo vaak als nodig worden aangeroepen. Al deze tools zijn Core: create_pdf, set_font, add_text, preview_layout, add_page en output_pdf.

Installeren

composer require nextpdf/server

Bind een transport. Je hebt geen licentie-edition nodig.

Conceptueel overzicht

preview_layout retourneert het aantal pagina’s, de huidige pagina, de pagina-afmetingen, de marges en de cursorpositie — de eigen geometrie-attributen van de pagina (ISO 32000-2 §7.7.3.3). Gebruik deze waarden om de resterende verticale ruimte te berekenen:

remaining = page_height - bottom_margin - cursor_y

Als remaining groter is dan de geschatte hoogte van je volgende blok, ga je verder op de huidige pagina. Roep anders eerst add_page aan. Omdat de aanroep alleen-lezen is, retourneert deze op elk transport een normale respons (PSR-18 §p2).

API-oppervlak

Tool	Rol	Risiconiveau
`create_pdf`	De sessie openen	Veilig
`set_font`	Het actieve lettertype instellen	Let op
`add_text`	Tekst schrijven, de cursor verplaatsen	Let op
`preview_layout`	Lay-outstatus lezen (geen mutatie)	Veilig
`add_page`	Een pagina toevoegen wanneer de ruimte opraakt	Let op
`output_pdf`	De PDF renderen en retourneren	Goedkeuring vereist / Controle (base64)

De toolcatalogus is de gezaghebbende bron. Welke tools je kunt gebruiken, hangt af van de geïnstalleerde edition.

Codevoorbeeld — Snelstart

create_pdf (Letter portrait) → document_id.
set_font (helvetica 14).
add_text ×3 (uitgevulde alinea’s).
preview_layout → lees page_dimensions, margins, cursor_position.
Bereken remaining; als die te klein is, add_page.
add_text (volgende sectie).
output_pdf.

Codevoorbeeld — Productie

Roep preview_layout aan vóór elk blok waarvan je niet zeker weet of het past. Beschouw de geretourneerde cursor als nauwkeurig voor de laatste schrijfactie. Als je het lettertype, de marges of de regelhoogte hebt gewijzigd sinds de laatste add_text, schrijf dan een korte testregel en voer de query opnieuw uit voordat je op de voorspelde positie vertrouwt.

Randgevallen en valkuilen

Verouderde cursor na een stijlwijziging. De gerapporteerde positie geeft de laatste schrijfactie weer, niet de openstaande statuswijzigingen. Test opnieuw als precisie belangrijk is.
Vernietigde sessie. preview_layout mislukt op een vernietigde document_id. Stel destroy: false in op de voorgaande output_pdf om de lay-out na de uitvoer te inspecteren.
Lege tekst of onbekend lettertype. Standaardfouten voor invoervalidatie zijn van toepassing.

Prestaties

preview_layout is een goedkope leesactie. Het profiel voor het geproduceerde document is structural.

Beveiligingsnotities

De query is alleen-lezen en heeft geen bijwerking. De geretourneerde coördinaten zijn niet gevoelig, maar behandel ze als sessiegebonden.

Conformiteit

Bewering	Specificatie	Clausule	reference_id
Een page-object definieert zijn geometrie-attributen.	ISO 32000-2	§7.7.3.3
Een alleen-lezen-query retourneert een normale transportrespons.	PSR-18	§p2

Commerciële context

Niet van toepassing — alle tools zijn Core.

Transportbeschikbaarheid

Transport	Beschikbaar	Notities
MCP (stdio)	Ja	`preview_layout` is een `tools/call`.
REST	Ja	Een veilige bewerking in GET-stijl.
gRPC	Ja	Unair; idempotent.

HITL-risiconiveau

preview_layout is Safe (alleen-lezen) en blokkeert nooit. create_pdf is Safe. set_font, add_text en add_page zijn Caution. output_pdf is Approval Required, in base64-modus afgewaardeerd tot Review (HITL-risiconiveaus).

JSON-envelop van de bevestigingsgate

Alleen-lezen-inspectie blokkeert nooit:

{ "allowed": true }