Specifying Input and Output Tray Settings with DocBridge Mill
Often the page size is the only media (paper) related attribute set in files to be converted with DocBridge Mill
Often the page size is the only media (paper) related attribute set in files to be converted with DocBridge Mill. One reason is that not all data formats support media attributes, input trays or output destinations (stacker). If the file has to be printed on a specific paper type or from a specific input tray, without any user intervention, this information should be added to the output file created with DocBridge Mill.
In the example below the data format specific commands to select paper from the input tray "LargeCapacity" and direct output to the output destination "External Stacker" are added to the output file.
Before a specific input device or media can be specified, it has to be defined in the relevant DocBridge Mill filter profile.
Because the output format is PCL, the trays are configured in the <traylist> of the <output> section of the DocBridge Mill PCL filter profile - mffpcl.pro:
<traylist>
<inputtray deviceid='5' name="LargeCapacity" mediatype="preprinted"/>
<outputtray deviceid='4' name="ExternalStacker"/>
</traylist>
Input trays are defined as inputtray and output trays or stackers are defined as outputtray:
name
is used to reference the required device id. The value of this attribute is user defined, but should be unique within the tray list and not contain blanks.
deviceid
pecifies the actual id of the required printer tray. The device id´s are printer dependant, therefore the printer documentation should be consulted if the required device id is not known.
mediatype
specifies the requested media type to be used. Most commonly used media types are plain paper, special paper or transparency film. The supported media types are printer dependant, the printer documentation should be consulted before a media type is specified.
The attributes available in the input and output tray configurations depend on the selected output format. Refer to the Compart MFF Format Filters and Profiles Manual for more information.
Once the devices have been configured, they can be addressed via the DocBridge Mill: cpmcopy command line parameters.
The required parameters are:
tray
specify the input tray name as configured in the DocBridge Mill Filter profile
The Docponent equivalent is setpaperintray.
outtray
specify the output tray name as configured in the DocBridge Mill Filter profile
The Docponent equivalent is setpaperouttray.
profiledir
specify the location of the DocBridge Mill filter profiles.
cpmcopy –profiledir . –infile testfile.pdf –outfile –type pcl –tray LargeCapacity –outtray ExternalStacker
If the files are processed with DocBridge Mill: cpmill or with DocBridge Mill Toolkit, the following methods of the Page Docponent can be used to set the input or output trays:
input tray
page.setpaperintray(LargeCapacity)
output tray
page.setpaperouttray(ExternalStacker)
Note: If the input file already contains input tray or output tray settings, these are overwritten by the tray and outtray parameters.