windowsforms-devexpress-dot-xtrapdfviewer-dot-pdfviewer.md
Specifies the engine used to render page content.
Namespace : DevExpress.XtraPdfViewer
Assembly : DevExpress.XtraPdfViewer.v25.2.dll
NuGet Package : DevExpress.Win.PdfViewer
[Browsable(false)]
public PdfViewerRenderingEngine RenderingEngine { get; set; }
<Browsable(False)>
Public Property RenderingEngine As PdfViewerRenderingEngine
| Type | Description |
|---|---|
| PdfViewerRenderingEngine |
An enumeration value that specifies the rendering engine.
|
Available values:
| Name | Description |
|---|---|
| Default |
Default rendering engine.
| | GdiPlus |
GDI/GDI+ rendering engine.
| | DirectX |
DirectX rendering engine.
| | DirectXSoftware |
DirectX software rendering engine.
|
The PDF Viewer uses DirectX as the default rendering engine. The GDI+ engine is used as the default backup.
The PDF Viewer uses DirectX to render PDF files and the XPS API to print them. If your printer uses a PCL6 or PostScript driver, the DirectX engine converts the print job from XPS to the printer’s format, which may reduce printing performance. We recommend that you use the XPS printer driver to optimize printing.
Set the PdfViewer.RenderingEngine property Gdi to disable the DirectX printing engine and use GDI+ instead. Please note that the GDI+ engine has limitations and some content may be lost (that is, stroke and clip text rendering, transparency, and blend modes).
You can also use the legacy printing engine (the PdfPrinterSettings.EnableLegacyPrinting option). In this case, PDF pages are printed as images. The legacy printing engine uses the GDI Print API to print files, and the rendering engine specified by the RenderingEngine property to render pages as images. Note that this can affect printing performance due to the size of printed images.
See Also