On this Page

    -{prt}option

    Sets printer/driver-specific parameters.

    Syntax

    -{prt}option value

    Description

    prt specifies a printer name in the printer configuration file (.prt). For example, in the Default-LJ4.prt configuration file the LaserJet 4 is specified as <Printer Name="LJ4" Type="PCL" > . The prt value for this configuration would be LJ4. Use this to override settings in the printer configuration file. For example:

    -LJ4CombineDocuments yes

    causes all LJ4 output to print to a single spool file

    -PDFOutputfile myfile.pdf

    prints the PDF output to myfile.pdf

    Note that for the -Outputfile setting, Merge will do standard date/time substitutions as described in File Naming Conventions. In addition, if the file name contains a field name between square brackets as in [Field1], Merge does field substitutions in the same way it does for embedded fields within a text label. In the example below, Merge looks for a field with the name "myFileName" in the data. If it finds a field by that name it substitutes in its value. If no field is found, the square brackets and everything between them are removed from the resulting file name.

    -LJ4Outputfile $U/Output/[myFileName].pcl

    Note that $U is automatically defined as the User folder of the installation location.

    Example Printer Options

    Most settings in the .prt (configuration files) can be set on the command line. The command line setting will override the default settings in the configuration file. Here are a few that may be more common:

    -PDFBookmark Yes|No
    Turn on/off bookmark generation in pdf files.

    -PCLColor Yes|No
    Control whether a PCL printer prints in color or black-and-white.

    -prtCombineDocuments Yes|No
    Control if all documents in the job are in one PDF file / printer stream or not.

    -prtDuplex form|left|top|right|simplex
    (As of 3.0.003.13) specify the duplexing option to use for the prt output configuration. 

    -PDFEmbedData Yes|No
    (As of 3.0.003.10) if the -PDFEmbedData specification is given for PDF-based output, the data for the document will be embedded in the PDF. Technically, it adds:

    /PieceInfo <</DocOrigin <</LastModified (xxxx) /Private nn 0 R>> >>

    to the document catalog and creates object nn as an xml representation of the data. This applies to single document PDFs only, not combined documents. That is, PDFExtract cannot extract the data for a single document from a combined PDF. Instead, you always get the data for the full set of documents in the PDF file regardless of your possible document selection options. (As of 3.0.004.06) PDFExtract extracts only the data for those documents that were selected. (As of 3.0.003.13) use the script function _file.readPdfData() to extract that XML.

    -prtEmbedFonts Yes|No
    Embed fonts into PDF files or download fonts to printers.

    -PDFMode PDF/A
    Have PDF files be generated in PDF/A (archive) format.

    -PDFPageMode UseNone
    Add a PDF PageMode option to the generated file. Options include UseOutlines, UseThumbs, FullScreen. See your PDF reference manual for details. The UseThumbs, for instance, defaults to showing Thumbnail images of each page in the document in the PDF viewer.

    -prtOutputfile filename
    Specify individual filenames for each driver when using multiple print drivers.

    -prtOverwritefile Yes|No
    If the output file already exists should it be overwritten? If no, a suffix is added to make it unique.

    -prtSpoolerDocName "any name"
    Specify a custom document name for the spooler to show. See -spoolerDocName.

    -PDFTitle "any title"
    (As of 3.1.002.07) set the PDF property Title explicitly. The Title in the Acrobat File > Properties list is normally set to the PDF file name. This can be overridden by using the TagTitle object tag on the Form object, or by using the -Title or -PDFTitle option on the command line. Some versions of Acrobat will use this title as the text in the Acrobat tab when the pdf is displayed.

    See Also

    File Naming Conventions
    _printer
     _file
    Multiple Outputs