D_GET_IDENTITY (PostScript device plugins)

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

D_GET_IDENTITY Selector

Parameter: IdentityParam *param

Call type: Single‐call

This is the first call any plugin receives from the RIP, and it determines the type of plugin: input, out‐ put or PSDEV, and allows the plugin to decide if it will run with the supplied version of the plugin interface. You must support this selector for PSDEVs otherwise the plugin will be assumed to be an output plugin.

Note: Any other kind of plugin introduced in the future will also be identified using this call.

Plugins should be compiled for the earliest version of the RIP in which they can run. For example, a new field is added to DEVICETYPE and the plugin tried to set the new field, for older versions of the RIP that do not have such a field, the plugin would be setting invalid memory. The fVersionOK field is used to inform the RIP whether the plugin can run with a given version of the RIP. See fVersionOK below for more details.

version

The field should be ignored.

pluginType

The PSDEV plugin should set this field to PT_POSTSCRIPT .

protocolVersion

This field allows for changes to the way in which plugins are accessed in the future while still sup‐ porting existing ones.

pluginInterfaceMajorVersion and pluginInterfaceMinorVersion

These fields are set by the RIP to specify the major and minor plugin interface version numbers, respectively. Version 17.0 was the first plugin interface version for PSDEVs.

fVersionOK

If the plugin can run with the given version of the RIP, this field should be set to TRUE . If this field is set to FALSE , further loading or use of the plugin is prevented.

The CHECK_VERSION macro is provided to simplify this:

p->fVersionOK = CHECK_VERSION (p, 18, 11);

This says that the plugin runs with any RIP containing plugin interface version 18.11or higher.