Where does ImageToPdfConverter live in the IronPDF API?

ImageToPdfConverter is in the IronPdf namespace, shipped in IronPdf.dll.

What methods are available on ImageToPdfConverter?

Common methods include ImageToPdf, ImageToPdf, ImageToPdf, ImageToPdf. Use these on an instance to perform the corresponding IronPDF operation in C#.

Class ImageToPdfConverter

Q: What is the ImageToPdfConverter class used for in C#?

ImageToPdfConverter is the IronPDF class that converts images (PNG, JPG, BMP, GIF, TIFF, SVG) to professional PDF documents instantly. It is part of the IronPdf namespace and is used through the IronPDF C# API.

Converts images (PNG, JPG, BMP, GIF, TIFF, SVG) to professional PDF documents instantly. Perfect for digitizing scanned documents, photo albums, certificates, or creating image portfolios.

// Single image to PDF:
var pdf = ImageToPdfConverter.ImageToPdf("photo.jpg");
pdf.SaveAs("photo.pdf");

// Multiple images to multi-page PDF:
string[] images = { "page1.png", "page2.jpg", "page3.tiff" };
var document = ImageToPdfConverter.ImageToPdf(images);
document.SaveAs("album.pdf");

// From bitmap with custom behavior:
using (var bitmap = AnyBitmap.FromFile("scan.png")) {
    var pdf = ImageToPdfConverter.ImageToPdf(bitmap,
        Imaging.ImageBehavior.CropPage);  // Exact size
}

Supports 20+ image formats including PNG, JPG, GIF, BMP, TIFF, SVG, WebP

For PDF to image conversion, use PdfDocument.ToBitmap() instead

See: https://ironpdf.com/how-to/image-to-pdf/

Inheritance

System.Object

ImageToPdfConverter

Namespace: IronPdf

Assembly: IronPdf.dll

Syntax

public static class ImageToPdfConverter : Object

Working with PDF generation in IronPDF runs through ImageToPdfConverter. It represents converts images (PNG, JPG, BMP, GIF, TIFF, SVG) to professional PDF documents instantly.

ImageToPdfConverter matters when an application needs to configure or invoke PDF generation from C# code. The class encapsulates the related options and behavior in a single object that is set up once and reused across render or processing calls. Typical scenarios include batch generation pipelines, templated document workflows, and integration with existing C# document services.

To use ImageToPdfConverter, instantiate or obtain it from the relevant entry point in the IronPDF C# API. Key methods include ImageToPdf, ImageToPdf, ImageToPdf, ImageToPdf. Assign options or invoke methods on the instance to configure or perform the operation. The image to PDF covers typical usage in C# end to end.

using IronPdf;

// Obtain ImageToPdfConverter from the relevant entry point in the IronPDF API
void Configure(ImageToPdfConverter instance)
{
    instance.ImageToPdf();
}

For the broader workflow, see the image to PDF csharp example and the image to PDF guide in the IronPDF C# documentation. For broader context, the PDF generation portion of the IronPDF C# API contains related types that work with ImageToPdfConverter directly. ImageToPdfConverter exposes additional members beyond those highlighted above; the reference tables on this page list the full set. In application code, treat ImageToPdfConverter as a configured object that is constructed once and reused across operations rather than instantiated per call. Configuration is generally idempotent: assigning the same property value twice has the same effect as assigning it once. For diagnostic purposes, inspect the relevant ImageToPdfConverter property after each operation to confirm the configured state. See the constructors, properties, and methods tables below for the complete API surface of ImageToPdfConverter.

Methods

ImageToPdf(AnyBitmap, ImageBehavior, ChromePdfRenderOptions)

Converts in-memory bitmap images to PDF without file I/O for maximum performance. Essential for processing generated images, screenshots, or modified graphics.

// From generated chart:
using (var chart = GenerateChart()) {
    var pdf = ImageToPdfConverter.ImageToPdf(chart);
    pdf.SaveAs("chart-report.pdf");
}

