Using HqnImpose2 for overlays without imposing any pages

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

The preceding text describes the use of the HqnImpose2 for imposing multiple pages together. From Harlequin 12, however, a calling point for HqnImpose2 only adds an overlay, without imposing any pages (HqnInitOverlay).

HqnInitOverlay must be called with a dictionary argument on the operand stack in exactly the same way as HqnInitImpose,; the dictionary contents are the same, except that any entries that would amend the position, scaling, or rotation of the page (or request more than one page per flat) are prohibited. This includes: Strategy, Tactic, Aspect, ~Gutter, FilmLeft, ~Right, ~Bottom, ~Top, and PassThroughData.

HqnInitOverlay is fully compatible with the internal mode of HVD; use it to add additional marks over PDF pages. It is not, however, compatible with external HVD.

Alternatively, you can use HqnInitOverlay to paint pages that contain only variable data. You can trigger the overlays with a simple sequence of showpage calls (for example, to produce 100 pages you can use 100 { showpage } repeat).