The configuration of the Print Agent printing parameters is provided for testing and troubleshooting reasons only. We do not support any other settings than the ones provided in the default ifs-printing.properties file.
The default location for the ifs-printing.properties file which consists the printing parameters, is the same location where the print agent instance is installed. The location and the name of this file are set in the ifs-printagent-config.xml. So the name and the location can be changed, and the relevant changes in ifs-printagent-config.xml should be done accordingly.
The printing parameters belong to one out of the two objects PrintParams and PrintUserParams. PrintParams are the print settings, primarily used for PostScript printers or PostScript outputs. PrintUserParams are the user print settings.
The configuration file for the Print Agent printing parameters is a .properties file and can look like this:
The syntax is object.parameter=value and ## denotes the start of a one line comment.
The following information is copied from Datalogics documentation for PDF Library version 10.0.
The printing parameters for the object PrintUserParams:
| Parameter | Value | Description |
|---|---|---|
| binaryOk | int | 1 turns on binary data, 0 turns it off. |
| collate | boolean | Collate property |
| doOpp | int | 1 uses OverPrint Preview, 0 does not. |
| driverName | java.lang.String | The name of the driver (for example, "winspool"). |
| emitHalftones | int | 1 turns on emit half-tones, 0 turns it off. |
| emitToFile | boolean | Create a PostScript file. |
| emitToPrinter | boolean | Output PDF file to a postScript printer. |
| farEastFontOpt | FarEastFont(DOWNLOAD_ALL, DOWNLOAD_NONE, PRINT_AS_IMAGE) | One of FarEastFont. The default value is Download All. |
| portName | java.lang.String | The name of the port (for example, "Ne00"). |
| printAnnots | int | 1 turns on printing annotations, 0 turns it off. |
| psLevel | int | PostScript level. |
| reverse | int | 1 reverses the print order, 0 does regular order. |
| shrinkToFit | boolean | True turns on binary data, 0 turns it off. |
| startResult | int | Spooler ID from StartDoc(). |
| transQuality | int | Transparency flattening quality control. |
The printing parameters for the object PrintParams:
| Parameter | Value | Description |
|---|---|---|
| applyOCGPrintOverrides | boolean | When true, apply print-specific visibility state settings from the optional-content group. |
| binaryOK | boolean | True if binary data is permitted in the PostScript file, false otherwise. |
| bitmapResolution | long | DPI for bitmaps. |
| boundingBox | rect | A rectangular frame that determines the dimension of an object that is placed inside a PDF document. (The BoundingBox is set by using PrintParams.BoundingBox=x1,y1,x2,y2) |
| brokenCRD | boolean | If true, do not set rendering intent in PostScript stream due to broken non-default CRDs. |
| centerCropBox | boolean | true if CropBox output is centered on the page when the CropBox < MediaBox, false otherwise. |
| disableFlattening | boolean | Disable flattening of the PDF file; transparency data will be ignored. |
| doOpp | boolean | Do the overprint preview operation. |
| doProofing | boolean | When true, print using proofing settings. |
| doTiling | PageTilingMode(NONE, TILE_ALL_PAGES, TILE_LARGE_PAGES) | Determines whether to tile non, all, or only large pages. |
| duplex | Duplex(TUMBLE_LONG, TUMBLE_SHORT, OFF, SIMPLEX, DUPLEX_OFF, DUPLEX_VERTICAL, DUPLEX_HORIZONTAL, DUPLEX_SHORTSIDE, DUPLEX_LONGSIDE) | Sets the duplex mode if the device supports duplex printing. |
| emitBG | boolean | Emit black generation. |
| emitColorSeps | boolean | Emit images for Level-1 separations. |
| emitDeviceExtGState | boolean | When emitting the extended graphics state, if this flag is true, 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). |
| emitFlatness | boolean | Honors the flatness setting over gstate flatness. |
| emitHalftones | boolean | Preserve any halftone screening in the PDF file. |
| emitInRipSeps | boolean | When true, it requests that separations, one sheet per ink, be generated in the RIP (printer). |
| emitPageClip | boolean | Emit page clip. |
| emitPageRotation | boolean | Emit a concat at the beginning of each page so that the page is properly rotated. |
| emitPS | boolean | If true, emit a PostScript file. |
| emitRawData | boolean | True if adding no unnecessary filters when emitting image data, false otherwise. |
| emitSeparableImagesOnly | boolean | If emitting EPS, include only CMYK and gray images. |
| emitTransfer | boolean | Emit transfer. |
| emitTTFontsFirst | boolean | Emit True Type fonts before any other fonts. |
| emitUCR | boolean | Emit undercolor removal. |
| expandToFit | boolean | True if small pages are to be scaled up to fit the printer page size, false otherwise. |
| farEastFontOpt | FarEastFont(DOWNLOAD_ALL, DOWNLOAD_NONE, PRINT_AS_IMAGE) | GDI to PS or download CJK fonts PDPDFarEastFont_Print_As_Image will not be honored. |
| gradientResolution | long | DPI for gradients interior to the object (not edges). |
| hostBasedCM | boolean | Do host Based color management using the destination profile. |
| incBaseFonts | Inclusion(BY_RANGE, NEVER, ON_EVERY_PAGE, ONCE_PER_DOCUMENT, WHEN NEEDED) | Embed the base fonts. |
| incCIDFonts | Inclusion(BY_RANGE, NEVER, ON_EVERY_PAGE, ONCE_PER_DOCUMENT, WHEN NEEDED) | Embed CID fonts. |
| incEmbeddedFonts | Inclusion(BY_RANGE, NEVER, ON_EVERY_PAGE, ONCE_PER_DOCUMENT, WHEN NEEDED) | Embed fonts that are embedded in the PDF file. |
| incOtherResources | Inclusion(BY_RANGE, NEVER, ON_EVERY_PAGE, ONCE_PER_DOCUMENT, WHEN NEEDED) | Include all other types of resources in the file. |
| incProcsets | Inclusion(BY_RANGE, NEVER, ON_EVERY_PAGE, ONCE_PER_DOCUMENT, WHEN NEEDED) | Include Procsets in the file. |
| incType1Fonts | Inclusion(BY_RANGE, NEVER, ON_EVERY_PAGE, ONCE_PER_DOCUMENT, WHEN NEEDED) | Embed True Type 1 fonts. |
| inkBlack | boolean | Proofing settings: simulate ink black. |
| lastHeight | int | Used when pageSize is true to prevent unneeded pagedevice calls. |
| lastWidth | int | Used when pageSize is true to prevent unneeded pagedevice calls. |
| lineWidth | float | The line weight to use for printer marks. |
| macQDPrinter | booelan | True if the printer is a Mac QuickDraw printer, false otherwise. |
| markStyle | int | Specify the style to use for page marks. |
| mirrorprint | int | One of the following constants:
Mirroring is done in the PostScript output stream. |
| negative | boolean | When true, invert the plate. |
| numCollatedCopies | long | Enables collation for the viewer. |
| optimizeForSpeed | boolean | If true, do it fast, false means PostScript code must be page-independent. |
| outputType | OutputType(EPSMAC_EXTENDED_PREVIEW, EPSMAC_STANDARD_PREVIEW, EPSNO_PREVIEW, POST_SCRIPT) |
Print PostScript or EPS with or without a preview. |
| paperWhite | boolean | Proofing settings: simulate paper white. |
| printWhat | PrintWhat(DOCUMENT, DOCUMENT_AND_COMMENTS, DOCUMENT_AND_STAMPS, FORM_FIELDS_ONLY) | Print the document, the document and comments or document form fields only. |
| printWhatAnnot | java.util.EnumSet<PrintWhatAnnotFlags>(NO_EXTRAS, PRINTER_MARKS, TRAP_ANNOTS) | Annotation flags which modify PDPrintWhat to enable Pro product behavior. |
| psLevel | int | PostScript level: 1,2 or 3. |
| reverse | boolean | If set to true, reverse the order of page output. |
| rotate | boolean | Enable auto-rotating behavior from past versions of Acrobat. |
| rotateAndCenter | boolean | True if the page is to be rotated to fit the printer's orientation and centered in the printer's page size; false, otherwise. |
| saveVM | boolean | True means try to save VM when printing to PostScript. |
| scale | float | The document-wide scale factor. |
| setPageSize | boolean | (PostScript level 2 only) Set the page size on each page. |
| shrinkToFit | boolean | True if the page is scaled to fit the printer page size; false, otherwise. |
| suppressCJKSubstitution | boolean | If true, do not do CJK substitution on the printer. |
| suppressCSA | boolean | Do not emit CSAs for 4-component (CMYK) colors. |
| suppressOPPWhenNoSpots | boolean | When true, suppress OPP for pages that do not contain spot colors. |
| transparencyQuality | long | The transparency flattening quality. |
| trapType | int | The trap type. |
| TTasCIDT2 | boolean | When this is set, emit True Type fonts as CIDType2 instead of as CIDFontType |
| TTasT42 | boolean | If including True Type fonts, convert to Type 42 fonts instead of Type 1 fonts. |
| useExecForm | boolean | When true, emit execform calls when emitting Form XObjects. |
| useFontAliasNames | boolean | Used when printing with system fonts. |
| useFullResolutionJP2KData | boolean | Determines wheter to use the maximum available JPEG2000 resolution. |
| useMaxVM | boolean | If true, store all possible resources in VM. |
| useSubFileDecode | boolean | Add subFileDecode filter to work around stream problems [false]. |
| westernMarksStyle | boolean | When true, use western style for page marks. |
| whichMarks | java.util.EnumSet<PageMarkFlags>(BLEED_MARKS, COLOR_BARS, CROP_MARKS, PAGE_INFO, REGISTRATION_MARKS, SLUR_MARKS, TRIM_MARKS) | Page mark indication. |