ImageGear for C and C++ on Windows v19.4 - Updated
PDF
User Guide > File Formats and Compressions > File Formats > File Formats Reference > PDF
Full Name Adobe PDF (Adobe Portable Document Format)
Format ID IG_FORMAT_PDF = 56
File Extension(s) *.pdf
Data Type Vector Image
Data Encoding Binary
Color Profile Support No
Multi-Page Support Yes
Alpha Channel Support No
ImageGear Platforms Support WIN32, WIN64, Unix, Unix64, MAC, .NET
To enable the support of the PDF format, attach the ImageGear PDF Component to Core ImageGear. See the PDF Getting Started with PDF section.

ImageGear Supported Versions:

ImageGear Supported Features:

ImageGear Read Support:

ImageGear Write Support:

ImageGear Filter Control Parameters:

Filter Control Parameter Type Default Value Available Values Description
ALLOW_XFA AT_BOOL FALSE TRUE, FALSE

Specifies whether to allow opening PDF documents with XFA content embedded.

  • TRUE - PDF documents with XFA content will open without any error, but XFA content will not be available or visible.
  • FALSE - (default) PDF documents with XFA content will not open, and an ImageGear error will appear.
DEPTH UINT 24 1, 8, 24 Specifies bit depth in bits per pixels during the PDF document conversion into the raster image. A higher value indicates a higher quality raster image and a larger amount of memory required for rasterization. The DIB of the output raster image has this value as a bit count.
DRAW_MODE UINT 1 1, 2 Specifies the default PDF rendering method used by the ImageGear PDF component to draw PDF page content. 
  • 1 - Draws entire page content into the cache. This function is optimized for fast scrolling.
  • 2 - Draws visible page content area. This function is optimized for fast rendering, but would re-render the content each time it is scrolled.
INC_REND AT_BOOL FALSE  TRUE, FALSE Specifies whether incremental rendering or rendering at once should be performed. 
INDEPENDENT_PAGESIZE AT_BOOL FALSE  TRUE, FALSE

(Used with PDF write only.)

  • If this parameter is FALSE, when saving a raster image into the PDF document, the width and height of the newly created page is set to the width and height of the previous page in the PDF document. If the previous page does not exist, the width and height are calculated from the image resolution and size as follows:

    Width = <width of the raster image> * 72 / <X DPI of the raster image>
    Height = <height of the raster image> * 72 / <Y DPI of the raster image>

    If the image resolution is not defined, the width and height are set to the width and height of the Letter page, which is 612x792.

  • If this parameter is TRUE, use the PAGE_HEIGHT and PAGE_WIDTH parameters to set the page size.

PAGE_HEIGHT UINT  Any non-negative value

(Used with PDF write only.) This parameter sets the height of the page (in 1/72 inches). If this option is 0, the height is calculated from the image resolution and size as follows:

Height = <height of the raster image> * 72 / <Y DPI of the raster image> 

If the image resolution is not defined, the height is set to the height of an Letter page, which is 792.

This option is not used if INDEPENDENT_PAGESIZE is FALSE.

PAGE_WIDTH UINT   0 Any non-negative value 

(Used with PDF write only.) This parameter sets the width of the page (in 1/72 inches). If this option is 0, the width is calculated from the image resolution and size as follows:

Width = <width of the raster image> * 72 / <X DPI of the raster image>

If the image resolution is not defined, the width is set to the width of the Letter page, which is 612.

This option is not used if INDEPENDENT_PAGESIZE is FALSE. 

PASSWORD LPCHAR  "" Any  Specifies the password string for the password of the protected PDF documents.  
PRINT_DEPTH UINT  8 1, 8, 24  Specifies bit depth in bits per pixels during the PDF document printing. A higher value indicates a higher quality raster image and a larger amount of memory required for printing. 
PRINT_RESOLUTION_X UINT  300 Any positive value, inclusively between 1 and 2147483647 Specifies the horizontal resolution in dots per inch during PDF document printing. A higher value indicates a higher quality image to be printed.  
PRINT_RESOLUTION_Y UINT  300 Any positive value, inclusively between 1 and 2147483647 Specifies the vertical resolution in dots per inch during the PDF document printing. A higher value indicates a higher quality image to be printed.  
RESOLUTION_3D UINT  72 Any except 0 Specifies the resolution in dots per inch used for generating a pre-rendered bitmap of the default view of the 3D artwork. Producers should provide bitmaps of appropriate resolution for all intended uses of the document, i.e., a high-resolution bitmap for high-quality printing and a default screen-resolution bitmap for on-screen viewing. 
RESOLUTION_X UINT  72 Any Specifies the horizontal resolution in dots per inch during the PDF/PS document conversion into a raster image. The higher this value, the higher-quality raster image you get after rasterization. The DIB of the output raster image has this value as an X resolution. 
RESOLUTION_Y UINT  72 Any Specifies the vertical resolution in dots per inch during the PDF/PS document conversion into a raster image. The higher this value, the higher-quality raster image you get after rasterization. The DIB of the output raster image has this value as an Y resolution. 
SAVE_FLAGS UINT  IG_PDF_OPTIMIZED

A bit composition of an OR of the following values:

  • IG_PDF_OPTIMIZED = 32 - perform garbage collection on unreferenced objects.
  • IG_PDF_LINEARIZED = 4 - write the file linearized for page serving over remote connections.
  • IG_PDF_DONT_SAVE_FILE_ATTRIBUTES = 65536 - prevent the file attributes and security settings of a PDF document opened from an existing PDF file from being copied over when saved to a new PDF file.  
  • IG_PDF_OPTIMIZE_XOBJECTS = 4194304 - merge identical forms and images, as determined by an MD5 hash of their contents.
(Used with PDF write only.) Specifies an option for saving a PDF file that allows you to remove unreferenced objects, often reducing file size, as well as to write a linearized file for page-served remote (network) access. 
SAVE_MAJOR UINT  0 0, 1 Specifies major PDF version number of the document for saving. If major equals 0, both major and minor are ignored and the document is saved to the library's default version. Make sure that the document conforms to the version number you are setting. 
SAVE_MINOR UINT  0 6, 5, 4, etc. 

Specifies minor PDF version number of the document for saving. Make sure that the document conforms to the version number you are setting.  

SMOOTH_FLAGS UINT  13

A bit composition of an OR of the following values:

  • 1 - Draw smooth text
  • 2 - Draw smooth line art
  • 4 - Draw smooth image
  • 8 - Enhance thin lines
Specifies smooth settings for PDF rasterization. 
TEXT_ENCODING UINT 

IG_PDF_TEXTENC_NONE

  • IG_PDF_TEXTENC_NONE = 1 - no encoding used
  • IG_PDF_TEXTENC_ASCII_85 = 2 - ASCII 85 encoding used
  • IG_PDF_TEXTENC_ASCII_HEX = 3 - ASCII HEX encoding used
(Used with PDF write only.) Specifies which encoding scheme should be used to convert binary image data to the text format when saving raster image into a PDF document. 
USE_CROP_BOX AT_BOOL  TRUE  TRUE, FALSE

Specifies whether to use PDF crop box rectangle for page layout.

  • TRUE - use PDF crop box rectangle for page layout
  • FALSE - use PDF media rectangle for page layout 

Comments:

Please see the section Using ImageGear PDF Component.