←Select platform

CodecsPdfOptions Class

Summary

Provides extra options for loading and saving PDF images.

Syntax
C#
VB
Objective-C
C++
Java
public class CodecsPdfOptions 
Public Class CodecsPdfOptions  
@interface LTCodecsPdfOptions : NSObject 
public class CodecsPdfOptions 
public ref class CodecsPdfOptions  

Remarks

To load or save PDF documents to/from a raster image in LEADTOOLS, 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.Pdf.Utilities.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 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.Pdf.Utilities.dll when loading PDF files. This is provided for legacy support.

Leadtools.Pdf.Utilities.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.Pdf.Utilities.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.Pdf.Utilities.dll is not required to be present on the machine. Leadtools.Pdf.dll is always required regardless.

Example
C#
VB
using Leadtools; 
using Leadtools.Codecs; 
 
public void CodecsPdfOptionsExample() 
{ 
   RasterCodecs codecs = new RasterCodecs(); 
 
   string srcFileName = Path.Combine(LEAD_VARS.ImagesDir, "PDFSegmentation.pdf"); 
   string destFileName1 = Path.Combine(LEAD_VARS.ImagesDir, "PdfOptions.pdf"); 
   string destFileName2 = Path.Combine(LEAD_VARS.ImagesDir, "PdfOptions.bmp"); 
 
   codecs.Options.Pdf.InitialPath = @"C:\MyApp\Bin"; 
 
   // Check if the PDF engine is installed then get the load and save options of the PDF files. 
   if (codecs.Options.Pdf.IsEngineInstalled) 
   { 
      // Resulting image pixel depth. 
      codecs.Options.Pdf.Load.DisplayDepth = 24; 
      codecs.Options.Pdf.Load.GraphicsAlpha = 4; 
      codecs.Options.Pdf.Load.Password = ""; 
 
      // Type of font anti-aliasing to use. 
      codecs.Options.Pdf.Load.TextAlpha = 1; 
      codecs.Options.Pdf.Load.UseLibFonts = true; 
 
      // Horizontal,vertical  display resolution in dots per inch. 
      codecs.Options.RasterizeDocument.Load.XResolution = 150; 
      codecs.Options.RasterizeDocument.Load.YResolution = 150; 
 
      using (RasterImage image = codecs.Load(srcFileName, 0, CodecsLoadByteOrder.BgrOrGray, 1, 1)) 
      { 
         // Set access rights for the user when he\she opens the file we create 
         codecs.Options.Pdf.Save.AssembleDocument = true; 
         codecs.Options.Pdf.Save.ExtractText = true; 
         codecs.Options.Pdf.Save.ExtractTextGraphics = true; 
         codecs.Options.Pdf.Save.PrintDocument = false; 
         codecs.Options.Pdf.Save.FillForm = true; 
         codecs.Options.Pdf.Save.ModifyAnnotation = true; 
         codecs.Options.Pdf.Save.ModifyDocument = true; 
         codecs.Options.Pdf.Save.OwnerPassword = "LEAD Technologies"; 
         codecs.Options.Pdf.Save.PrintFaithful = false; 
         codecs.Options.Pdf.Save.TextEncoding = CodecsPdfTextEncoding.Hex; 
         codecs.Options.Pdf.Save.Use128BitEncryption = true; 
         codecs.Options.Pdf.Save.UserPassword = "LEAD"; 
         // Set the PDF version to be v1.4 
         codecs.Options.Pdf.Save.Version = CodecsRasterPdfVersion.V14; 
         // Save it as linearized (optimized for web view) 
         codecs.Options.Pdf.Save.Linearized = true; 
 
         // Save the image back as PDF 
         codecs.Save(image, destFileName1, RasterImageFormat.RasPdf, 24); 
      } 
 
      // And load it back before saving it as BMP 
      using (RasterImage image = codecs.Load(destFileName1)) 
      { 
         codecs.Save(image, destFileName2, RasterImageFormat.Bmp, image.BitsPerPixel); 
      } 
   } 
   else 
   { 
      Console.WriteLine("PDF Engine is not found!"); 
   } 
 
   // Clean up 
   codecs.Dispose(); 
} 
 
