Skip to content

1043654-d: Added Vector Image Support for Cross-Platform .NET Using Syncfusion.MetafileRenderer.Net.Core #3904

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
GowthamrajKumar25 merged 5 commits into from
Jul 28, 2026
+69 −24
Merged

1043654-d: Added Vector Image Support for Cross-Platform .NET Using Syncfusion.MetafileRenderer.Net.Core #3904

Changes from all commits
Commits
Show all changes
5 commits
Select commit Hold shift + click to select a range
a650c8e
1043654-d: Added Vector Image Support for Cross-Platform .NET Using S…
sameerkhan001 Jul 27, 2026
59a9885
1043654-d: Added
sameerkhan001 Jul 27, 2026
cd7089a
Merge branch 'development' of https://github.com/syncfusion-content/d…
sameerkhan001 Jul 27, 2026
47941a7
1043654-d: Resolved feedback
sameerkhan001 Jul 28, 2026
e79ecac
Merge branch 'development' of https://github.com/syncfusion-content/d…
sameerkhan001 Jul 28, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
93 changes: 69 additions & 24 deletions Document-Processing/PDF/PDF-Library/NET/Converting-images-to-PDF.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,14 +1,14 @@
---
title: Converting images to PDF | Syncfusion
description: This section explains how to convert both raster and vector images to PDF document using Syncfusion .NET PDF library.
description: This section explains how to convert both raster and vector images to a PDF document using the Syncfusion .NET PDF library.
platform: document-processing
control: PDF
documentation: UG
---

# Converting Images to PDF

