---
name: pdf_add_text
kind: function
lang: py
domain: infra
version: "1.0.0"
purity: impure
signature: "def pdf_add_text(doc, text, style, x, y, width) -> PDFDoc"
description: "Escribe un bloque de texto en el documento PDF con fuente, tamaño, color y alineacion del PDFStyle dado. Soporta saltos de linea y word wrap automatico."
tags: [pdf, text, typography, builder, infra]
uses_functions: []
uses_types: [pdf_doc_py_infra, pdf_style_py_infra]
returns: [pdf_doc_py_infra]
returns_optional: false
error_type: "error_go_core"
imports: []
params:
  - name: doc
    desc: "PDFDoc con al menos una pagina activa"
  - name: text
    desc: "texto a escribir; soporta \\n para saltos de linea"
  - name: style
    desc: "PDFStyle con fuente, tamaño, color, alineacion; None usa defaults (Helvetica 12pt negro)"
  - name: x
    desc: "posicion X en mm desde el borde izquierdo; None mantiene posicion actual"
  - name: y
    desc: "posicion Y en mm desde el borde superior; None mantiene posicion del cursor"
  - name: width
    desc: "ancho del bloque en mm; None usa el ancho disponible entre margenes"
output: "PDFDoc con el texto añadido en la pagina activa"
tested: true
tests: ["texto simple con estilo defecto", "texto con estilo personalizado bold centrado", "texto multilinea con saltos"]
test_file_path: "python/functions/infra/pdf_add_text_test.py"
file_path: "python/functions/infra/pdf_add_text.py"
---

## Ejemplo

```python
from pdf_style import PDFStyle

titulo = PDFStyle(font_family="Helvetica-Bold", font_size=18.0, alignment="center")
cuerpo = PDFStyle(font_size=11.0, alignment="justify", margin_bottom=4.0)

doc = pdf_add_text(doc, "Informe Mensual", style=titulo)
doc = pdf_add_text(doc, "Este reporte resume las ejecuciones de Abril 2026.", style=cuerpo)
```

## Notas

Usa `multi_cell` internamente para soportar word wrap automatico y saltos de linea `\n`. La altura de linea se calcula en mm a partir de `font_size * line_height`. Las fuentes built-in soportan variantes `-Bold`, `-Oblique`, `-BoldOblique` en el nombre de `font_family` (se separan internamente para fpdf2).
