(v13) Instantiating plugin devices

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

The header file Common\include\gdevcnst.h defines a flag named

DEV_FLAG_INSTANTIATE_ONE_DEVICE which can  be  ORed  into HqnDeviceCapabilities-

>deviceFlags[0] during the D_FIND_DEVICE_TYPE selector call. See (v13) The HqnDeviceCapabilities structure . This flag causes automatic instantiation of the device type to which the HqnDeviceCapabilities refers. If the Plugin is “signed”, the device appears in the Configure RIP > Extras dialog until a valid password is entered to enable it. Enabled devices and those not password‐ protected are available for selection in the Page Setup dialog. Enabled devices which are not auto‐ instantiated may be instantiated explicitly by the user, via the Device Manager dialog. This system allows users to limit the visible devices to only those which they wish to use. Not all device types in a plugin need be instantiated, and the user can delete automatically instantiated devices in the Device Manager, where they are listed indistinguishably from explicitly instantiated devices.

A single‐device plugin's device is instantiated automatically at startup.