(v13) Customizing the OPI procset

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

While the procset is loading, it runs a file called Usr/CustomOPI,if present. This file is expected to leave a single dictionary on the stack and the contents of that dictionary are merged into the main data set for the procset; in the same way that config items passed to HqnOPIconfig and HqnOPIimage are merged.

Dictionaries in the supplied config data are merged with dictionaries of the same name in the main data set. For example, the main procset data contains a dictionary called /HqnOPIHeaderCodes. If the config data also contains a dictionary by that name, all key-value pairs in the new dictionary are defined into the existing dictionary, creating new values, or overwriting pre-defined ones as appropriate.

You may use the CustomOPI file for altering default values, or for adding functionality to the procset without requiring that the procset file itself be edited, with the consequent requirement to re-edit it for new versions of the Harlequin RIP.