Cómo Dibujar Texto y Mapa de Bits en PDFs usando C

Comprensión del sistema de coordenadas

Antes de dibujar el texto, comprenda el sistema de coordenadas PDF. El origen (0,0) está situado en la esquina inferior izquierda de la página, con valores X que aumentan hacia la derecha y valores Y que aumentan hacia arriba. Esto difiere de muchos sistemas gráficos en los que el origen está en la parte superior izquierda.

:path=/static-assets/pdf/content-code-examples/how-to/draw-text-and-bitmap-draw-text.cs

using IronPdf;
using IronSoftware.Drawing;

ChromePdfRenderer renderer = new ChromePdfRenderer();
PdfDocument pdf = renderer.RenderHtmlAsPdf("<h1>testing</h1>");

// Draw text on PDF
pdf.DrawText("Some text", FontTypes.TimesNewRoman.Name, FontSize: 12, PageIndex: 0, X: 100, Y: 100, Color.Black, Rotation: 0);

pdf.SaveAs("drawText.pdf");

Imports IronPdf
Imports IronSoftware.Drawing

Dim renderer As New ChromePdfRenderer()
Dim pdf As PdfDocument = renderer.RenderHtmlAsPdf("<h1>testing</h1>")

' Draw text on PDF
pdf.DrawText("Some text", FontTypes.TimesNewRoman.Name, FontSize:=12, PageIndex:=0, X:=100, Y:=100, Color.Black, Rotation:=0)

pdf.SaveAs("drawText.pdf")

¿Qué fuentes puedo utilizar?

El método DrawText actualmente admite todas las Fuentes Estándar en IronPDF, incluyendo Courier, Arial (o Helvetica), TimesNewRoman, Symbol, y ZapfDingbats. Visita la sección de 'Fuentes Estándar en IronPDF' en el artículo Administrar Fuentes para variantes en cursiva, negrita y oblicua de estos tipos de fuente.

La fuente ZapfDingbats puede mostrar símbolos como ▲. Para obtener una lista completa de los símbolos compatibles, visite Wikipedia on Zapf Dingbats.

Muestra de fuentes de salida en PDF

¿Cómo puedo añadir texto con saltos de línea?

La acción de dibujar texto admite caracteres de nueva línea, permitiéndote renderizar texto con nuevas líneas incorporadas para mejorar el formato y la claridad visual. Esto resulta útil a la hora de añadir anotaciones multilínea o crear diseños de texto estructurados.

Para lograr esto, añade newline characters (\n) a la cadena de texto. Utilizando el ejemplo anterior:

// Multi-line text example with proper spacing
string textWithNewlines = "Some text\nSecond line\nThird line with more content";
pdfDoc.DrawText(textWithNewlines, font, position);

// You can also use Environment.NewLine for platform-specific line breaks
string platformText = $"Line 1{Environment.NewLine}Line 2{Environment.NewLine}Line 3";
pdfDoc.DrawText(platformText, font, position);

// Multi-line text example with proper spacing
string textWithNewlines = "Some text\nSecond line\nThird line with more content";
pdfDoc.DrawText(textWithNewlines, font, position);

// You can also use Environment.NewLine for platform-specific line breaks
string platformText = $"Line 1{Environment.NewLine}Line 2{Environment.NewLine}Line 3";
pdfDoc.DrawText(platformText, font, position);

' Multi-line text example with proper spacing
Dim textWithNewlines As String = "Some text" & vbLf & "Second line" & vbLf & "Third line with more content"
pdfDoc.DrawText(textWithNewlines, font, position)

' You can also use Environment.NewLine for platform-specific line breaks
Dim platformText As String = $"Line 1{Environment.NewLine}Line 2{Environment.NewLine}Line 3"
pdfDoc.DrawText(platformText, font, position)

¿Cómo se utilizan las fuentes personalizadas?

Las fuentes personalizadas son compatibles con el método DrawText, ampliando tus opciones tipográficas más allá de las fuentes estándar. Esta característica es esencial a la hora de mantener la coherencia de la marca o trabajar con fuentes especializadas. Para una gestión avanzada de las fuentes, consulte nuestra guía sobre gestión de fuentes en PDF.

A continuación se muestra un ejemplo con la fuente Pixelify Sans Font añadida para el texto:

:path=/static-assets/pdf/content-code-examples/how-to/draw-text-and-bitmap-draw-custom-font.cs

using IronPdf;
using IronSoftware.Drawing;
using System.IO;

ChromePdfRenderer renderer = new ChromePdfRenderer();
PdfDocument pdf = renderer.RenderHtmlAsPdf("<h1>testing</h1>");

// Add custom font to the PDF
byte[] fontByte = File.ReadAllBytes(@".\PixelifySans-VariableFont_wght.ttf");
var addedFont = pdf.Fonts.Add(fontByte);

// Draw text on PDF
pdf.DrawText("Iron Software", addedFont.Name, FontSize: 12, PageIndex: 0, X: 100, Y: 600, Color.Black, Rotation: 0);

pdf.SaveAs("drawCustomFont.pdf");

Imports IronPdf
Imports IronSoftware.Drawing
Imports System.IO

Private renderer As New ChromePdfRenderer()
Private pdf As PdfDocument = renderer.RenderHtmlAsPdf("<h1>testing</h1>")

' Add custom font to the PDF
Private fontByte() As Byte = File.ReadAllBytes(".\PixelifySans-VariableFont_wght.ttf")
Private addedFont = pdf.Fonts.Add(fontByte)

' Draw text on PDF
pdf.DrawText("Iron Software", addedFont.Name, FontSize:= 12, PageIndex:= 0, X:= 100, Y:= 600, Color.Black, Rotation:= 0)

