ImageGear Professional DLL v17.1 for Windows Accusoft
AT_PDF_PRINTPARAMS
Send Feedback  
ImageGear Professional DLL v17.1 for Windows > API Reference Guide > PDF Component API Reference > PDF Component Structures Reference > AT_PDF_PRINTPARAMS

Glossary Item Box

This structure indicates how a document should be printed.

Declaration:

  Copy Code 
typedef struct tagAT_PDF_PRINTPARAMS
{
        AT_UINT size;
        AT_PDF_PAGE_RANGE *ranges;
        AT_INT32 numRanges;
        AT_PDF_BOOL shrinkToFit;
        AT_PDF_BOOL expandToFit;
        AT_PDF_BOOL rotateAndCenter;
        AT_INT16 printWhat;
        AT_INT16 printWhatAnnot;
        AT_PDF_BOOL emitPS;
        AT_INT32 psLevel;
        AT_INT16 outputType;
        AT_INT16 incBaseFonts;
        AT_INT16 incEmbeddedFonts;
        AT_INT16 incType1Fonts;
        AT_INT16 incType3Fonts;
        AT_INT16 incTrueTypeFonts;
        AT_INT16 incCIDFonts;
        AT_INT16 incProcsets;
        AT_INT16 incOtherResources;
        AT_INT32 fontPerDocVM;
        AT_PDF_BOOL emitShowpage;
        AT_PDF_BOOL emitTTFontsFirst;
        AT_PDF_BOOL setPageSize;
        AT_PDF_BOOL emitDSC;
        AT_PDF_BOOL setupProcsets;
        AT_PDF_BOOL emitColorSeps;
        AT_PDF_BOOL binaryOK;
        AT_PDF_BOOL useSubFileDecode;
        AT_PDF_BOOL emitRawData;
        AT_PDF_BOOL TTasT42;
        AT_FLOAT scale;
        AT_PDF_BOOL emitExternalStreamRef;
        AT_PDF_BOOL emitHalftones;
        AT_PDF_BOOL emitPSXObjects;
        AT_PDF_BOOL centerCropBox;
        AT_PDF_BOOL emitSeparableImagesOnly;
        AT_PDF_BOOL emitDeviceExtGState;
        AT_PDF_FIXEDRECT boundingBox;
        AT_PDF_BOOL useFontAliasNames;
        AT_PDF_BOOL emitPageRotation;
        AT_PDF_BOOL reverse;
        AT_PDF_FIXEDRECT *tCropBox;
        AT_PDF_BOOL emitPageClip;
        AT_PDF_BOOL emitTransfer;
        AT_PDF_BOOL emitBG;
        AT_PDF_BOOL emitUCR;
        AT_INT16 farEastFontOpt;
        AT_PDF_BOOL suppressCJKSubstitution;
        AT_PDF_BOOL suppressCSA;
        AT_PDF_BOOL hostBased;
        HIG_PDF_ATOM hostBasedOutputCS;
        AT_INT16 duplex;
        AT_INT16 doTiling;
        LPAT_PDF_TILEEX tileInfo;
        AT_PDF_BOOL rotate;
        AT_PDF_BOOL hostBasedCM;
        char  destProfile[256]; 
        HIG_PDF_ATOM destCSAtom;
        AT_PDF_BOOL saveVM;
        AT_PDF_BOOL doOPP;
        AT_INT32 suppressOPPWhenNoSpots;
        AT_PDF_BOOL optimizeForSpeed;
        AT_PDF_BOOL brokenCRDs;
        AT_PDF_BOOL useMaxVM;
        AT_INT32 lastWidth;
        AT_INT32 lastHeight;
        AT_DWORD bitmapResolution;
        AT_DWORD gradientResolution;
        AT_DWORD transparencyQuality;
        AT_DWORD ocContext;
        AT_PDF_BOOL applyOCGPrintOverrides;
        AT_PDF_BOOL useFullResolutionJP2KData;
        AT_PDF_BOOL emitInRipSeps;
        AT_DWORD whichMarks;
        AT_PDF_BOOL westernMarksStyle;
        AT_PDF_BOOL doProofing;
        char proofProfile[256];
        AT_PDF_BOOL inkBlack;
        AT_PDF_BOOL paperWhite;
        AT_PDF_BOOL useExecForm;
        LPAT_PDF_FLATTEN flattenInfo;
        AT_PDF_BOOL negative;
        AT_INT16 mirrorprint;
        AT_DWORD numCollatedCopies;
        AT_PDF_BOOL emitFlatness;
        AT_INT32 trapType;
        AT_PDF_BOOL TTasCIDT2;
        AT_DWORD markStyle;
        AT_FLOAT lineWidth;
        AT_PDF_BOOL macQDPrinter;
        AT_UINT customMarksFileName;
        AT_VOID *pAGMPI;
        AT_PDF_BOOL disableFlattening;
        AT_PDF_BOOL doNotDownloadFauxFonts;
        AT_PDF_BOOL suppressSnapToDevice;
        AT_INT32 suppressElement;
} AT_PDF_PRINTPARAMS;
typedef AT_PDF_PRINTPARAMS FAR* LPAT_PDF_PRINTPARAMS;

