ImageGear for C and C++ on Windows v20.1 - 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

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.
NO_RMV_PAGE_INHERIT AT_BOOL FALSE TRUE, FALSE Specifies to not remove page inheritance when inserting pages. Set this to true only if there are performance issues working with PDF files with very large page counts.
PAGE_HEIGHT UINT 0 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.

Is this page helpful?
Yes No
Thanks for your feedback.