This page applies to Harlequin v13.1r0 and later; both Harlequin Core and Harlequin MultiRIP
|
Param |
Val |
ExType |
Vers |
Use? |
HPS |
Ref |
|
|
i |
H |
5.2r2 |
Y |
All |
|
ContoneMask provides an efficient way to distinguish between pixels that have been marked with a zero tone value and pixels that have not been marked at all in contone output, particularly when using external Harlequin VariData (eHVD).
It defaults to 0, in which case the output raster is generated as normal.
If a positive value of ContoneMask is set, then any pixel that would normally be painted with a tone value lower than the value of ContoneMask (after all other color conversions including calibration) is painted with ContoneMask. In the usual case with eHVD, ContoneMask may be set to 1. Any post-RIP recomposition code can then treat a tone value of 0 in the raster as representing a transparent pixel, and any other value as being marked (and therefore opaque).
For debugging purposes, a higher value may be set in order to see the effects more obviously.
A negative value of ContoneMask is allowed and indicates ContoneMask remapping is activated automatically by the RIP if it determines that is necessary (when it decides to apply HVD for the current set of pages). When remapping is activated, the absolute value of ContoneMask is used as the mask value.
ContoneMask applies to all contone output modes. The supplied ContoneMask must be in the range [ -(vpc-1) vpc-1 ] (vpc = values per component) or a rangecheck error will be given.
Anti-aliasing (ResamplingFactor) is not compatible with ContoneMask.
Default: 0