(v13) outline in the pluggable font API

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

int outline(sw_pfin * pfin, sw_pfin_font * font, sw_datum * glyph);

Required. Build a path representation of glyph. The module will call move, line and curve as required. All subpaths are implicitly closed. font contains the size of a device pixel in glyph coordinate space (the nominal unit square) which is useful for implementing hinting or at least grid-fitting, which is highly recommended.

This is called immediately after a successful call to metrics (though a call to metrics is not necessarily followed by a call to outline consider the PostScript language stringwidth operator). Therefore, it may be advantageous to cache some glyph information during the metrics call if it is likely to be immediately useful to outline.

NOTE:  The PFIN interface does not yet support bit image fonts, or outline font formats with pre-prepared bit images.