selectFontFace

Selects a family and style of font from a simplified description as a family name, slant and weight. There is no operation to list available family names on the system, but the standard CSS2 generic family names, (serif, sans-serif, cursive, fantasy, monospace), are likely to work as expected. If fontFamily starts with the string cairo :, or if no native font backends are compiled in then Cairo will use an internal font family. The internal font family recognizes many modifiers in the family string, most notably it recognizes the string monospace. That is, the family name cairo :monospace will use the monospace version of the internal font family.

For real font selection, see the font-backend-specific font_face_create functions for the font backend you are using. (For example, if you are using the freetype-based cairo-ft font backend, see cairo_ft_font_face_create_for_ft_face or cairo_ft_font_face_create_for_pattern) The resulting font face could then be used with cairo_scaled_font_create, and cairo_set_scaled_font. Similarly when using the real font support you can call directly into the underlying font system (such as fontconfig or freetype) for operations such as listing available fonts, etc.

It is expected that most applications will need to use a more comprehensive font handling, and text layout library (for example, Pango), in conjunction to this library. If text is drawn without a call to selectFontFace (nor selectFontFace nor cairo_set_scaled_font) then the default family is platform-specific, but is essentially sans-serif. Default slant is FontSlant.NORMAL, and default weight is FontWeight.NORMAL.

Parameters

Parameters

Parameters