Gestire i font e lo stile del testo

In sintesi

Creare un documento con più stili modificando il font tra un blocco di testo e l’altro. set_font imposta il tipo di carattere, lo stile e la dimensione attivi. Questo stato persiste per ogni add_text successivo finché non viene modificato. Gli strumenti necessari sono create_pdf, set_font, add_text e output_pdf — tutti Core. I parametri di stato del testo governano il rendering dei glifi (ISO 32000-2 §9).

Installazione

composer require nextpdf/server

Associare un trasporto. Sono disponibili tre famiglie di font integrate senza file di font aggiuntivi: helvetica, times e courier.

Panoramica concettuale

set_font accetta family, style ("", "B", "I", "BI", "U") e size. Il font impostato si applica a ogni chiamata add_text successiva fino al set_font successivo. Non è previsto alcun reset automatico. Quando add_text include un font_size, tale valore sovrascrive la dimensione attiva solo per quella singola chiamata, mentre la dimensione di set_font torna ad applicarsi alla chiamata successiva. Il testo viene emesso dagli operatori di visualizzazione del testo nell’ordine del flusso di contenuto (ISO 32000-2 §9.4). add_text non ha un parametro di colore. Il colore del testo proviene dal colore dell’inchiostro nello stato grafico del documento.

Superficie API

Strumento	Ruolo	Livello di rischio
`create_pdf`	Aprire una sessione	Attenzione
`set_font`	Impostare typeface/style/size attivi	Attenzione
`add_text`	Scrivere testo nel font attivo	Attenzione
`output_pdf`	Generare e restituire il PDF	Approvazione richiesta / Revisione (base64)

Il catalogo degli strumenti è il catalogo di riferimento. Gli strumenti disponibili dipendono dal livello installato.

Esempio di codice — Avvio rapido

create_pdf (A4 verticale) → document_id.
set_font (helvetica, B, 24) poi add_text (titolo, centrato).
set_font (helvetica, "", 12) poi add_text (corpo giustificato).
set_font (courier, I, 10) poi add_text (uno snippet di codice).
output_pdf.

Esempio di codice — Produzione

Impostare esplicitamente il font prima di ogni blocco in cui la tipografia è rilevante. Non fare mai affidamento sullo stato ereditato tra sezioni logiche. Usare l’override font_size per singola chiamata solo per enfasi occasionali, poiché non persiste. Costruire il documento sezione per sezione e verificare che ogni add_text restituisca una position.

Casi limite e insidie

Famiglia sconosciuta. Qualsiasi valore diverso da helvetica/times/courier (per esempio arial) viene rifiutato.
Famiglia vuota. family deve essere una stringa non vuota.
Stile non valido. Usare i codici in maiuscolo. "bold" viene rifiutato.
Dimensione non positiva. size deve essere un numero positivo.
La dimensione per singola chiamata è temporanea. Non modifica lo stato di set_font.

Prestazioni

I font integrati aggiungono un overhead trascurabile e l’output è di pochi KB. Il profilo è structural.

Note di sicurezza

In modalità base64 non ci sono effetti collaterali sul filesystem. I font integrati non caricano alcun file di font esterno, quindi questa ricetta non espone alcuna superficie di attacco legata al parsing dei font.

Conformità

Dichiarazione	Specifica	Clausola
Il testo viene mostrato dagli operatori di testo nell’ordine del flusso.	ISO 32000-2	§9.4
I parametri di stato del testo governano il rendering dei glifi.	ISO 32000-2	§9

Contesto commerciale

Non applicabile — tutti gli strumenti sono Core.

Disponibilità del trasporto

Trasporto	Disponibile	Note
MCP (stdio)	Sì	`tools/call` per strumento.
REST	Sì	Un’operazione per strumento.
gRPC	Sì	Una chiamata unaria per strumento.

Livello di rischio HITL

create_pdf Attenzione; set_font/add_text Attenzione; output_pdf Approvazione richiesta, declassato a Revisione in modalità base64 (livelli di rischio HITL).

Envelope JSON per il gate di conferma

Output base64:

{ "allowed": true }