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