Implementing PDF Features

Overview

The LEADTOOLS toolkits support a number of powerful and complex file formats including:

Loading Capabilities

The LEADTOOLS PDF features have the following import capabilities:

  1. Loads essentially all PDF 1.3 (Acrobat 4.x compatible) through PDF 1.7 files.

  2. Loads all PostScript Language Level 3 files.

  3. Loads any EPS file.

Loading support includes multi-threading support and multipage support. Multipage support allows you to specify which page or range of pages to load from a file.

You also get a number of control options in order to customize the rasterized page. These options include:

  1. Pixel depth. Valid values are 0 (for auto-detect) 1, 4, 8 and 24. The default value is 24.

  2. Horizontal and vertical resolution in dots per inch with a default value of 300 by 300. For a typical PDF file having a page size equal to 8.5 by 11 inches, the resulting image will be  2550 by 3300 pixels. If the PDF was loaded at 24 BPP, then the resulting image will require 25,251,600 bytes (25MB) of memory. If this value is too large for your application need or you do not need to load the PDF with fine detail, then change the resolution to a smaller value. For example, 96 by 96 pixels result in an image that is 816 by 1056 pixels and uses 2,585,088 bytes (2.5MB) of memory.

  3. Font anti-aliasing. Valid values are 1-bit (no anti-aliasing), 2- and 4-bit anti-aliasing. The default value is 1, which gives the sharpest representation of the text in the file.

  4. Graphics anti-aliasing. Valid values are 1-bit (no anti-aliasing), 2-bit, and 4-bit anti-aliasing. The default value is 1.

Use the L_GetPDFOptions function to get the default values for control options that are used when loading a file. You can then use the L_SetPDFOptions function to change the values for the control options.

You can also use L_GetRasterPdfInfo to get information specific to a PDF file, such as its original bits/pixel, compression, size and resolution

Saving Capabilities

LEADTOOLS toolkits include full multipage write support for the PDF format. You can append, insert, replace or delete specific pages in PDF files.

A wide range of control options for the resulting image data in terms of compression is provided, including:

  1. No compression.

  2. Compressed using CCITT Group 3, 1 dimension. For 1-bit images.

  3. Compressed using CCITT Group 3, 2 dimensions. For 1-bit images.

  4. Compressed using CCITT Group 4. For 1-bit images.

  5. JPEG compression and YUV 4:4:4 color space loss-less. Bits per pixel: 8 for grayscale, 24 for color.

  6. JPEG compression and YUV 4:2:2 color space. Bits per pixel: 8 for grayscale, 24 for color.

  7. JPEG compression and YUV 4:1:1 color space. Bits per pixel: 8 for grayscale, 24 for color.

  8. JPEG2000 compression Bits per pixel 24 for color.

You also get control over the type of encoding to be used in order to change compressed image data into a text format. Text encoding techniques include:

  1. No text encoding at all.

  2. Use ASCII 85 text encoding algorithm.

  3. Use ASCII HEX text encoding technique.

A number of new flags have been added to the SAVEFILEOPTION structure, in order to specify which type of text encoding to use when saving. For more information, please refer to that structure for more details. In addition, LEAD provides the FILEPDFSAVEOPTIONS structure to let you control the security of and access to the PDF file that is saved. These include user and owner passwords, encryption options, and specifying which capabilities the user of the resulting PDF document will have. To determine the current options used when saving a PDF file, call L_GetPDFSaveOptions. To set the options used when saving a PDF file, call L_SetPDFSaveOptions.

Distributing an Application

LEADTOOLS provides support for PDF loading and saving through two DLLs: LTPDF?.dll and LtPdfUtl.dll.

LTPDF?dll is the DLL for PDF support in LEADTOOLS. LTFIL, which contains the LEADTOOLS raster images load and save support, will load this dll dynamically when PDF files are loaded or saved. This is the normal behavior for LEADTOOLS support for any file format.

LtPdfUtl.dll is the PDF runtime DLL. This DLL is never referenced directly by the LEADTOOLS Raster PDF file filter, instead it is loaded dynamically and out of process by the filter.

By default, the LEADTOOLS installer will copy this DLL next to the filter (in the Bin\CDLL\Win32, Bin\CDLL\x64, Bin\CDLLVC10\Win32 and Bin\CDLLVC10\x64 folders) and the filter will look for the engine DLL in the same folder it is located (default location).

In some cases, you can share the same copy of LtPdfUtl.dll between different applications. In this case, you can copy LtPdfUtl.dll to a fixed directory and pass the name of this directory to L_SetPDFInitDir. From that point on, LEADTOOLS will use the designated directory value to locate and load LtPdfUtl.dll.

In addition to these DLLs, LEADTOOLS might require other DLLs when saving PDF files, depending on the compression used. For more information, refer to Files To Be Included With Your Application.

See Also

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

LEADTOOLS Raster Imaging C API Help