Konvertieren von Bildern in eine PDF-Datei

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

von Chaknith Bin

Die Umwandlung von Bildern in PDF ist ein nützlicher Prozess, der mehrere Bilddateien kombiniert(wie JPG, PNG oder TIFF) in ein einziges PDF-Dokument. Dies geschieht häufig, um digitale Portfolios, Präsentationen oder Berichte zu erstellen, was die gemeinsame Nutzung und Speicherung einer Sammlung von Bildern in einem besser organisierten und allgemein lesbaren Format erleichtert.

IronPDF ermöglicht die Konvertierung eines einzelnen oder mehrerer Bilder in ein PDF-Dokument mit eindeutigenbildplatzierungen und Verhaltensweisen. Dazu gehören die Anpassung an die Seite, das Zentrieren auf der Seite und das Beschneiden der Seite. Außerdem können Sie Folgendes hinzufügentext und HTML-Kopf- und Fußzeilen mit IronPDF, wasserzeichen mit IronPDF anwenden, benutzerdefinierte Seitengrößen festlegen und Hintergrund- und Vordergrund-Overlays einfügen.

Erste Schritte mit IronPDF

Beginnen Sie noch heute mit der Verwendung von IronPDF in Ihrem Projekt mit einer kostenlosen Testversion.

Erster Schritt:
green arrow pointer



Bild in PDF konvertieren Beispiel

Verwenden Sie die statische Methode "ImageToPdf" innerhalb der Klasse ImageToPdfConverter, um ein Bild in ein PDF-Dokument zu konvertieren. Diese Methode erfordert nur den Dateipfad zum Bild und konvertiert es in ein PDF-Dokument mit Standardbildplatzierung und -verhalten. Unterstützte Bildformate sind .bmp, .jpeg, .jpg, .gif, .png, .svg, .tif, .tiff, .webp, .apng, .avif, .cur, .dib, .ico, .jfif, .jif, .jpe, .pjp und .pjpeg.

Beispielbild

Bildbeispiel

Code

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

Ausgabe PDF


Bilder in PDF konvertieren Beispiel

Um mehrere Bilder in ein PDF-Dokument zu konvertieren, sollten Sie ein IEnumerable-Objekt bereitstellen, das Dateipfade anstelle eines einzelnen Dateipfades enthält, wie in unserem vorherigen Beispiel gezeigt. Dadurch wird wieder ein PDF-Dokument mit Standardbildplatzierung und -verhalten erzeugt.

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

Ausgabe PDF


Bildplatzierungen und Verhaltensweisen

Um die Nutzung zu erleichtern, bieten wir eine Reihe hilfreicher Optionen für die Bildplatzierung und das Verhalten. So können Sie beispielsweise das Bild auf der Seite zentrieren oder an die Seitengröße anpassen, wobei das Seitenverhältnis beibehalten wird. Alle verfügbaren Bildplatzierungen und Verhaltensweisen sind wie folgt:

  • TopLeftCornerOfPage: Das Bild wird in der linken oberen Ecke der Seite platziert.
  • TopRightCornerOfPage: Das Bild wird in der oberen rechten Ecke der Seite platziert.
  • CenteredOnPage: Das Bild wird auf der Seite zentriert.
  • FitToPageAndMaintainAspectRatio: Das Bild passt sich der Seite an und behält dabei sein ursprüngliches Seitenverhältnis bei.
  • BottomLeftCornerOfPage: Das Bild wird in der linken unteren Ecke der Seite platziert.
  • BottomRightCornerOfPage: Das Bild wird in der rechten unteren Ecke der Seite platziert.
  • FitToPage: Das Bild passt auf die Seite.
  • CropPage: Die Seite wird an das Bild angepasst.
: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#

Vergleich der Bildverhaltensweisen

Platzieren Sie das Bild oben links auf der Seite
Platzieren Sie das Bild oben rechts auf der Seite
Platzieren Sie das Bild in der Mitte der Seite
Einpassen des Bildes in die Seite unter Beibehaltung des Seitenverhältnisses
Platzieren Sie das Bild unten links auf der Seite
Platzieren Sie das Bild unten rechts auf der Seite
Das Bild an die Seite anpassen
Beschneiden Sie die Seite, um das Bild anzupassen

Rendering-Optionen anwenden

Der Schlüssel zur Konvertierung verschiedener Bildtypen in ein PDF-Dokument unter der Haube der statischen Methode ImageToPdf ist der Import des Bildes als HTML <img>tag und konvertieren Sie dann das HTML in PDF. Das ist auch der Grund, warum wir das **ChromePdfRenderOptions**-Objekt als dritten Parameter der MethodeImageToPdf` übergeben können, um den Rendering-Prozess direkt anzupassen.

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

Ausgabe PDF

Wenn Sie ein PDF-Dokument in Bilder konvertieren oder rastern möchten, lesen Sie bitte unsereanleitung zur Rasterisierung von PDFs in Bilder.

Chaknith related to Ausgabe PDF

Chaknith Bin

Software-Ingenieur

Chaknith ist der Sherlock Holmes der Entwickler. Zum ersten Mal kam ihm der Gedanke, dass er eine Zukunft in der Softwareentwicklung haben könnte, als er zum Spaß an Code Challenges teilnahm. Sein Schwerpunkt liegt auf IronXL und IronBarcode, aber er ist stolz darauf, Kunden mit jedem Produkt zu helfen. Chaknith nutzt sein Wissen aus direkten Gesprächen mit Kunden, um die Produkte selbst weiter zu verbessern. Sein anekdotisches Feedback geht über Jira-Tickets hinaus und unterstützt die Produktentwicklung, die Dokumentation und das Marketing, um das Gesamterlebnis der Kunden zu verbessern.Wenn er nicht im Büro ist, lernt er über maschinelles Lernen, programmiert und wandert.