Controlar las fuentes y el estilo del texto con NextPDF Connect

De un vistazo

Crear un documento con varios estilos cambiando de fuente entre bloques de texto. set_font establece el tipo de letra, el estilo y el tamaño activos. Ese estado persiste en cada llamada posterior a add_text hasta que se cambie. Las herramientas necesarias son create_pdf, set_font, add_text y output_pdf, todas de Core. Los parámetros del estado de texto rigen cómo se representan los glifos (ISO 32000-2 §9).

Instalación

composer require nextpdf/server

Enlazar un transporte. Hay tres familias de fuentes integradas disponibles sin archivos de fuentes adicionales: helvetica, times y courier.

Visión conceptual

set_font recibe family, style ("", "B", "I", "BI", "U") y size. La fuente establecida se aplica a cada llamada posterior a add_text hasta el siguiente set_font. No hay restablecimiento automático. Cuando add_text incluye font_size, ese valor anula el tamaño activo solo para esa llamada, y el tamaño de set_font vuelve en la llamada siguiente. El texto lo emiten los operadores de presentación de texto en el orden del flujo de contenido (ISO 32000-2 §9.4). add_text no tiene un parámetro de color. El color del texto proviene del color de tinta del estado gráfico del documento.

Superficie de la API

Herramienta	Función	Nivel de riesgo
`create_pdf`	Abrir una sesión	Seguro
`set_font`	Establecer los valores activos de typeface/style/tamaño	Precaución
`add_text`	Escribir texto con la fuente activa	Precaución
`output_pdf`	Renderizar y devolver el PDF	Aprobación requerida / Revisión (base64)

El catálogo de herramientas es la referencia. Las herramientas disponibles dependen del nivel instalado.

Ejemplo de código: inicio rápido

create_pdf (A4 vertical) → document_id.
set_font (helvetica, B, 24) y luego add_text (título, centrado).
set_font (helvetica, "", 12) y luego add_text (cuerpo justificado).
set_font (courier, I, 10) y luego add_text (un fragmento de código).
output_pdf.

Ejemplo de código: producción

Establecer la fuente de forma explícita antes de cada bloque cuya tipografía sea relevante. No confiar nunca en el estado heredado entre secciones lógicas. Usar la anulación de font_size por llamada solo para énfasis puntuales, ya que no persiste. Construir sección por sección y verificar que cada add_text devuelva una position.

Casos límite y trampas

Familia desconocida. Cualquier valor fuera de helvetica/times/courier (por ejemplo arial) se rechaza.
Familia vacía. family debe ser una cadena no vacía.
Estilo no válido. Usar los códigos en mayúsculas. "bold" se rechaza.
Tamaño no positivo. size debe ser un número positivo.
El tamaño por llamada es temporal. No cambia el estado de set_font.

Rendimiento

Las fuentes integradas agregan muy poco peso, y la salida ocupa unos pocos KB. El perfil es structural.

Notas de seguridad

No hay efectos secundarios en el sistema de archivos en el modo base64. Las fuentes integradas no cargan archivos de fuentes externos, por lo que esta receta no expone una superficie de ataque asociada al análisis de fuentes.

Conformidad

Declaración	Especificación	Cláusula	reference_id
El texto se muestra mediante los operadores de texto en el orden del flujo.	ISO 32000-2	§9.4
Los parámetros del estado de texto rigen la representación de los glifos.	ISO 32000-2	§9

Contexto comercial

No aplica: todas las herramientas son Core.

Disponibilidad de transportes

Transporte	Disponible	Notas
MCP (stdio)	Sí	`tools/call` por herramienta.
REST	Sí	Una operación por herramienta.
gRPC	Sí	Una llamada unaria por herramienta.

Nivel de riesgo HITL

create_pdf Seguro; set_font/add_text Precaución; output_pdf Aprobación requerida, se degrada a Revisión en el modo base64 (niveles de riesgo HITL).

Contenedor JSON de la verificación de confirmación

Salida en base64:

{ "allowed": true }