3.3.4.4 Font specifications

A font can be specified in three ways:

None, meaning the default font
a Unicode string that represents a full font name, such as u'LatinBold19'
a plain string symbolic name that refers to a font setting currently specified by the UI framework
as a two or three element tuple, where
- the first element is the font name (unicode or string) or None for default font
- the second element is the font height in pixels or None for default size
- the third (optional) element is the flags applied to the font or None for default options.

The flags are the following:

FONT_BOLD bold
FONT_ITALIC italic
FONT_SUBSCRIPT subscript
FONT_SUPERSCRIPT superscript
FONT_ANTIALIAS forces the font to be antialiased
FONT_NO_ANTIALIAS forces the font to not be antialiased

You can combine the flags with the binary or operator ``|''. For example, the flags setting FONT_BOLD|FONT_ITALIC will produce text that is both bold and italic.

Note: Antialiasing support is only available for scalable fonts.

You can obtain a list of all available fonts with the appuifw module function available_fonts.

The symbolic names for UI fonts are:

'normal'
'dense'
'title'
'symbol'
'legend'
'annotation'

Since background processes have no access to the UI framework, these symbolic names are not supported in them. You need to specify the full font name.

See About this document... for information on suggesting changes.