The Syncfusion<sup>&reg;</sup> .NET PDF library provides comprehensive support for converting both raster and vector images to PDF documents. The [PdfImage](https://help.syncfusion.com/cr/document-processing/Syncfusion.Pdf.Graphics.PdfImage.html) class is an abstract base class that provides common functionality for converting images to PDF documents. It is used as the base class for two concrete image classes in the `Syncfusion.Pdf.Graphics` namespace: [PdfBitmap](https://help.syncfusion.com/cr/document-processing/Syncfusion.Pdf.Graphics.PdfBitmap.html) and [PdfMetafile](https://help.syncfusion.com/cr/document-processing/Syncfusion.Pdf.Graphics.PdfMetafile.html).
The .NET PDF library provides comprehensive support for converting both raster and vector images to PDF documents. The [PdfImage](https://help.syncfusion.com/cr/document-processing/Syncfusion.Pdf.Graphics.PdfImage.html) class is an abstract base class that provides common functionality for converting images to PDF documents. It serves as the base class for two concrete image classes in the `Syncfusion.Pdf.Graphics` namespace: [PdfBitmap](https://help.syncfusion.com/cr/document-processing/Syncfusion.Pdf.Graphics.PdfBitmap.html) and [PdfMetafile](https://help.syncfusion.com/cr/document-processing/Syncfusion.Pdf.Graphics.PdfMetafile.html).

Check the following video for a quick guide on converting an image to a PDF document using the PDF Library.
{% youtube "https://youtu.be/_uE324Y0hwI?si=usx8KrUUvHcT0-X8" %}
Expand All @@ -25,14 +25,16 @@ The library supports a wide range of image formats for PDF conversion. The suppo

N> To use image formats other than PNG and JPEG in ASP.NET Core, include the [Syncfusion.Pdf.Imaging.Net.Core](https://www.nuget.org/packages/Syncfusion.Pdf.Imaging.Net.Core) package in your project. This package provides the necessary support for handling other raster image formats such as BMP, GIF, TIFF, and ICO.

The [ImageToPdfConverter](https://help.syncfusion.com/cr/document-processing/Syncfusion.Pdf.ImageToPdfConverter.html) class converts image files into PDF documents, with options to customize page size and image positioning.
The [ImageToPdfConverter](https://help.syncfusion.com/cr/document-processing/Syncfusion.Pdf.ImageToPdfConverter.html) class converts image files into PDF documents, with options to customize the page size and image positioning.

The following code example shows how to convert an image to a PDF document.

{% tabs %}

{% highlight c# tabtitle="C# [Cross-platform]" playgroundButtonLink="https://raw.githubusercontent.com/SyncfusionExamples/PDF-Examples/master/Images/Convert_Image_to_PDF/.NET/Convert_Image_to_PDF/Program.cs" %}

using Syncfusion.Pdf;

// Create an instance of the ImageToPdfConverter class.
ImageToPdfConverter imageToPdfConverter = new ImageToPdfConverter();
// Set the page size for the document.
Expand All @@ -41,17 +43,21 @@ imageToPdfConverter.PageSize = PdfPageSize.A4;
imageToPdfConverter.ImagePosition = PdfImagePosition.TopLeftCornerOfPage;
// Create a file stream to read the image file.
using (FileStream imageStream = new FileStream("Image.jpg", FileMode.Open, FileAccess.Read))
// Convert the image to a PDF document using the ImageToPdfConverter.
using (PdfDocument pdfDocument = imageToPdfConverter.Convert(imageStream))
{
// Save the PDF document.
pdfDocument.Save("Output.pdf");
// Convert the image to a PDF document using the ImageToPdfConverter.
using (PdfDocument pdfDocument = imageToPdfConverter.Convert(imageStream))
{
// Save the PDF document.
pdfDocument.Save("Output.pdf");
}
}

{% endhighlight %}

{% highlight c# tabtitle="C# [Windows-specific]" %}

using Syncfusion.Pdf;

// Create an instance of the ImageToPdfConverter class.
ImageToPdfConverter imageToPdfConverter = new ImageToPdfConverter();
// Set the page size for the document.
Expand All @@ -60,17 +66,21 @@ imageToPdfConverter.PageSize = PdfPageSize.A4;
imageToPdfConverter.ImagePosition = PdfImagePosition.TopLeftCornerOfPage;
// Create a file stream to read the image file.
using (FileStream imageStream = new FileStream("Image.jpg", FileMode.Open, FileAccess.Read))
// Convert the image to a PDF document using the ImageToPdfConverter.
using (PdfDocument pdfDocument = imageToPdfConverter.Convert(imageStream))
{
// Save the PDF document.
pdfDocument.Save("Output.pdf");
// Convert the image to a PDF document using the ImageToPdfConverter.
using (PdfDocument pdfDocument = imageToPdfConverter.Convert(imageStream))
{
// Save the PDF document.
pdfDocument.Save("Output.pdf");
}
}

{% endhighlight %}

{% highlight vb.net tabtitle="VB.NET [Windows-specific]" %}

Imports Syncfusion.Pdf

' Create an instance of the ImageToPdfConverter class
Dim imageToPdfConverter As New ImageToPdfConverter()

Expand All @@ -95,35 +105,68 @@ End Using

You can download a complete working sample from [GitHub](https://github.com/SyncfusionExamples/PDF-Examples/tree/master/Images/Convert_Image_to_PDF/.NET).

N> In ASP.NET Core, converting TIFF to PDF requires the [Syncfusion.Pdf.Imaging.Net.Core](https://www.nuget.org/packages/Syncfusion.Pdf.Imaging.Net.Core) NuGet package.
N> In ASP.NET Core, converting TIFF to PDF requires the [Syncfusion.Pdf.Imaging.Net.Core](https://www.nuget.org/packages/Syncfusion.Pdf.Imaging.Net.Core) NuGet package. JPG, JPEG, and PNG conversions work without any additional package.

## Converting a Vector Image to PDF
## Converting a vector image to PDF

The Syncfusion<sup>&reg;</sup> .NET PDF library supports adding vector images in the Metafile format to PDF documents. During the conversion, Metafile graphics are transformed into native PDF graphics that support text selection and searching. The following types of Metafiles are supported in Essential<sup>&reg;</sup> PDF:
The Syncfusion<sup>&reg;</sup> .NET PDF library supports adding vector images in the Metafile format to PDF documents. During the conversion, Metafile graphics are transformed into native PDF graphics that support text selection and searching. The following Metafile types are supported in Essential<sup>&reg;</sup> PDF:
* EMF only
* EMF plus
* EMF plus dual
* WMF

The [PdfMetafile](https://help.syncfusion.com/cr/document-processing/Syncfusion.Pdf.Graphics.PdfMetafile.html) class loads EMF images, and the [PdfMetafileLayoutFormat](https://help.syncfusion.com/cr/document-processing/Syncfusion.Pdf.Graphics.PdfMetafileLayoutFormat.html) class allows you to control how text and images are split across pages in the PDF document. The following code example illustrates this.
For cross-platform .NET applications, install the [Syncfusion.MetafileRenderer.Net.Core](https://www.nuget.org/packages/Syncfusion.MetafileRenderer.Net.Core) NuGet package from [NuGet.org](https://www.nuget.org/). This package provides the `MetafileRenderer` class, which converts EMF and WMF streams into PDF templates that can be rendered in PDF documents.

For Windows-specific applications, The [PdfMetafile](https://help.syncfusion.com/cr/document-processing/Syncfusion.Pdf.Graphics.PdfMetafile.html) class loads EMF images, and the [PdfMetafileLayoutFormat](https://help.syncfusion.com/cr/document-processing/Syncfusion.Pdf.Graphics.PdfMetafileLayoutFormat.html) class allows you to control how text and images are split across pages in the PDF document. The following code example illustrates this.

{% tabs %}

{% highlight c# tabtitle="C# [Cross-platform]" %}

// Vector image conversion is not supported on cross-platform .NET platforms.
using Syncfusion.Drawing;
using Syncfusion.Metafile;
using Syncfusion.Pdf;
using Syncfusion.Pdf.Graphics;

//Create a new PDF document.
PdfDocument document = new PdfDocument();
//Open the EMF file as a stream.
using (FileStream metafileStream = new FileStream("Input.emf", FileMode.Open, FileAccess.Read))
{
//Create a new instance of the MetafileRenderer class.
MetafileRenderer renderer = new MetafileRenderer();
//Convert the Metafile stream to a PdfTemplate.
PdfTemplate template = renderer.ConvertToPdfTemplate(metafileStream);
//Set the page size to match the template size.
document.PageSettings.Size = new Syncfusion.Drawing.SizeF(template.Size);
//Remove page margins.
document.PageSettings.Margins.All = 0;
//Add a page to the document.
PdfPage page = document.Pages.Add();
//Get the PDF page graphics.
PdfGraphics graphics = page.Graphics;
//Draw the template on the PDF page.
graphics.DrawPdfTemplate(template, PointF.Empty);
}
//Save the PDF document.
document.Save("Output.pdf");
//Close the document.
document.Close(true);

{% endhighlight %}

{% highlight c# tabtitle="C# [Windows-specific]" %}

using Syncfusion.Pdf;
using Syncfusion.Pdf.Graphics;
using System.Collections.Generic;
using System.Drawing;

//Create a PDF document.
PdfDocument doc = new PdfDocument();
//Add a page to the document.
PdfPage page = doc.Pages.Add();

//Create PDF graphics for the page.
PdfGraphics graphics = page.Graphics;
//Create the layout format.
PdfMetafileLayoutFormat format = new PdfMetafileLayoutFormat();
//Split text and images between pages.
Expand All @@ -143,13 +186,16 @@ doc.Close(true);

{% highlight vb.net tabtitle="VB.NET [Windows-specific]" %}

Imports Syncfusion.Pdf
Imports Syncfusion.Pdf.Graphics
Imports System.Collections.Generic
Imports System.Drawing

'Create a PDF document.
Dim doc As New PdfDocument()
'Add a page to the document.
Dim page As PdfPage = doc.Pages.Add()

'Create PDF graphics for the page.
Dim graphics As PdfGraphics = page.Graphics
'Create the layout format.
Dim format As New PdfMetafileLayoutFormat()
'Split text and images between pages.
Expand All @@ -169,9 +215,8 @@ doc.Close(True)

{% endtabs %}

You can download a complete working sample from [GitHub](https://github.com/SyncfusionExamples/PDF-Examples/tree/master/Images/Insert-vector-image-in-a-PDF-document/).

N> EMF and WMF images are not supported on the ASP.NET Core platform.

You can download a complete working Cross-platform sample from [GitHub](https://github.com/SyncfusionExamples/PDF-Examples/tree/master/Images/Converting-Metafile-to-PDF/.NET).

You can download a complete working Window-specific sample from [GitHub](https://github.com/SyncfusionExamples/PDF-Examples/tree/master/Images/Insert-vector-image-in-a-PDF-document/).

N> EMF and WMF images can be converted on cross-platform .NET applications by using the `Syncfusion.MetafileRenderer.Net.Core` NuGet package. On Windows-specific platforms, you can also use the PdfMetafile class for rendering Metafile images directly into PDF documents.