// Process screenshot:
using (var screenshot = CaptureScreen()) {
    var pdf = ImageToPdfConverter.ImageToPdf(screenshot,
        Imaging.ImageBehavior.FitToPageAndMaintainAspectRatio);
    pdf.AddHeader("Screenshot taken: {date}");
    pdf.SaveAs("screenshot.pdf");
}

// Modified image:
using (var original = AnyBitmap.FromFile("original.jpg")) {
    // Apply modifications...
    var pdf = ImageToPdfConverter.ImageToPdf(original);
    pdf.SaveAs("modified.pdf");
}

Always dispose AnyBitmap objects to prevent memory leaks

CenteredOnPage default maintains original dimensions

Declaration

public static PdfDocument ImageToPdf(AnyBitmap image, ImageBehavior behavior, ChromePdfRenderOptions options = null)

Parameters

Type	Name	Description
IronSoftware.Drawing.AnyBitmap	image	The image object. Requires a project reference to the IronSoftware.System.Drawing Assembly.
ImageBehavior	behavior	Describes how image should be placed on the PDF page
ChromePdfRenderOptions	options	Rendering options

Returns

Type	Description
PdfDocument	Returns a PdfDocument document which can then be edited, saved or served over the web.

Exceptions

Type	Condition
System.NotSupportedException	The file does not have a supported image format. Supported files: .apng, .avif, .bmp, .cur, .dib, .gif, .ico, .jfif, .jif, .jpe, .jpeg, .jpg, .pjp, .pjpeg, .png, .svg, .tif, .tiff, .webp
System.IO.FileNotFoundException

ImageToPdf(IEnumerable<AnyBitmap>, ImageBehavior, ChromePdfRenderOptions)

Batch processes multiple in-memory bitmaps to create multi-page PDFs efficiently. Perfect for combining generated graphics, processed images, or dynamic visual content.

// Generate report with multiple charts:
var charts = new List<AnyBitmap>();
foreach (var dataset in datasets) {
    charts.Add(GenerateChart(dataset));
}
var report = ImageToPdfConverter.ImageToPdf(charts);
report.SaveAs("charts-report.pdf");
// Remember to dispose bitmaps
charts.ForEach(c => c.Dispose());

// Process batch of screenshots:
var screenshots = CaptureAllScreens();
using (var pdf = ImageToPdfConverter.ImageToPdf(screenshots,
    Imaging.ImageBehavior.FitToPageAndMaintainAspectRatio)) {
    pdf.AddWatermark("SCREEN CAPTURE");
    pdf.SaveAs("all-screens.pdf");
}

// Combine processed images:
var processed = images.Select(ApplyFilters).ToList();
var portfolio = ImageToPdfConverter.ImageToPdf(processed);

Use LINQ to transform images before conversion

Dispose all AnyBitmap objects after conversion to free memory

See: https://ironpdf.com/how-to/image-to-pdf/#in-memory-conversion

Declaration

public static PdfDocument ImageToPdf(IEnumerable<AnyBitmap> images, ImageBehavior behavior, ChromePdfRenderOptions options = null)

Parameters

Type	Name	Description
System.Collections.Generic.IEnumerable<IronSoftware.Drawing.AnyBitmap>	images	The image objects. Requires a project reference to the IronSoftware.System.Drawing Assembly.
ImageBehavior	behavior	Describes how image should be placed on the PDF page
ChromePdfRenderOptions	options	Rendering options

Returns

Type	Description
PdfDocument	Returns a PdfDocument document which can then be edited, saved or served over the web.

Exceptions

Type	Condition
System.NotSupportedException	The file does not have a supported image format. Supported files: .apng, .avif, .bmp, .cur, .dib, .gif, .ico, .jfif, .jif, .jpe, .jpeg, .jpg, .pjp, .pjpeg, .png, .svg, .tif, .tiff, .webp
System.IO.FileNotFoundException

