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");

IRON VB CONVERTER ERROR developers@ironsoftware.com

¿Qué fuentes puedo utilizar?

El método DrawText admite actualmente todas las Fuentes estándar en IronPDF, incluidas 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 lograrlo, añade caracteres de nueva línea (\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);

IRON VB CONVERTER ERROR developers@ironsoftware.com

¿Cómo se utilizan las fuentes personalizadas?

Las fuentes personalizadas son compatibles con el método DrawText, lo que amplía las 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 página: Utilice 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, utilice valores RGB: Color.FromArgb(255, 100, 100)

El método DrawBitmap de IronPDF permite añadir 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");

IRON VB CONVERTER ERROR developers@ironsoftware.com

Resultado PDF

¿Qué parámetros adicionales hay disponibles?

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

• IgnorePageRotation: Esta propiedad bool determina si el método ignora la rotación de la página al dibujar el mapa de bits. Por defecto, el valor es false. 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 varias páginas o documentos de gran tamaño:

• 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

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