CairoFonts {Cairo}

R Documentation

Set the fonts used for all Cairo graphics devices.

Description

CairoFonts initializes the fonts used for Cairo graphics devices.

Usage

CairoFonts(
	regular="Helvetica:style=Regular",
	bold="Helvetica:style=Bold",
	italic="Helvetica:style=Italic",
	bolditalic="Helvetica:style=Bold Italic,BoldItalic",
	symbol="Symbol", usePUA=TRUE
)

Arguments

regular	character; fontconfig pattern for the 'plain text' font.
bold	character; fontconfig pattern for the 'bold face' font.
italic	character; fontconfig pattern for the 'italic' font.
bolditalic	character; fontconfig pattern for the 'bold italic' font.
symbol	character; fontconfig pattern for the 'symbol' font.
usePUA	logical; if FALSE then symbols are using regular Unicode code points (supported by regular fonts), otherwise Private Unicode Area (PUA) of symbols is used (typically better propulated by specialized symbol fonts). R 4.0.0 or higher is required for usePUA=FALSE.

Details

This function sets the fonts for Cairo graphics devices globally; previously opened Cairo graphics devices will also use these fonts. The argument names correspond to the five values of the graphical parameter 'font', i.e. regular is 1, bold is 2, italic is 3, etc.

For an explanation of fontconfig patterns, see CairoFontMatch.

Known issues

• This function is only available when the cairo graphics library is configured with FreeType and Fontcofig support.

• R math symbols are supported, but require a "Symbol" font with the Adobe Symbol Encoding unless usePUA=FALSE is used (available in R 4.0.0 or higher only).

See Also

CairoFontMatch, Cairo, par,

Examples

## Not run: 
#
# The following fontconfig patterns define the free truetype fonts 
# available in the debian package 'ttf-freefont'.
# 
# Freesans is very similar to Helvetica
CairoFonts(
	regular="FreeSans:style=Medium",
	bold="FreeSans:style=Bold",
	italic="FreeSans:style=Oblique",
	bolditalic="FreeSans:style=BoldOblique"
)

## End(Not run)

---