Contrôler les polices et la mise en forme du texte avec NextPDF Connect

En bref

Construis un document combinant plusieurs styles en changeant de police d’un bloc de texte à l’autre. set_font définit la police, le style et la taille actuellement actifs. Cet état s’applique à chaque appel add_text suivant jusqu’à ce que tu le modifies. Les outils dont tu as besoin sont create_pdf, set_font, add_text et output_pdf — tous disponibles en Core. Les paramètres d’état de texte régissent la façon dont les glyphes sont rendus (ISO 32000-2 §9).

Installation

composer require nextpdf/server

Configure un transport lié. Trois familles de polices intégrées sont disponibles sans fichier de police supplémentaire : helvetica, times et courier.

Vue d’ensemble conceptuelle

set_font accepte family, style ("", "B", "I", "BI", "U") et size. La police que tu définis s’applique à chaque appel add_text ultérieur jusqu’au prochain set_font. Il n’y a aucune réinitialisation automatique. Lorsque add_text reçoit une font_size, cette valeur remplace la taille active pour ce seul appel, puis la taille définie par set_font s’applique de nouveau à l’appel suivant. Le texte est émis par les opérateurs d’affichage de texte dans l’ordre du flux de contenu (ISO 32000-2 §9.4). add_text n’a pas de paramètre de couleur. La couleur du texte provient de la couleur d’encre définie dans l’état graphique du document.

Surface de l’API

Outil	Rôle	Niveau de risque
`create_pdf`	Ouvrir la session	Sûr
`set_font`	Définir la police, le style et la taille actifs	Prudence
`add_text`	Écrire du texte dans la police active	Prudence
`output_pdf`	Effectuer le rendu et renvoyer le PDF	Approbation requise / Examen (base64)

Le catalogue d’outils est la référence. Les outils dont tu disposes dépendent de l’édition installée.

Exemple de code — Démarrage rapide

create_pdf (A4 portrait) → document_id.
set_font (helvetica, B, 24) puis add_text (titre, centré).
set_font (helvetica, "", 12) puis add_text (corps justifié).
set_font (courier, I, 10) puis add_text (un extrait de code).
output_pdf.

Exemple de code — Production

Définis explicitement la police avant chaque bloc dont la typographie compte. Ne te fie jamais à l’état hérité d’une section logique à une autre. N’utilise le remplacement font_size par appel que pour une mise en évidence ponctuelle, car il ne persiste pas. Construis le document section par section et vérifie que chaque add_text renvoie une position.

Cas limites et pièges

Famille inconnue. Toute valeur autre que helvetica/times/courier (par exemple arial) est rejetée.
Famille vide. family doit être une chaîne non vide.
Style invalide. Utilise les codes en majuscules. "bold" est rejeté.
Taille non positive. size doit être un nombre positif.
La taille par appel est temporaire. Elle ne modifie pas l’état de set_font.

Performances

Les polices intégrées n’ajoutent qu’un poids négligeable, et la sortie ne pèse que quelques Ko. Le profil est structural.

Notes de sécurité

Il n’y a aucun effet de bord sur le système de fichiers en mode base64. Les polices intégrées n’ingèrent aucun fichier de police externe, ce qui évite à cette recette d’exposer une surface d’attaque liée à l’analyse de polices.

Conformité

Énoncé	Spécification	Clause	reference_id
Le texte est affiché par les opérateurs de texte dans l’ordre du flux.	ISO 32000-2	§9.4
Les paramètres d’état de texte régissent le rendu des glyphes.	ISO 32000-2	§9

Contexte commercial

Sans objet — tous les outils sont disponibles en Core.

Disponibilité des transports

Transport	Disponible	Notes
MCP (stdio)	Oui	`tools/call` par outil.
REST	Oui	Une opération par outil.
gRPC	Oui	Appel unaire par outil.

Niveau de risque HITL

create_pdf Sûr ; set_font/add_text Prudence ; output_pdf Approbation requise, rétrogradé en Examen en mode base64 (niveaux de risque HITL).

Enveloppe JSON du verrou de confirmation

Sortie base64 :

{ "allowed": true }