(v13) Install procedures

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

Install is a standard PostScript Level 2 page device hook (see [RB2], section 4.11). Install is executed after all the media matching and raster setup has been completed, but before the first call of BeginPage and before the graphics state has been reinitialized with initgraphics and the raster cleared with erasepage. Therefore, Install should not attempt to do any painting.

When writing Install procedures it is important to remember that setpagedevice and therefore Install is likely to be called several times. Page Setup or other configuration files call it more than once, and a job may often call it at least once, possibly more (although some jobs never call setpagedevice themselves; for example, raw EPSF). Therefore, implementations cannot rely on a counter initialized outside the Install procedure, for example. However, all versions of the RIP make at least one call while starting up, so the Install procedure is always called at least once for each job, whether or not the job itself calls setpagedevice.

A particular use of Install which should be mentioned specially: because setpagedevice initializes a default screen (as mentioned above, this is done in the default Install procedure).

This means that a page feature or configuration file that tries to set up a screen (with setscreen or sethalftone), expecting it to be the default, may well work for some jobs when tested; however, it then may not work when a job is executed that calls setpagedevice itself.

Always execute the sethalftone in the Install procedure, not directly.