ImageToPdf(IEnumerable<String>, ImageBehavior, ChromePdfRenderOptions)

Batch converts multiple images to a multi-page PDF document with one image per page. Ideal for creating photo albums, scanned document bundles, or presentation handouts.

// Create photo album:
var photos = Directory.GetFiles(@"C:\Photos", "*.jpg");
var album = ImageToPdfConverter.ImageToPdf(photos);
album.SaveAs("vacation-album.pdf");

// Combine scanned pages:
string[] scans = { "page1.tiff", "page2.tiff", "page3.tiff" };
var document = ImageToPdfConverter.ImageToPdf(scans,
    Imaging.ImageBehavior.CropPage);  // Preserve exact scan dimensions

// Mixed format portfolio:
var images = new[] { "cover.png", "chart.svg", "photo.jpg" };
var portfolio = ImageToPdfConverter.ImageToPdf(images);
portfolio.AddWatermark("CONFIDENTIAL");
portfolio.SaveAs("portfolio.pdf");

Page order matches input array order - pre-sort if needed

Large images may increase PDF size - consider compression

See: https://ironpdf.com/examples/image-to-pdf-csharp/

Declaration

public static PdfDocument ImageToPdf(IEnumerable<string> imageFileNames, ImageBehavior behavior, ChromePdfRenderOptions options = null)

Parameters

Type	Name	Description
System.Collections.Generic.IEnumerable<System.String>	imageFileNames	The image file path names.
ImageBehavior	behavior	Describes how image should be placed on the PDF page
ChromePdfRenderOptions	options	Rendering options

Returns

Type	Description
PdfDocument	Returns a PdfDocument document which can then be edited, saved or served over the web.

Exceptions

Type	Condition
System.NotSupportedException	The file does not have a supported image format. Supported files: .apng, .avif, .bmp, .cur, .dib, .gif, .ico, .jfif, .jif, .jpe, .jpeg, .jpg, .pjp, .pjpeg, .png, .svg, .tif, .tiff, .webp
System.IO.FileNotFoundException

ImageToPdf(String, ImageBehavior, ChromePdfRenderOptions)

Converts a single image file to a high-quality PDF document instantly. Automatically handles aspect ratio, orientation, and resolution for professional results.

// Simple conversion:
var pdf = ImageToPdfConverter.ImageToPdf("invoice-scan.jpg");
pdf.SaveAs("invoice.pdf");

// Custom page layout:
var options = new ChromePdfRenderOptions {
    PaperSize = PdfPaperSize.A4,
    MarginTop = 0, MarginBottom = 0,
    MarginLeft = 0, MarginRight = 0
};
var pdf = ImageToPdfConverter.ImageToPdf("certificate.png",
    Imaging.ImageBehavior.CropPage, options);

// Fit to page with margins:
var pdf = ImageToPdfConverter.ImageToPdf("diagram.svg",
    Imaging.ImageBehavior.FitToPageAndMaintainAspectRatio);

CropPage creates exact image dimensions, FitToPage uses standard paper sizes

SVG files are rendered at high quality regardless of size

Declaration

public static PdfDocument ImageToPdf(string imageFileName, ImageBehavior behavior, ChromePdfRenderOptions options = null)

Parameters

Type	Name	Description
System.String	imageFileName	File path of the image file.
ImageBehavior	behavior	Describes how image should be placed on the PDF page
ChromePdfRenderOptions	options	Rendering options

Returns

Type	Description
PdfDocument	Returns a PdfDocument document which can then be edited, saved or served over the web.

Exceptions

Type	Condition
System.NotSupportedException	The file does not have a supported image format. Supported files: .apng, .avif, .bmp, .cur, .dib, .gif, .ico, .jfif, .jif, .jpe, .jpeg, .jpg, .pjp, .pjpeg, .png, .svg, .tif, .tiff, .webp
System.IO.FileNotFoundException