Override in the page device
This page applies to Harlequin v13.1r0 and later; both Harlequin Core and Harlequin MultiRIP.
Override
is a special RIP extension, as it affects the operation of the setpagedevice
operator, rather than its effect on the resultant raster.
When Override
is set to an integer, subsequent calls to setpagedevice
are completely ignored unless their dictionary operands also contain an Override
key with a value greater than that already set.
However, because setpagedevice
is subject to gsave
and grestore
, at grestore
the page device reverts to the previous setting of its Override
key in force at the corresponding gsave
.
For example (assuming no Override
key is already in force):
gsave
<< /Override 1 ... >> setpagedevice
<< ... >> setpagedevice % ignored: no Override
<< /Override 2... >> setpagedevice
% acted on: Override level greater than 1
<< /Override 1 ... >> setpagedevice % ignored: less than 2
save % save implies gsave
<< ... >> setpagedevice % ignored: no Override
<< /Override 1 ... >> setpagedevice % ignored: less than 2
<< /Override 4 ... >> setpagedevice
% acted on: greater than 2
restore % back to Override level 2
<< /Override 2... >> setpagedevice % ignored: equal to 2
grestore
<< ... >> setpagedevice % acted on: no Override in force