Calibration groups
This page applies to Harlequin v13.1r0 and later; both Harlequin Core and Harlequin MultiRIP.
The type 6 calibration dictionary allows the use of calibration groups containing multiple calibration sets. Each calibration set contains a set of curves for each colorant and criteria, such as the page resolution, or halftone for which this calibration set applies. When calibration groups are in effect, the RIP will select the best calibration set from the group to use for each object and colorant channel on the page, based on comparing the criteria in the /WarningsCriteria
dictionaries for the calibration sets to the properties of each object. If, for example, different objects on a single page use different dot shapes, a calibration group can be used to ensure that the appropriate calibration set is applied to each object.
For information about installing these dictionaries as calibrations, see The setcalibration operator.
Type 6 dictionary form
This section describes the format of the Type 6 calibration dictionary.
% Type 6 dictionary-based calibration
<<
/CalibrationType 6
/MissingCalibrationAbort Boolean
/Device [ << … >> … << … >> ] or << … >>
/Tone [ << … >> … << … >> ] or << … >>
/IntendedPress [ << … >> … << … >> ] or << … >>
/ActualPress [ << … >> … << … >> ] or << … >>
>>
The sub-dictionaries, shown here by << ... >>
are the Calibration set sub-dictionaries.
Key description:
| (Required), always has value |
| (Required), when set to |
| (Optional), four types of calibration curves can be supplied. Their values are either an array of calibration set sub-dictionaries (forming a calibration group), or a single calibration set sub-dictionary. For more information see Calibration set sub-dictionaries. When a single calibration set sub-dictionary is specified, the RIP will attempt to use this regardless of whether the criteria, for example the halftone, match the object to which it is being applied. Warnings would, however, be issued and the job would be aborted if By contrast, if an array of dictionaries is specified (even if it contains only one calibration sub-dictionary), this will be treated as a calibration group and the job will be aborted if its criteria do not match the object and colorant being calibrated, regardless of the value of |
Calibration set sub-dictionaries
This section describes the contents of a calibration set sub-dictionary:
<<
/Cyan dict
/Magenta dict
/Yellow dict
/Black dict
/Default dict
/Spot1 dict
/Spot2 dict
/WarningsCriteria dict
/ForceSolids Boolean % default false
/NegativePrint Boolean % default false
/CalibrationName name or string
/BumpUpCurve array
>>
Key description:
| (Optional), their values must be type 2 colorant sub-dictionaries. The keys including |
| (Optional), when the calibration set sub-dictionary is part of a group these criteria act as selection criteria, specifying the circumstances under which a particular calibration set should be used. When the calibration set is not part of a group, these criteria can be used to specify when there will be warnings about use of unsuitable calibration sets. In this case the behavior is as for type 5 calibration dictionaries. For more information about this case see WarningsCriteria subdictionary (N-color calibration) and Curve-related subdictionaries (N-color calibration). If present,
TEXT
/Frequency is the screen frequency range for which this calibration applies.
If any of these entries are absent it implies that this calibration set may be used for any value of the relevant condition. For example, if |
| (Optional), |
| (Optional), set |
| (Optional), if two calibration sub-dictionaries in a group would be an equally good match for the object and colorant channel in use, the one whose |
| (Optional), this key is only relevant to |
Type 2 colorant sub-dictionaries
The values associated with each colorant are dictionaries containing the calibration curves for the colorant. There may be a /Default
colorant sub-dictionary which will be used for all colorants for which there is no explicitly named dictionary. In addition, the /Curve
from the /Default
colorant subdictionary is a default for all the colorant sub-dictionaries, so will be used for any cases where the colorant sub-dictionary is present but does not contain a /Curve
key.
If a colorant sub-dictionary does not have a /Curve
entry and there is no /Default
entry either, it uses the /Black
entry if present. Failing that, it falls back to linear.
The possible keys in each colorant dictionary are:
/colorant_key <<
/CalibrationType 2
/Curve array
/ForceSolids Boolean % default false
>>
Key description:
| (Required), must have value |
| (Optional), the
|
| (Optional), set to |
Legend:
- SNV - ScriptWorks Nominal Value
- NDC - Nominal Device Code
- SGV - ScriptWorks Golden Value
For more information on SNV, NDC and SGV values, see Calibration array details.
All of these formats are supported for all 4 curve types, that is, Device
, ActualPress
, Tone
, or IntendedPress
. However, the extended form containing two sub-arrays is only likely to be useful for Device
and possibly ActualPress
. For order of application, see Order of application of calibration and transfer functions.
The two subarrays, if present, do not have to contain the same number of pairs. Each array or sub-array must either be zero length (which implies linear calibration), or contain at least two calibration points (4 values).
At least some of the NDC or SGV values must be in the range 0
through 1
, with values outside this range ignored. The values should be strongly monotonic in each curve: that is, strictly increasing or decreasing with no values equal.
SNV values in the arrays are expected to overlap the range of 0
through 1
and be weakly monotonic in each curve: that is, consistently increasing or decreasing but allowing consecutive values to be equal. Some values may be outside the range of 0
through 1
but only that part of the range that lies in the range 0
through 1
is used by setcalibration
.
Tone curves can be inverted though they must still be monotonic. Again, the RIP will support the extended form of tone curves if provided.