Skip to main content
Skip table of contents

(v13) The HqnImage procset

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

This procset provides image file support procedures for rendering from native BMP, JPEG, JFIF, JPEG2000, PNG, and TIFF files.

The HqnImage procset contains several functions that can be used, in sequence, to process certain formats of image directly in the RIP without the need to convert them into another PDL.

The functions and the sequence of calling are as follows:

HqnImageSetImageDefaults

Amends the default options set for future calls to HqnImage . Takes a dictionary of configuration options as an argument. This means that the defaults may be set at RIP boot time, or in a TestConfig or Page Feature ; they will then be applied to TIFF files submitted as jobs in their own right rather than needing a PostScript control file to be constructed for each one.

analyseimage

Checks that the file stream is valid and that it is possible to open the image context. It takes three arguments:

  • The image file to process which can be either the file name or a file object.
  • A dictionary of configuration items (Optional).
  • An array of file types to process, as names, or null (Required). Supported file types are currently /BMP , /PNG , /JPEG , /JPEG2000 , /TIFF and /WMPHOTO . If the file submitted is not one of those listed in the array, analyseimage will return false . It returns true if the file exists and the image context can be opened; otherwise, it will return false . A value of null means to accept all image file types.

analyzeimage

From Harlequin 13, analyzeimage is available as a synonym of analyseimage .

getimagedetails

Returns a dictionary of image parameters. It takes no arguments but assumes analyseimage has been called immediately before to setup the name of the image file to be processed. It returns a dictionary of image data and true if it succeeds or false if it fails.

Note: After getimagedetails and before runimage , it is possible to setup and adjust images as required for media size, orientation and so on, but the new configuration options in Harlequin 13 mean that this will not normally be necessary.

runimage

Process the image. Takes one argument, a dictionary of configuration items, and assumes analyseimage and getimagedetails have been run.

onepassrunimage

Available from Harlequin 13. Combines analyseimage , getimagedetails and runimage into a single call. It takes the same three arguments as analyseimage .

JavaScript errors detected

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

If this problem persists, please contact our support.