Members:

size Size of the data structure. Must be set to sizeof(AT_PDF_PRINTPARAMS).
ranges Ranges of pages to print. Use NULL to print the entire document.
numRanges Number of ranges of pages to print in ranges. The default value is 0.
shrinkToFit TRUE if the page is scaled to fit the printer page size; FALSE otherwise. This field overrides scale. The default value is FALSE.
expandToFit TRUE if small pages are to be scaled up to fit the printer page size; FALSE otherwise. Overrides scale. The default value is FALSE.
rotateAndCenter TRUE if page is to be rotated to fit printer's orientation, and centered in printer's page size; FALSE otherwise.The default value is FALSE. Rotation and centering (TRUE) only occur, however, if the page contents are too wide to fit on a narrow page (or vice versa) and the page contents are less than an inch smaller than the target page in one direction.
printWhat enumIGPDFPrintWhat flag. Default is IG_PDF_PRINT_DOCUMENT.
printWhatAnnot Combination of enumIGPDFPrintWhatAnnot flags which extend printWhat to enable Pro product behavior.
emitPS If TRUE, emit a PostScript file. The default value is TRUE.
psLevel PostScript level: 1, 2 or 3. The default value is 2.
outputType Print PostScript or EPS with or without a preview.
incBaseFonts Embed the base fonts. The default value is IG_PDF_INCLUDE_NEVER.
incEmbeddedFonts Embed fonts that are embedded in the PDF file. This overrides the incType1Fonts, incTrueTypeFonts, and incCIDFonts fields. The default value is IG_PDF_INCLUDE_ONCE_PER_DOC.
incType1Fonts Embed Type 1 fonts. The default value is IG_PDF_INCLUDE_ONCE_PER_DOC.
incType3Fonts

Embed Type 3 fonts. The default value is IG_PDF_INCLUDE_ON_EVERY_PAGE. 

This parameter must always be set to IG_PDF_INCLUDE_ON_EVERY_PAGE. PDF files exist with Type 3 fonts that contain different encodings on different pages.
incTrueTypeFonts Embed TrueType fonts. The default value is IG_PDF_INCLUDE_ONCE_PER_DOC.
incCIDFonts Embed CID fonts. The default value is IG_PDF_INCLUDE_ONCE_PER_DOC.
incProcsets Include Procsets in the file. The default value is IG_PDF_INCLUDE_ONCE_PER_DOC.
incOtherResources Include all other types of resources in the file. The default value is IG_PDF_INCLUDE_ONCE_PER_DOC.
fontPerDocVM

Amount of VM available for font downloading at the document level. Ignored if <=0. 

This must be set to 0 for the toolkit; it is only used by the viewer.
emitShowpage Emit save and restore showpage in PostScript files. The default value is TRUE.
emitTTFontsFirst Emit TrueType fonts before any other fonts. The default value is FALSE.
setPageSize (PostScript level 2 only) Set the page size on each page. Use the media box for outputting to PostScript files, use the crop box for EPS files. Default is FALSE.
emitDSC Write DSC (Document Structuring Conventions) comments. The default value is TRUE.
setupProcsets

If procsets are included, also include init/term code. The default value is TRUE. 

