In This Topic ▼

FILEPDFOPTIONS

typedef struct _FILEPDFOPTIONS 
{ 
   L_UINT uStructSize; 
   L_BOOL bUseLibFonts; 
   L_INT nDisplayDepth; 
   L_INT nTextAlpha; 
   L_INT nGraphicsAlpha; 
   L_UCHAR szPassword[FILEPDFOPTIONS_MAX_PASSWORD_LEN]; 
   L_UINT uFlags; 
} FILEPDFOPTIONS, *pFILEPDFOPTIONS;

The FILEPDFOPTIONS structure provides information about loading PDF, PS, or EPS files in LEADTOOLS.

Members

uStructSize

Size of the structure. This must be set before passing this structure to any LEADTOOLS function.

bUseLibFonts

Flag that indicates whether to use the library installed fonts, or system fonts. Possible values are:

Value	Meaning
TRUE	Use the library installed fonts.
FALSE	Use the system fonts.

nDisplayDepth *

Resulting bitmap pixel depth. Possible values are:

Value	Meaning
0	Auto-detect. The resulting bitmap will have the same bits per pixel as the requested page in the source PDF file. Internally, the toolkit will use the bits per pixel value of the first image item found on the page. If the page does not have any image items, the result will be 24 bits per pixel. It is best to use this value only when the source file is a raster PDF.
1	1 bit per pixel in the resulting bitmap
4	4 bits per pixel in the resulting bitmap
8	8 bits per pixel in the resulting bitmap
24	24 bits per pixel in the resulting bitmap

nTextAlpha *

Flag that indicates which type of font anti-aliasing to use. Possible values are:

Value	Meaning
1	Do not use font anti-aliasing.
2	Use 2-bit font anti-aliasing.
4	Use 4-bit font anti-aliasing.

nGraphicsAlpha *

Flag that indicates which type of graphics anti-aliasing to use. Possible values are:

Value	Meaning
1	Do not use graphics anti-aliasing.
2	Use 2-bit graphics anti-aliasing.
4	Use 4-bit graphics anti-aliasing.

szPassword *

String that contains the user password. This is the password used with encrypted PDF files.

uFlags *

Flags for PDF or PostScript files. Possible values are:

Value	Meaning
PDF_DISABLE_CROPPING	Disable cropping for PostScript files.
PDF_DETECT_TEXT_DECORATION	Automatically detect whether lines are text decorations (underline or strikethrough). This is only used for PDF-to-SVG conversion or for operations that use the PDF-to-SVG conversion internally (such as the Document Converter).
PDF_ENHANCE_THIN_LINES	Enhance thin lines.
PDF_DISABLE_CIECOLORS	Disable using CIE colors (both PDF and PostScript files).
PDF_ENABLE_INTERPOLATE	Enable interpolation for PDF files.
PDF_HIDE_NOAP_ANNOTATIONS	(Deprecated.) Hide annotation objects that have no appearance streams. If this flag is not set, all annotation objects will be loaded (both objects which have appearance streams and objects which do not have appearance streams).
PDF_HIDE_ALL_ANNOTATIONS	(Deprecated.) Hide all annotation objects, both objects which have appearance streams and those which do not have appearance streams.
PDF_HIDE_ANNOTATIONS	Hide annotation objects.
PDF_HIDE_FORMFIELDS	Hide form fields.
PDF_HIDE_DIGITALSIGNATURES	Hide digital signatures.
PDF_DROP_IMAGEOVERTEXT	If the PDF file is ImageOverText, drop the image. See Note 1 below for more details.
PDF_LOAD_CORRUPTED	Enable loading PDF files with corrupted image data without throwing errors.
PDF_USE_PDFENGINE	Use the LtPdfEngine to load PDF files.

The default value for uFlags is PDF_DETECT_TEXT_DECORATION | PDF_ENHANCE_THIN_LINES.

Comments

pFILEPDFOPTIONS is a pointer to a FILEPDFOPTIONS structure.

Use L_SetPDFOptions and L_GetPDFOptions to set and get PDF, PS, and EPS file options.

PDF, PS, and EPS files have no physical width or height in pixels. Use RASTERIZEDOCOPTIONS to control how the final document is rendered as a raster image. For more information, refer to RASTERIZEDOCOPTIONS.

Aliasing is the effect on all pixel devices where diagonal and curved lines have a zigzag appearance. As pixels get larger, this effect becomes more noticeable. Anti-aliasing refers to methods designed to decrease or eliminate this effect. This is done by shading the pixels along the borders of the affected lines.

The structure is used by:

L_GetPDFOptions
L_SetPDFOptions
**\*** This option affects the PDF format when PDF_USE_PDFENGINE is set to use the LtPdfUtl.dll. It also affects the PostScript format.

Note 1

Image over text (or overlay) is used when creating a searchable PDF document that is required to look the same as the original. When overlay is used, the PDF creator uses a raster image of the original file and saves it over the entire PDF page as an overlay. When opening the resulting document in a PDF viewer, you can still search the text underneath the overlay image and still maintain the look of the original document.

When loading a page from a PDF document that was created with this feature, LEADTOOLS will automatically render the overlay raster image on top of all other content of the page. If this is not desired, set the PDF_DROP_IMAGEOVERTEXT flag in uFlags.

PDF_DROP_IMAGEOVERTEXT has no effect on pages that do not have an overlay.

Refer to DOCWRTPDFOPTIONS.bImageOverText on how to create PDF documents with an overlay in LEADTOOLS, and to PDFDocument.GetContentType on how to detect if a page in a PDF file contains an overlay.

Download our FREE evaluation

Help Version 20.0.2020.4.3

LEADTOOLS Raster Imaging C API Help

Introduction

Version History

Getting Started

Files To Be Included With Your Application

Document Writers – Files To Be Included With Your Application

LEADTOOLS Raster Imaging Features