(v13) uid in the PFIN API

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

sw_pfin_result uid(sw_pfin_define_context * context, int * uid);

PFIN usually defines fonts with a new random UniqueID. This call enables the module instance to discover which UniqueID will be used for the font it is about to define, or to change it.

This allows the module to define fonts with specific UniqueIDs, or to reuse the same UniqueID when asked to define the same font again, improving font cache performance.