Cómo convertir imágenes a PDF en C#

¿Cómo convierto una sola imagen a PDF?

Utilice el método estático ImageToPdf de la clase ImageToPdfConverter para convertir una imagen en un documento PDF. Este método sólo requiere la ruta de archivo de la imagen y la convierte en un documento PDF con la ubicación y el comportamiento predeterminados de la imagen. Los formatos de imagen compatibles incluyen .bmp, .jpeg, .jpg, .gif, .png, .svg, .tif, .tiff, .webp, .apng, .avif, .cur, .dib, .ico, .jfif, .jif, .jpe, .pjp y .pjpeg.

Antes de empezar, asegúrese de haber instalado IronPDF a través de NuGet o descargado el instalador de Windows. La biblioteca funciona sin problemas en las plataformas Windows, macOS y Linux, lo que la hace versátil para diversos entornos de desarrollo.

¿Qué formatos de imagen se admiten?

IronPDF admite una amplia gama de formatos de imagen, incluidos formatos de trama como JPEG, PNG, BMP y GIF, así como formatos vectoriales como gráficos SVG. La biblioteca maneja formatos estándar y modernos como WebP y AVIF, lo que garantiza la compatibilidad con las aplicaciones web contemporáneas. Para necesidades especializadas, trabaje con archivos de iconos (.ico) y archivos de cursor (.cur).

:path=/static-assets/pdf/content-code-examples/how-to/image-to-pdf-convert-one-image.cs

using IronPdf;

string imagePath = "meetOurTeam.jpg";

// Convert an image to a PDF
PdfDocument pdf = ImageToPdfConverter.ImageToPdf(imagePath);

// Export the PDF
pdf.SaveAs("imageToPdf.pdf");

¿Cómo convertir varias imágenes a PDF?

Para convertir varias imágenes en un documento PDF, proporcione un objeto IEnumerable que contenga rutas de archivo en lugar de una única ruta de archivo. Esto genera un documento PDF con la colocación y el comportamiento de las imágenes por defecto.

Cuando trabaje con varias imágenes, tenga en cuenta las opciones de compresión de PDF disponibles para optimizar el tamaño del archivo sin sacrificar la calidad. Esto es especialmente importante a la hora de crear grandes portafolios o álbumes de fotos.

:path=/static-assets/pdf/content-code-examples/how-to/image-to-pdf-convert-multiple-images.cs

using IronPdf;
using System;
using System.Collections.Generic;
using System.IO;
using System.Linq;

// Retrieve all JPG and JPEG image paths in the 'images' folder.
IEnumerable<String> imagePaths = Directory.EnumerateFiles("images").Where(f => f.EndsWith(".jpg") || f.EndsWith(".jpeg"));

// Convert images to a PDF
PdfDocument pdf = ImageToPdfConverter.ImageToPdf(imagePaths);

// Export the PDF
pdf.SaveAs("imagesToPdf.pdf");

¿Cómo puedo controlar la colocación y el comportamiento de las imágenes?

IronPDF ofrece varias opciones de colocación y comportamiento de las imágenes. Puede centrar la imagen en la página o ajustarla al tamaño de la página manteniendo su relación de aspecto. Todas las imágenes y comportamientos disponibles son:

• Esquina superior izquierda de la página: La imagen se coloca en la esquina superior izquierda de la página.
• Esquina superior derecha de la página: La imagen se coloca en la esquina superior derecha de la página.
• CentradoEnPágina: La imagen está centrada en la página.
• FitToPageAndMaintainAspectRatio: La imagen se ajusta a la página manteniendo su relación de aspecto original.
• EsquinaInferiorIzquierdaDeLaPágina: La imagen se coloca en la esquina inferior izquierda de la página.
• Esquina inferior derecha de la página: La imagen se coloca en la esquina inferior derecha de la página.
• FitToPage: La imagen se ajusta a la página.
• CropPage: La página se ajusta para adaptarse a la imagen.

Estas opciones de colocación funcionan a la perfección con las funciones orientación y rotación de página de IronPDF, lo que permite crear documentos de aspecto profesional independientemente de las dimensiones de la imagen.

:path=/static-assets/pdf/content-code-examples/how-to/image-to-pdf-convert-one-image-image-behavior.cs

using IronPdf;
using IronPdf.Imaging;

string imagePath = "meetOurTeam.jpg";

// Convert an image to a PDF with image behavior of centered on page
PdfDocument pdf = ImageToPdfConverter.ImageToPdf(imagePath, ImageBehavior.CenteredOnPage);

// Export the PDF
pdf.SaveAs("imageToPdf.pdf");

¿Cuáles son las diferencias visuales entre los comportamientos de imagen?

Esquina superior izquierda de la página	Esquina superior derecha de la página
CentradoEnPágina	FitToPageAndMaintainAspectRatio
EsquinaInferiorIzquierdaDeLaPágina	EsquinaInferiorDerechaDeLaPágina
FitToPage	CropPage

---

¿Cómo personalizar las opciones de renderizado de PDF?

El método estático ImageToPdf convierte imágenes importándolas como etiquetas HTML <img> y luego convirtiendo el HTML a PDF. Esto permite pasar el objeto ChromePdfRenderOptions como tercer parámetro para personalizar directamente el proceso de renderizado.

Este enfoque proporciona acceso a todas las potentes opciones de renderizado disponibles en IronPDF, incluida la ejecución de JavaScript, los tipos de medios CSS y la configuración de la ventana gráfica. Incluso puede incorporar fuentes e iconos web para mejorar el atractivo visual del documento.

:path=/static-assets/pdf/content-code-examples/how-to/image-to-pdf-convert-one-image-rendering-options.cs

using IronPdf;

string imagePath = "meetOurTeam.jpg";

ChromePdfRenderOptions options = new ChromePdfRenderOptions()
{
    HtmlHeader = new HtmlHeaderFooter()
    {
        HtmlFragment = "<h1 style='color: #2a95d5;'>Content Header</h1>",
        DrawDividerLine = true,
    },
};

// Convert an image to a PDF with custom header
PdfDocument pdf = ImageToPdfConverter.ImageToPdf(imagePath, options: options);

// Export the PDF
pdf.SaveAs("imageToPdfWithHeader.pdf");