Cómo convertir imágenes a PDF
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.
Cómo convertir imágenes a PDF
- Descargar la biblioteca C# para convertir imágenes en PDF
- Prepare la imagen o imágenes que desea convertir
- Proporcione la(s) ruta(s) de la(s) imagen(es) al
ImageToPdf
método estático - Ajuste la ubicación y el comportamiento de la imagen en el PDF de salida
- Añadir texto personalizado y encabezado y pie de página HTML
Instalar con NuGet
Install-Package IronPdf
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](/static-assets/pdf/how-to/image-to-pdf/meetOurTeam.jpg)
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")
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")
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")
Comparación de comportamientos de imagen
![]() Esquina superior izquierda de la página | ![]() Esquina superior derecha de la página |
![]() CentradoEnPágina | ![]() FitToPageAndMaintainAspectRatio |
![]() EsquinaInferiorIzquierdaDeLaPágina | ![]() Esquina inferior derecha de la página |
![]() FitToPage | ![]() CropPage |
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,
},
};
// 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")
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.