Leadtools.Codecs Namespace > CodecsPdfLoadOptions Class : UsePdfEngine Property |
public bool UsePdfEngine {get; set;}
'Declaration Public Property UsePdfEngine As Boolean
'Usage Dim instance As CodecsPdfLoadOptions Dim value As Boolean instance.UsePdfEngine = value value = instance.UsePdfEngine
public bool UsePdfEngine {get; set;}
get_UsePdfEngine();
set_UsePdfEngine(value);
Object.defineProperty('UsePdfEngine');
To load or save PDF documents to/from a raster image in LEADTOOLS, you use the Leadtools.Pdf.dll assembly. This is the file filter for the PDF format (as well as Postscript and Enhanced Postscript). Use this assembly as any other file filter in LEADTOOLS, such as Leadtools.Codecs.Bmp.dll for BMP support and Leadtools.Codecs.Tif.dll for TIF support.
In addition to Leadtools.Pdf.dll, the Leadtools.PdfEngine.dll assembly is required in the following situations:
When loading Postscript (PS) or Enhanced Postscript (EPS) files. This is always needed regardless of the value of the UsePdfEngine option described below.
When using the LEADTOOLS DocumentReaders to read the objects of a PDF file (using the Leadtools.DocumentReaders.dll and Leadtools.DocumentReaders.Pdf.dll assemblies). Again, Leadtools.PdfEngine.dll is required regardless of the value of the UsePdfEngine option described below.
When the value of CodecsPdfLoadOptions.UsePdfEngine is set to true (the default value is false). When this option is used, then LEADTOOLS will use both Leadtools.Pdf.dll and Leadtools.PdfEngine.dll when loading PDF files. This is provided for legacy support.
Leadtools.PdfEngine.dll contains many resources such as tables and fonts required to render a PDF image (if one of the options above is satisfied and also always for PS and EPS files). This DLL is not referenced in a direct way by the file filter; instead it is loaded dynamically and out of a process if needed. You must ensure that this DLL is present on the machine. By default, it is required to have this DLL in the same directory where the file filter is located. However, to share many instances of the Leadtools.PdfEngine.dll assembly between many applications, use the CodecsPdfOptions.InitialPath property.
Note that if the application does not required PDF Engine, for example, the application is only loading and saving PDF files as raster images. Then, Leadtools.PdfEngine.dll is not required to be present on the machine. Leadtools.Pdf.dll is always required regardless. Leadtools.PdfEngine.dll is used out of process and may slow down loading PDF documents. It is recommended that you load PDF files with the UsePdfEngine set to false (the default value) for maximum performance.