PdfExportOptions.ConvertImagesToJpeg Property

Specifies whether to convert the bitmap and meta file images contained in the document to JPEG format during the export to PDF.

Namespace: DevExpress.XtraPrinting

Assembly: DevExpress.Printing.v25.1.Core.dll

NuGet Package: DevExpress.Printing.Core

Declaration

C#

[DefaultValue(true)]
public bool ConvertImagesToJpeg { get; set; }

VB.NET

<DefaultValue(True)>
Public Property ConvertImagesToJpeg As Boolean

Property Value

Type	Default	Description
Boolean	true	true, to convert images to JPEG; otherwise, false.

Property Paths

You can access this nested property as listed below:

Library	Object Type	Path to ConvertImagesToJpeg
Cross-Platform Class Library	ExportOptions	.Pdf .ConvertImagesToJpeg
WinForms Controls	DiagramOptionsExport	.PdfExportOptions .ConvertImagesToJpeg
WPF Controls	DiagramControl	.PdfExportOptions .ConvertImagesToJpeg

Remarks

Use the ConvertImagesToJpeg property to convert the bitmap and metafile images contained in the document to JPEG format during the export to PDF operation. This reduces the size of the PDF document.

Images are converted to JPEG only if this option is enabled and the JPEG image size is smaller than the original image size.

You can use the PdfExportOptions.ImageQuality property to change the embedded images’ quality and further reduce the document size.

Related GitHub Examples

The following code snippet (auto-collected from DevExpress Examples) contains a reference to the ConvertImagesToJpeg property.

Note

The algorithm used to collect these code examples remains a work in progress. Accordingly, the links and snippets below may produce inaccurate results. If you encounter an issue with code examples below, please use the feedback form on this page to report the issue.

VB.NET

reporting-winforms-export-pdf/VB/WindowsFormsApplication1/Form1.vb#L25

' Specify the quality of exported images.
pdfOptions.ConvertImagesToJpeg = False
pdfOptions.ImageQuality = PdfJpegImageQuality.Medium