(v13) Override output target

This page applies to Harlequin v13.1r0 and later; and to Harlequin Core but not Harlequin MultiRIP

The -s switch can be used to override the value of /OutputTarget in the selected configuration file.

On the command line, to override the value of /OutputTarget, you can select None , FILE , PRINTER , SOCKET , and STREAM .

/None is a null device and creates no output. The /FILE option will output to a disk file and is the default value. /PRINTER is supported for PCL5 and PCL6 only, is only available on Windows, and outputs to the default printer. The /SOCKET option requires the -a (address) and -t (port) options and can, for example, be used to send data to a printer, such as a PCL6 printer. /STREAM output causes the output data to be written to %pipeline%/output For more information see streamdev.h. This will pass the input/output from/to a HqnReadStream/HqnWriteStream object.

The following table summarizes the available options:

NOTE:   A real IP address must be used rather than a hostname. Using a hostname causes the clrip to fail to open the raster file and produces the error:

(%%[ Error: ioerror; OffendingCommand: renderbands; File: %console% ]%%).

Outputting using the /STREAM and /SOCKET options requires that the data is contained within a single file. Therefore, page-by-page formats such as RLE and TIFF cannot be used. Output formats like RAW and PCL will output the data to one file, so are suitable for STREAM and SOCKET output. If an invalid output pagebuffer type and output target are specified the following error is written to stderr :

Invalid output type/destination combination

Example usage:

clrip -o PCL5 -s SOCKET -c RGBComposite300dpi myfile.pdf