Advanced OPI usage

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

In some circumstances it may be appropriate for the code which calls HqnOPIimage to define the file channel on which the high-resolution data is supplied itself (rather than to have the procset attempt to find the file), and to set the type of the file that arrives on that channel.

In these cases, the OPI data dictionary passed to HqnOPIimage should be extended by adding the following keys:

HqnFileChannel (OPI configuration)

A file object opened on the high-resolution data to be used.

HqnFileType (OPI configuration)

The type of the high-resolution data. Select from the following list:

The HqnFileType key is only appropriate for use with OPI images, but HqnFileChannel may be used for single file DCS version 2 data, as well. The equivalent for DCS1 and multiple-file DCS2 formats is the subFileChannel value in the subsidiary dictionaries of the Hqn_F dictionary.