fn_registry/python/functions/infra/pdf_add_text.md

name, kind, lang, domain, version, purity, signature, description, tags, uses_functions, uses_types, returns, returns_optional, error_type, imports, params, output, tested, tests, test_file_path, file_path

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

Ejemplo

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).