(v13) metrics in the pluggable font API


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


int metrics(sw_pfin * pfin, sw_pfin_font * font, sw_datum * glyph, float metrics[2]);

Required. Return the advance width of the specified glyph in glyph coordinate space, nominally a unit em square, though there is no restriction. The module will have to interrogate the font dictionary’s /WMode if it supports vertical writing.

glyph is either a string or an integer Font glyphs are normally specified by name, and CIDFont glyphs by index. If the module cannot supply the given glyph it returns SW_PFIN_UNKNOWN. PFIN is then likely to ask the module for the notdef glyph, by giving glyph the integer value zero, even if the unknown glyph had been a string.

UNKNOWN

No such glyph exists in the font.

INVALID

An error occurred whilst interrogating the font.

UNSUPPORTED

Some feature of the font is not supported by this module.