Documentation

A Unicode code-point.

FontDef wraps FontFace from Wumpus-Core with file name information for the font loaders.

A family group of FontDefs (regular, bold, italic and bold-italic).

It is convenient for some higher-level text objects in Wumpus (particularly Doc in Wumpus-Drawing) to treat a font and its standard weights as the same entity. This allows Doc API to provide a bold operation to simply change to the the bold weight of the current family, rather than use the primitive set_font operation to change to an explicitly named font.

Extract the regular weight FontDef from a FontFamily.

Extract the bold weight FontDef from a FontFamily.

Note - this falls back to the regular weight if the font family has no bold weight. To get the bold weight or Nothing if it is not present use the record selector ff_bold.

Extract the italic weight FontDef from a FontFamily.

Note - this falls back to the regular weight if the font family has no italic weight. To get the italic weight or Nothing if it is not present use the record selector ff_italic.

Extract the bold-italic weight FontDef from a FontFamily.

Note - this falls back to the regular weight if the font family has no bold-italic weight. To get the bold-italic weight or Nothing if it is not present use the record selector ff_bold_italic.

A lookup function from code point to width vector.

The unit is always stored as a Double representing PostScript points.

Note - in PostScript terminology a width vector is not obliged to be left-to-right (writing direction 0). It could be top-to-bottom (writing direction 1).

FontMetrics store a subset of the properties available in a font file - enough to calculate accurate bounding boxes and positions for text.

 Bounding box representing the maximum glyph area.
 Width vectors for each character.
 Cap height
 Descender depth.

Because Wumpus always needs font metrics respective to the current point size, the actual fields are all functions.

A map between a font name and the respective FontMetrics.

lookupFont : name * font_table -> Maybe FontMetrics

Lookup a font in the font_table.

insertFont : name * font_metrics * font_table -> FontTable

Insert a named font into the font_table.

FontLoadMsg - type synonym for String.

FontLoadLog is a Hughes list of Strings, so it supports efficient append.

Print the loader errors from the FontLoadResult to std-out.

This ignores the Char code lookup and just returns the default advance vector.