How to Convert Images to a PDF

Exemple de conversion d'image en PDF

Utilisez la méthode statique ImageToPdf dans la classe ImageToPdfConverter pour convertir une image en un document PDF. Cette méthode nécessite uniquement le chemin du fichier de l'image, et elle le convertira en un document PDF avec le placement et le comportement d'image par défaut. Les formats d'image pris en charge incluent .bmp, .jpeg, .jpg, .gif, .png, .svg, .tif, .tiff, .webp, .apng, .avif, .cur, .dib, .ico, .jfif, .jif, .jpe, .pjp, et .pjpeg.

Exemple d'image

class="content-img-align-center">

style="width=50%">

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

Exemple de conversion d'images en PDF

Pour convertir plusieurs images en un document PDF, vous devez fournir un objet IEnumerable contenant les chemins de fichier au lieu d'un seul chemin de fichier, comme montré dans notre exemple précédent. Cela générera à nouveau un document PDF avec le placement et le comportement d'image par défaut.

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

Placements et comportements d'image

Pour faciliter l'utilisation, nous proposons une gamme d'options de placement et de comportement d'image utiles. Par exemple, vous pouvez centrer l'image sur la page ou l'adapter à la taille de la page tout en préservant son rapport d'aspect. Tous les placements et comportements d'image disponibles sont les suivants:

• TopLeftCornerOfPage : L'image est placée dans le coin supérieur gauche de la page.
• TopRightCornerOfPage : L'image est placée dans le coin supérieur droit de la page.
• CenteredOnPage : L'image est centrée sur la page.
• FitToPageAndMaintainAspectRatio : L'image s'adapte à la page tout en conservant son rapport d'aspect d'origine.
• BottomLeftCornerOfPage : L'image est placée dans le coin inférieur gauche de la page.
• BottomRightCornerOfPage : L'image est placée dans le coin inférieur droit de la page.
• FitToPage : L'image s'adapte à la page.
• CropPage : La page est ajustée pour s'adapter à l'image.

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

Comparaison des comportements d'image

class="content-img-align-center"> TopLeftCornerOfPage	class="content-img-align-center"> TopRightCornerOfPage
class="content-img-align-center"> CenteredOnPage	class="content-img-align-center"> FitToPageAndMaintainAspectRatio
class="content-img-align-center"> BottomLeftCornerOfPage	class="content-img-align-center"> BottomRightCornerOfPage
class="content-img-align-center"> FitToPage	class="content-img-align-center"> CropPage

---

Appliquer des options de rendu

La clé pour convertir divers types d'images en un document PDF sous l'approche de la méthode statique ImageToPdf est d'importer l'image en tant que balise HTML <img> puis de convertir le HTML en PDF. C'est également pour cela que nous pouvons passer l'objet ChromePdfRenderOptions en tant que troisième paramètre de la méthode ImageToPdf pour personnaliser directement le processus de rendu.

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