(v13) PageBufferSetup procedures

This page applies to Harlequin v13.1r0 and later; both Harlequin Core and Harlequin MultiRIP.

The PageBufferSetup procedure, a RIP extension, is executed after the page device raster has been set up and after built-in values have been transmitted to the %pagebuffer% device, but before BeginPage is executed.

If the Sys/ExtraPageDeviceKeys file introduces a boolean key /DoubleFacet, the following example shows how you can use PageBufferSetup to transmit its value to the %pagebuffer% device. (Remember that setdevparams requires /Password among its keys and that any page device key might be null).

            <<
              /PageBufferSetup { (%pagebuffer%) <<
                /DoubleFacet false % the default currentpagedevice /DoubleFacet known {
                  currentpagedevice /DoubleFacet get null ne {
                    pop currentpagedevice /DoubleFacet get
                  } if
                } if
              /Password 0
              >> setdevparams
            } bind
            ...
            >> setpagedevice

Device parameters can only be strings, names, integers, reals, or Booleans. Therefore values that are stored in the page device as arrays or in dictionaries must be decomposed into separate parameters for passing to the %pagebuffer% device.