Skip to main content
Skip table of contents

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.

JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.