Cómo convertir imágenes a PDF

This article was translated from English: Does it need improvement?
Translated
View the article in English

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 permite convertir una o varias imágenes en un PDF con una calidad únicacolocació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ñadirtexto y encabezados y pies de página HTML con IronPDF, aplicar marcas de agua con IronPDFPuede personalizar el tamaño de las páginas e incluir superposiciones de fondo y primer plano.

Comience con IronPDF

Comience a usar IronPDF en su proyecto hoy con una prueba gratuita.

Primer Paso:
green arrow pointer



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

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

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

Private imagePath As String = "meetOurTeam.jpg"

' Convert an image to a PDF
Private pdf As PdfDocument = ImageToPdfConverter.ImageToPdf(imagePath)

' Export the 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;

// 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");
Imports IronPdf
Imports System
Imports System.Collections.Generic
Imports System.IO
Imports System.Linq

' Retrieve all JPG and JPEG image paths in the 'images' folder.
Private imagePaths As IEnumerable(Of String) = Directory.EnumerateFiles("images").Where(Function(f) f.EndsWith(".jpg") OrElse f.EndsWith(".jpeg"))

' Convert images to a PDF
Private pdf As PdfDocument = ImageToPdfConverter.ImageToPdf(imagePaths)

' Export the 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";

// 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");
Imports IronPdf
Imports IronPdf.Imaging

Private imagePath As String = "meetOurTeam.jpg"

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

' Export the 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 un HTML <img> etiquetar 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,
    },
};

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

// Export the 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
	}
}

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

' Export the PDF
pdf.SaveAs("imageToPdfWithHeader.pdf")
VB   C#

Salida PDF

Si desea convertir o rasterizar un documento PDF en imágenes, consulte nuestra secciónguía sobre cómo rasterizar PDF a imágenes.

Chaknith related to Salida PDF

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.