This must be set to TRUE.
emitColorSeps Emit images for Level-1 separations. The default value is FALSE.
binaryOK TRUE if binary data is permitted in the PostScript file; FALSE otherwise. The default value is TRUE.
useSubFileDecode Add SubFileDecode filter to work around stream problems. The default value is FALSE.
emitRawData TRUE if add no unnecessary filters when emitting image data; FALSE otherwise. The default value is TRUE.
TTasT42 If including TrueType fonts, convert to Type 42 fonts instead of Type 1 fonts. The default value is FALSE.
scale Document-wide scale factor. 100.0 = full size. The default value is 100.
emitExternalStreamRef If an Image resource uses an external stream, emit code that points to the external file. The default value is FALSE.
This must be set to FALSE.
emitHalftones Preserve any halftone screening in the PDF file. The default value is FALSE.
emitPSXObjects Emit PostScript XObjects into the PostScript stream. The default value is FALSE.
centerCropBox TRUE if CropBox output is centered on the page when the CropBox < MediaBox; FALSE otherwise. The default value is TRUE.
emitSeparableImagesOnly If emitting EPS, include only CMYK and gray images.
emitDeviceExtGState When emitting the extended graphics state, include the device-dependent parameters (overprint, black generation, undercolor removal, transfer, halftone, halftone phase, smoothness, flatness, rendering intent) in addition to the device-independent parameters (font, line width, line cap, line join, miter limit, dash pattern). If this flag is FALSE, only the device-independent parameters will be emitted. This flag overrides emitHalftones; if this is FALSE, then halftones are not emitted. The default value is TRUE.
boundingBox If all zeroes, is ignored. Otherwise, is used for %BoundingBox DSC comment and in centerCropBox calculations and for setpagedevice. The default value is [0 0 0 0].
useFontAliasNames Used when printing with system fonts. The default value is FALSE.
emitPageRotation Emit a concat at the beginning of each page so that the page is properly rotated. Used when emitting EPS. The default value is FALSE.
reverse If set to TRUE, reverse the order of page output.
tCropBox Temporary crop box to represent selected region.
emitPageClip Set to TRUE to emit page clip.
emitTransfer Set to TRUE to emit transfer.
emitBG Set to TRUE to emit black generation.
emitUCR Set to TRUE to emit undercolor removal.
farEastFontOpt Far East font option. Currently not used. Set to 0.
suppressCJKSubstitution If TRUE, do not do CJK substitution on the printer.
suppressCSA If TRUE, don't emit CSAs for 4 component (CMYK) colors.
hostBased For separator, do host-based color management.
hostBasedOutputCS The output color space when hostBased color management is TRUE.
duplex Currently not used. Set to 0.
doTiling Whether to tile none, all, or only large pages
tileInfo If non-NULL, tiling is desired with these parameters.
rotate Enable the auto-rotating behavior from past versions of Acrobat.
hostBasedCM Host base color management. Default: FALSE, do CSA generation for profiles instead of converting all colors on the host.
destProfile If hostBaseCM color management is TRUE, use this profile.
destCSAtom An atom representing the device color space (DeviceGray, DeviceRGB, etc.).
saveVM TRUE means try to save VM when printing to PostScript.
doOPP If TRUE, do the overprint preview operation.
suppressOPPWhenNoSpots When TRUE, suppress OPP for pages that do not contain spot colors
optimizeForSpeed If TRUE, do it fast; FALSE means PostScript code must be page independent. If set to TRUE, font downloads are forced from IG_PDF_INCLUDE_ON_EVERY_PAGE to IG_PDF_INCLUDE_ONCE_PER_DOC.
brokenCRDs If TRUE, don't set rendering intent in PostScript stream due to broken non-default CRDs.
useMaxVM If TRUE, store all possible resources in VM.
lastWidth Used when setPageSize is TRUE to prevent unneeded setpagedevice calls.
lastHeight Used when setPageSize is TRUE to prevent unneeded setpagedevice calls.
bitmapResolution DPI for bitmaps. Default is 300.
gradientResolution DPI for gradients interior to the object (not edges). Can generally be lower than the bitmapResolution. Default is 150.
transparencyQuality The transparency level. Range is 1-100.
ocContext The optional-content context to use for visibility state information, or NULL to use the document's current states in the default context.
applyOCGPrintOverrides When TRUE, apply print-specific visibility state settings from the optional-content group.
useFullResolutionJP2KData Whether to use the maximum available JPEG2000 resolution.
emitInRipSeps When TRUE, requests that separations, one sheet per ink, be generated in the RIP (printer).
whichMarks Page mark indication. A bit-wise OR of the enumIGPDFPageMarkFlags values.
westernMarksStyle When TRUE, use western style for page marks.
doProofing When TRUE, print using proofing settings.
proofProfile Description string for the proofing profile.
inkBlack Proofing settings: simulate ink black.
paperWhite Proofing settings: simulate paper white.
useExecForm When TRUE, emit execform calls when emitting Form XObjects.
flattenInfo A structure containing parameters that control tile flattening.
negative When TRUE, invert the plate.
mirrorprint PostScript mirroring attribute. Currently not used.
numCollatedCopies Enables collation for viewer.
emitFlatness Set to TRUE to emit flatness.
trapType Specifies trap type.
TTasCIDT2 Set to TRUE to emit TrueType fonts as CIDType2 instead of as CIDFontType0.
markStyle Specify the style to use for page marks.
lineWidth Line width to use for printer marks.
macQDPrinter Set to TRUE if the printer is a Mac QuickDraw printer.

customMarksFileName

If markStyle == -1, this should be a valid file name pointing to a valid .mrk file for custom printer marks.

pAGMPI

The AGMP interface pointer. Should be NULL.

disableFlattening

Disable flattening of the PDF file; transparency data will be ignored.

doNotDownloadFauxFonts

Allow user to select if faux files are downloaded.

suppressSnapToDevice

Allow user to control "Snap_To_Device".
suppressElement Unused. Set to 0.

Remarks:

All fields in the AT_PDF_PRINTPARAMS structure apply to PostScript file creation. AT_PDF_PRINTPARAMS are ignored when printing to non-PostScript devices.
©2012. Accusoft Corporation. All Rights Reserved.