(v13) Getting multiple-device plugin configuration and capability data
This page applies to Harlequin v13.1r0 and later; and to Harlequin MultiRIP but not Harlequin Core
The RIP needs to know about the device or family of devices a plugin supports. This information is retrieved from a single‐device plugin simply enough, using the D_CAPABILITIES
selector. See (v13) D_CAPABILITIES
.
Multiple‐device plugins support an indeterminate number of devices. The RIP uses the D_FIND_DEVICE_TYPE
selector for multiple‐device plugins. See (v13) D_FIND_DEVICE_TYPE
.
The RIP also asks plugins to declare the raster data formats each device accepts, with the selector D_GET_RASTER_FORMAT
. If it is a multiple‐device plugin, the RIP keeps calling D_GET_RASTER_FORMAT
until the plugin has told it about acceptable raster formats for all the devices supported. See (v13) D_GET_RASTER_FORMAT
.
Once everything is set up, the RIP usually uses the D_SELECT_DEVICE
selector to tell the plugin which of its instantiated devices subsequent calls to D_OPEN
, D_OUTPUT
, D_IDLE
, D_CLOSE
, D_WAIT_ON_CLOSE
, D_OPEN_ENDJOB
, D_CLOSE_ENDJOB
, D_ERROR_ICON
and D_ERROR_TEXT
will refer to. The plugin must maintain a record of this “current OUTPUT device” so that subsequent calls refer to the correct device.
This should not be confused with the “device currently being configured”, which should be deter‐ mined and saved separately, during the D_GETDLGDEFN
call. In the example plugins, this is obtained by the use of the deviceFlags[1]
value in the HqnDeviceCapabilities
structure. For more information see: (v13) D_GETDLGDEFN
, (v13) D_GETDOOBRIS
, and (v13) D_GETSTRING
.