(v13) initialise in the pluggable font API

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

int initialise(sw_pfin * pfin, int reason);

Optional . This is called when the RIP starts, and allows the PFIN module to allocate storage, define fonts, and initialize itself. If the call returns anything other than SW_PFIN_SUCCESS, PFIN will not use the module and no further calls will be made (not even to finalize). A pointer to the module’s workspace may be stored in pfin.ws.

Reason is SW_PFIN_REASON_START or SW_PFIN_REASON_RESUME.