ExecFile in the HqnControl procset

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

ExecFile automatically detects the type of an input file, mounts the drive on which is found, and executes it. It may also be configured to apply passwords, to run specific page ranges and so on.

Note: If you intend to prepend PostScript language configuration instructions to PDF files you should use SubmitFile instead of ExecFile or pdfexec. For more information see SubmitFile in the HqnControl procset.

Note: Using ExecFile will not trigger simple imposition correctly when needed, and will probably lead to incorrect output, or an error that PostScript language files may not be used with some imposition schemes. See SubmitFile in the HqnControl procset for more information.

In its simplest form it takes the file name as a string:

(File.prn) /HqnControl /ProcSet findresource /ExecFile get exec

It can also take an optional dictionary argument, following the file name:

TEXT

(File.prn) <<
  /PageRange [ [ 1 3 ] ]
>> /HqnControl /ProcSet findresource /ExecFile get exec

The dictionary may contain any or all of the following keys. More keys may be added over time.

`FileType`	The value of this key must be a literal name describing the type of file. See below for possible values.
`ForceType`	If the value of this key is `true` and a `FileType` is supplied, then the file will be executed as the supplied `FileType`, even if automatic detection of the type does not indicate that the supplied `FileType` is correct. The default value is `false`.
`PageRange`	If this key is supplied, then only the requested pages from the job will be rendered. The format of the array value matches that documented for the `pdfexec` operator.
`Password`	If this key is provided, and if the file type being used supports passwords, then the password will be used in executing the file. Of the file types supplied as standard, only PDF supports passwords.

As shipped the following file types are supported:

`/PS`	PostScript (including Macintosh formatted EPS and EPS with no preview)
`/PDF`	Portable Document Format
`/EPS`	MS-DOS formatted EPS
`/TIFF`	TIFF and TIFF/IT-P1
`/JFIF`	JFIF and Photoshop JPEG
`/PNG`	Portable Network Graphics file format
`/BMP`	Bitmap image file format
`/JPEG2`	JPEG2000 image file format
`/GIF`	Graphics Interchange Format
`/WMPHOTO`	Windows Media Photo and HD Photo
`/FLAT`	Page buffer or flat appropriate for use with FlatOut (HMR only)

The list of file types which may be used can be extended by an OEM. See the Add~ procedures on the following pages.