Cómo convertir imágenes a PDF

por Chaknith Bin

Convertir imágenes a PDF es un proceso útil que combina varios archivos de imagen (como JPG, PNG o TIFF) en un único documento PDF. Esto se hace a menudo para crear carteras digitales, presentaciones o informes, lo que facilita compartir y almacenar una colección de imágenes en un formato más organizado y universalmente legible.

IronPdf le permite convertir una o varias imágenes en un PDF con un único colocación de imágenes y comportamientos. Estos comportamientos incluyen el ajuste a la página, el centrado en la página y el recorte de la página. Además, puede añadir texto y encabezados y pies de página HTML, aplicar marcas de aguaPuede personalizar el tamaño de las páginas e incluir superposiciones de fondo y primer plano.


Biblioteca NuGet C# para PDF

Instalar con NuGet

Install-Package IronPdf
o
Java PDF JAR

Descargar DLL

Descargar DLL

Instalar manualmente en su proyecto

Convertir imagen a PDF Ejemplo

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 convertirá en un documento PDF con la ubicación y el comportamiento predeterminados de la imagen. Los formatos de imagen compatibles son .bmp, .jpeg, .jpg, .gif, .png, .svg, .tif, .tiff, .webp, .apng, .avif, .cur, .dib, .ico, .jfif, .jif, .jpe, .pjp y .pjpeg.

Imagen de muestra

Muestra de imágenes

Código

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

string imagePath = "meetOurTeam.jpg";

//  Convertir una imagen en un PDF
PdfDocument pdf = ImageToPdfConverter.ImageToPdf(imagePath);

//  Exportar el PDF
pdf.SaveAs("imageToPdf.pdf");
Imports IronPdf

Private imagePath As String = "meetOurTeam.jpg"

'  Convertir una imagen en un PDF
Private pdf As PdfDocument = ImageToPdfConverter.ImageToPdf(imagePath)

'  Exportar el PDF
pdf.SaveAs("imageToPdf.pdf")
VB   C#

Salida PDF


Convertir imágenes a PDF Ejemplo

Para convertir varias imágenes en un documento PDF, debe proporcionar un objeto IEnumerable que contenga rutas de archivo en lugar de una única ruta de archivo, como se muestra en nuestro ejemplo anterior. Esto generará de nuevo un documento PDF con la colocación y el comportamiento predeterminados de las imágenes.

: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;

//  Recupera todas las rutas de imágenes JPG y JPEG de la carpeta 'imágenes'.
IEnumerable<String> imagePaths = Directory.EnumerateFiles("images").Where(f => f.EndsWith(".jpg") || f.EndsWith(".jpeg"));

//  Convertir imágenes en PDF
PdfDocument pdf = ImageToPdfConverter.ImageToPdf(imagePaths);

//  Exportar el PDF
pdf.SaveAs("imagesToPdf.pdf");
Imports IronPdf
Imports System
Imports System.Collections.Generic
Imports System.IO
Imports System.Linq

'  Recupera todas las rutas de imágenes JPG y JPEG de la carpeta 'imágenes'.
Private imagePaths As IEnumerable(Of String) = Directory.EnumerateFiles("images").Where(Function(f) f.EndsWith(".jpg") OrElse f.EndsWith(".jpeg"))

'  Convertir imágenes en PDF
Private pdf As PdfDocument = ImageToPdfConverter.ImageToPdf(imagePaths)

'  Exportar el PDF
pdf.SaveAs("imagesToPdf.pdf")
VB   C#

Salida PDF


Colocación de imágenes y comportamientos

Para facilitar su uso, ofrecemos una serie de útiles opciones de colocación y comportamiento de las imágenes. Por ejemplo, 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 colocaciones y comportamientos de imagen disponibles son los siguientes:

  • **La imagen se coloca en la esquina superior izquierda de la página.
  • **La imagen se coloca en la esquina superior derecha de la pá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.
  • **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.
: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";

//  Convertir una imagen en un PDF con el comportamiento de imagen centrada en la página
PdfDocument pdf = ImageToPdfConverter.ImageToPdf(imagePath, ImageBehavior.CenteredOnPage);

//  Exportar el PDF
pdf.SaveAs("imageToPdf.pdf");
Imports IronPdf
Imports IronPdf.Imaging

Private imagePath As String = "meetOurTeam.jpg"

'  Convertir una imagen en un PDF con el comportamiento de imagen centrada en la página
Private pdf As PdfDocument = ImageToPdfConverter.ImageToPdf(imagePath, ImageBehavior.CenteredOnPage)

'  Exportar el PDF
pdf.SaveAs("imageToPdf.pdf")
VB   C#

Comparación de comportamientos de imagen

Coloque la imagen en la parte superior izquierda de la página
Coloque la imagen en la parte superior derecha de la página
Coloque la imagen en el centro de la página
Ajustar la imagen a la página manteniendo la relación de aspecto
Coloque la imagen en la parte inferior izquierda de la página
Coloque la imagen en la parte inferior derecha de la página
Estirar la imagen para ajustarla a la página
Recortar la página para ajustar la imagen

Aplicar opciones de renderizado

La clave para convertir varios tipos de imágenes en un documento PDF bajo el capó del método estático ImageToPdf es importar la imagen como una etiqueta HTML img y luego convertir el HTML a PDF. Esta es también la razón por la que podemos pasar el objeto ChromePdfRenderOptions como tercer parámetro del método ImageToPdf para personalizar directamente el proceso de renderizado.

: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,
    },
};

//  Convertir una imagen en un PDF con encabezado personalizado
PdfDocument pdf = ImageToPdfConverter.ImageToPdf(imagePath, options: options);

//  Exportar el PDF
pdf.SaveAs("imageToPdfWithHeader.pdf");
Imports IronPdf

Private imagePath As String = "meetOurTeam.jpg"

Private options As New ChromePdfRenderOptions() With {
	.HtmlHeader = New HtmlHeaderFooter() With {
		.HtmlFragment = "<h1 style='color: #2a95d5;'>Content Header</h1>",
		.DrawDividerLine = True
	}
}

'  Convertir una imagen en un PDF con encabezado personalizado
Private pdf As PdfDocument = ImageToPdfConverter.ImageToPdf(imagePath, options:= options)

'  Exportar el PDF
pdf.SaveAs("imageToPdfWithHeader.pdf")
VB   C#

Salida PDF

Si desea convertir o rasterizar un documento PDF en imágenes, consulte nuestra sección Cómo rasterizar un PDF a imagen artículo.

Chaknith Bin

Ingeniero de software

Chaknith es el Sherlock Holmes de los desarrolladores. La primera vez que se le ocurrió que podría tener futuro en la ingeniería de software fue cuando hacía retos de código por diversión. Su trabajo se centra en IronXL e IronBarcode, pero se enorgullece de ayudar a los clientes con todos los productos. Chaknith aprovecha sus conocimientos, adquiridos hablando directamente con los clientes, para ayudar a mejorar los propios productos. Sus comentarios anecdóticos van más allá de los tickets de Jira y apoyan el desarrollo de productos, la documentación y el marketing, para mejorar la experiencia general del cliente.Cuando no está en la oficina, se le puede encontrar aprendiendo sobre aprendizaje automático, codificación y senderismo.