(v13) Adding new dot shapes with HqnHtm

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

Using the procedures from the HqnHtm procset is a convenient way of adding new screen definitions. This may be done, for example, as part of RIP startup (by dropping them in SW/Sys/ExtraStart ) or as part of a configuration provided in SW/TestConfig . This allows screens to be packaged and distributed as file sets without having to edit sf.ps or any other files.

The procedure InstallHalftoneDef is used to install a single screen, defined as a dictionary. It takes two arguments: (1) A name and (2) a halftone dictionary. The name is defined in switchscreens to refer to the dictionary given. The dictionary must be in global VM.

The halftone name given to InstallHalftoneDef must be a name (and not a string). The halftone dictionary must be in global VM.

The procedure InstallHalftoneDefsFile is used to install a set of screens, as defined in a file organized like sf.ps. It takes one argument: a filename. The file is executed and the names it defined are added to switchscreens.

Examples:

            (%os%/MyHalftoneDefs)
            /HqnHtm /ProcSet findresource /InstallHalftoneDefsFile get exec
            currentglobal true setglobal
            /MyScreen << .. >>
            /HqnHtm /ProcSet findresource /InstallHalftoneDef get exec setglobal % restore global flag