(v13) define in the PFIN API

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

sw_pfin_result define(sw_pfin_define_context * context, sw_datum * fontname, sw_datum * id, sw_datum * encoding);

Defines a font. The font will be declared in the PostScript language as fontname (unless it was requested with the module instance’s name. For example, MyModule:ThisInstance#Fontname , where the instance prefix will automatically be added).

If fontname is an array, it contains a list of names all of which will be defined as this font. This may be useful for defining aliases.

The id uniquely identifies the font to the module and is likely to be an integer, string or array, but is entirely for the module’s use.

If encoding is NULL, the font is declared as a Font with StandardEncoding. If a string, it is a Font with that named encoding. Otherwise it must be an array. If this only contains strings, a Font is defined with this encoding array. Otherwise, the array must contain the Registry (string), Ordering (integer) and Supplement (string), and causes a CIDFont to be defined.