FILEPDFOPTIONS

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

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

The following functions make use of this structure:

L_GetPDFOptions

L_SetPDFOptions

Member

Description

uStructSize

Size of the structure. This must be set before passing this structure to the LEAD functions.

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.

nXResolution

Horizontal display resolution in dots per inch.

nYResolution

Vertical display resolution in dots per inch.

nDisplayDepth

Resulting bitmap pixel depth. Possible values are:

 

Value

Meaning

 

1

1 bit per pixel in the resultant bitmap

 

4

4 bits per pixel in the resultant bitmap

 

8

8 bits per pixel in the resultant bitmap

 

24

24 bits per pixel in the resultant bitmap

nTextAlpha

Flag that indicates what 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 what 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

Character string that contains the password that is used with encrypted PDF files. The maximum length of the password is the value of the constant FILEPDFOPTIONS_MAX_PASSWORD_LEN, which are 64 characters.

 

If the PDF file is not encrypted, then the value of this member will be ignored.

 

If the user has passed an empty or wrong password to be used with encrypted PDF file, the file will not opened, and an error occurred. For more information, refer to Error Codes.

uFlags

Flags that control the loading of PDF files. Possible values are:

 

Value

Meaning

 

PDF_DISABLE_CROPPING

[0x00000001] Disable cropping for postscript files.

 

PDF_DISABLE_CIECOLORS

[0x00000010] Disable using CIE colors for both PDF and postscript files.

Comments

pFILEPDFOPTIONS is a pointer to a FILEPDFOPTIONS structure.

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

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.