pdf.SaveAs("drawCustomFont.pdf")

Posicionamiento avanzado del texto

A la hora de situar el texto con precisión, tenga en cuenta estos consejos:

• Dimensiones de la página: Usa pdf.Pages[pageIndex].Width y pdf.Pages[pageIndex].Height para obtener las dimensiones de la página
• Rotación: El parámetro de rotación acepta grados (0-360) para texto en ángulo
• Opciones de color: Más allá de los colores básicos, usa valores RGB: Color.FromArgb(255, 100, 100)

El método DrawBitmap de IronPDF te permite agregar mapas de bits a documentos PDF existentes. Este método funciona de forma similar a la función Image Stamper, que permite estampar imágenes en PDF existentes. Para necesidades complejas de manipulación de imágenes, explore nuestra guía sobre añadir imágenes a PDF.

Imagen de muestra

¿Cómo es la implementación?

:path=/static-assets/pdf/content-code-examples/how-to/draw-text-and-bitmap-draw-bitmap.cs

using IronPdf;
using IronSoftware.Drawing;

ChromePdfRenderer renderer = new ChromePdfRenderer();
PdfDocument pdf = renderer.RenderHtmlAsPdf("<h1>testing</h1>");

// Open the image from file
AnyBitmap bitmap = AnyBitmap.FromFile("ironSoftware.png");

// Draw the bitmp on PDF
pdf.DrawBitmap(bitmap, 0, 50, 250, 500, 300);

pdf.SaveAs("drawImage.pdf");

Imports IronPdf
Imports IronSoftware.Drawing

Dim renderer As New ChromePdfRenderer()
Dim pdf As PdfDocument = renderer.RenderHtmlAsPdf("<h1>testing</h1>")

' Open the image from file
Dim bitmap As AnyBitmap = AnyBitmap.FromFile("ironSoftware.png")

' Draw the bitmap on PDF
pdf.DrawBitmap(bitmap, 0, 50, 250, 500, 300)

pdf.SaveAs("drawImage.pdf")

Resultado PDF

¿Qué parámetros adicionales hay disponibles?

• Formato de píxel: La propiedad PixelFormat especifica el formato de datos de color para el mapa de bits, controlando principalmente el soporte de transparencia. El valor predeterminado es Format32bppArgb. Elige entre los formatos enum de píxel Format32bppRgb y Format32bppArgb pasando el parámetro como una opción. Esto es útil cuando se trabaja con elementos fondo y primer plano en PDF.

• IgnorarRotaciónDePágina: Esta propiedad bool determina si el método ignora la rotación de página al dibujar el mapa de bits. Por defecto, el valor es falso. Especialmente útil a la hora de aplicar marcas de agua de forma coherente a todas las páginas, independientemente de la rotación.

Casos de uso comunes y mejores prácticas

A la hora de dibujar texto e imágenes en PDF, tenga en cuenta estas aplicaciones prácticas:

1. Marcas de agua dinámicas: Añade logotipos de empresa o sellos "CONFIDENCIAL" a documentos confidenciales
2. Numeración de páginas: Dibuje los números de página en posiciones coherentes en todas las páginas
3. Colocación de firmas: Añade imágenes de firmas en los lugares designados de los formularios
4. Mejora de encabezados/pies de página: Complemente los encabezados existentes con contenido dinámico

Para depurar y supervisar las operaciones de PDF, implemente registro personalizado para realizar un seguimiento de las operaciones de dibujo y garantizar su correcta ejecución.

Consideraciones sobre el rendimiento

Al trabajar con múltiples páginas o documentos grandes:

• Operaciones por lotes cuando sea posible para minimizar el uso de memoria
• Desechar objetos de mapa de bits tras su uso para liberar recursos
• Considere la posibilidad de cargar previamente las imágenes de uso frecuente para mejorar el rendimiento

Código QR VeriFactu y sellos FNMT con DrawBitmap

El reglamento VeriFactu, gestionado por la AEAT para el control de la facturación electrónica, exige que cada factura incluya un código QR que permita al receptor verificar su autenticidad en el portal de la Agencia Tributaria. Este código QR, generado con los datos de la factura (número, NIF del emisor, importe e IVA), debe incrustarse visualmente en el PDF de la factura. Con DrawBitmap, es posible añadir el QR generado en un tamaño y posición adecuados —habitualmente en el pie de la primera página— garantizando que el documento PDF sea coherente con el XML VeriFactu firmado. Del mismo modo, los documentos que requieren el sello de un certificado FNMT (por ejemplo, notificaciones administrativas o comunicaciones con organismos públicos) pueden incluir la imagen del sello digital mediante DrawBitmap.

Estampado de NIF/CIF y sellos de estado con DrawText para cumplimiento AEAT

En los flujos de trabajo de back-office de empresas españolas, es habitual estampar el NIF o CIF de la empresa en documentos PDF internos para garantizar su trazabilidad ante posibles requerimientos de la AEAT. El método DrawText de IronPDF permite añadir el número de identificación fiscal en una posición reproducible dentro del documento. Además, sellos de texto como "PAGADO", "FACTURA" o "DUPLICADO" —que en el contexto fiscal español tienen valor probatorio cuando se aplican sobre facturas archivadas— pueden añadirse programáticamente con la fuente, el color y la rotación adecuados para cumplir con los estándares visuales aceptados por la AEAT en sus procedimientos de verificación documental.

El uso combinado de DrawText y DrawBitmap en IronPDF permite implementar todos los elementos visuales requeridos por VeriFactu, Facturae y los flujos de certificación FNMT, garantizando que los PDFs generados sean verificables y reconocidos por los sistemas de la AEAT.

¿Listo para ver qué más puedes hacer? Consulte nuestra página de tutoriales aquí: Editar PDFs