Created Date: 16 Mar, 2022 14:43
Last Modifed Date: 16 Mar, 2022 14:43
This page applies to Harlequin v13.1r0 and later; and to Harlequin Core but not Harlequin MultiRIP.
The Harlequin Core SDK supports many color output formats. Requests for different color output formats are performed using the setpagedevice
operator. Changes to the output format are matched using the ColorantFamilies
key in the SeparationDetails
sub-dictionary supplied to the setpagedevice
operator.
A Colorant Dictionary is a definition of a particular fixed set of data channels, their properties and behaviors on a printing device, and the names of the inks, varnishes, primers, and so on, that are represented by those channels. A printing device may have many different fixed sets of channels. A printing device may also support extra variable channels for spot colors and technical separations. A Colorant Family is a set of Colorant Dictionaries, possibly for different output devices, that define the same fixed sets of channels. In the Harlequin Core SDK ColorantFamilies
should be set using a setpagedevice
call during the boot-up process, for example in the Sys\HqnOEM file. It may also be set or overridden in a later configuration file or in the %config%
device PostScript language. The Harlequin Core SDK has a default setting for ColorantFamilies
that recognizes DeviceCMYK
, DeviceGray
, and DeviceRGB
color spaces. However it is recommended that the customer supply their own definition in place of the default.
When matching colorant families from pagedevice requests, the entries found must match the Plugin
and DeviceType
pagedevice values. The Plugin
and DeviceType
names are derived from their use in Harlequin MultiRIP. They have no semantic meaning in the Harlequin Core SDK; they are just keys used for selection of the colorant entries.
When matching pagedevice requests, the RIP builds a list of colorants from the pagedevice SeparationColorNames
key, augmented with the names of the default colorants from the process color space. This set of colors are matched against the colorant names for each colorant set dictionary in the DeviceTypes
array (see below). The most-specific match (matching the largest number of color names) for the specified Plugin
and DeviceType
is chosen as the output colorant family.
For more information about the SeparationDetails
dictionary see the Extensions Manual.