static class LEAD_VARS 
{ 
   public const string ImagesDir = @"C:\Users\Public\Documents\LEADTOOLS Images"; 
} 
Imports Leadtools 
Imports Leadtools.Codecs 
 
Public Sub CodecsPdfOptionsExample() 
   Dim codecs As New RasterCodecs() 
 
   Dim srcFileName As String = Path.Combine(LEAD_VARS.ImagesDir, "PDFSegmentation.pdf") 
   Dim destFileName1 As String = Path.Combine(LEAD_VARS.ImagesDir, "PdfOptions.pdf") 
   Dim destFileName2 As String = Path.Combine(LEAD_VARS.ImagesDir, "PdfOptions.bmp") 
 
   codecs.Options.Pdf.InitialPath = "C:\MyApp\Bin" 
 
   ' Check if the PDF engine is installed then get the load and save options of the PDF files. 
   If codecs.Options.Pdf.IsEngineInstalled Then 
      ' Resulting image pixel depth. 
      codecs.Options.Pdf.Load.DisplayDepth = 24 
      codecs.Options.Pdf.Load.GraphicsAlpha = 4 
      codecs.Options.Pdf.Load.Password = "" 
 
      ' Type of font anti-aliasing to use. 
      codecs.Options.Pdf.Load.TextAlpha = 1 
      codecs.Options.Pdf.Load.UseLibFonts = True 
 
      ' Horizontal,vertical  display resolution in dots per inch. 
      codecs.Options.RasterizeDocument.Load.XResolution = 150 
      codecs.Options.RasterizeDocument.Load.YResolution = 150 
 
      Using image As RasterImage = codecs.Load(srcFileName, 0, CodecsLoadByteOrder.BgrOrGray, 1, 1) 
         ' Set access rights for the user when he\she opens the file we create 
         codecs.Options.Pdf.Save.AssembleDocument = True 
         codecs.Options.Pdf.Save.ExtractText = True 
         codecs.Options.Pdf.Save.ExtractTextGraphics = True 
         codecs.Options.Pdf.Save.PrintDocument = False 
         codecs.Options.Pdf.Save.FillForm = True 
         codecs.Options.Pdf.Save.ModifyAnnotation = True 
         codecs.Options.Pdf.Save.ModifyDocument = True 
         codecs.Options.Pdf.Save.OwnerPassword = "LEAD Technologies" 
         codecs.Options.Pdf.Save.PrintFaithful = False 
         codecs.Options.Pdf.Save.TextEncoding = CodecsPdfTextEncoding.Hex 
         codecs.Options.Pdf.Save.Use128BitEncryption = True 
         codecs.Options.Pdf.Save.UserPassword = "LEAD" 
         ' Set the PDF version to be v1.4 
         codecs.Options.Pdf.Save.Version = CodecsRasterPdfVersion.V14 
         ' Save it as linearized (optimized for web view) 
         codecs.Options.Pdf.Save.Linearized = True 
 
         ' Save the image back as PDF 
         codecs.Save(image, destFileName1, RasterImageFormat.RasPdf, 24) 
      End Using 
 
      ' And load it back before saving it as BMP 
      Using image As RasterImage = codecs.Load(destFileName1) 
         codecs.Save(image, destFileName2, RasterImageFormat.Bmp, image.BitsPerPixel) 
      End Using 
   Else 
      Console.WriteLine("PDF Engine is not found!") 
   End If 
 
   ' Clean up 
   codecs.Dispose() 
End Sub 
 
Public NotInheritable Class LEAD_VARS 
   Public Const ImagesDir As String = "C:\Users\Public\Documents\LEADTOOLS Images" 
End Class 

Requirements

Target Platforms

Help Version 20.0.2020.4.3
Products | Support | Contact Us | Intellectual Property Notices
© 1991-2020 LEAD Technologies, Inc. All Rights Reserved.

Leadtools.Codecs Assembly