svglite produces SVG files containing plain text but fonts are still important for plot generation and rendering. Fonts are used during SVG generation to figure out the metrics of graphical elements. The font name is then recorded in the
font-family property of text anchors so that SVG renderers know what fonts to use. svglite does try to ensure a consistent figure rendering even when fonts are not available at the time of rendering (by supplying the textLength SVG text attribute). However, the text may look slightly distorted when a fallback font is used. This means that for optimal display, the font must be available on both the computer used to create the svg, and the computer used to render the svg. The defaults are fonts that are available on almost all systems: there may be small differences between them, but they are unlikely to cause problems in most causes.
|R family||Font on Windows||Font on Unix|
||Times New Roman||Times|
||Standard Symbols L||Symbol|
One downside to these default fonts is that they do not have good coverage of characters for non-latin alphabets. This can be fixed by using the arguments
user_fonts which provide control over which fonts to use during SVG generation and rendering.
system_fonts takes a named list of font families as argument. The names typically correspond to standard R faces but they can also alias non-standard families (though this is less useful):
If you need support for non-latin characters, choose fonts with good Unicode coverage. “Arial Unicode MS” is a sans serif font with good coverage that is available on macOS and Windows systems (on the latter, only if MS Office is installed). Note that this font does not support kerning and has no bold or italic faces.
The Noto fontset provided by Google as well as the Han Sans family by Adobe have excellent coverage but may not be available at the time of rendering. This can be a concern if you distribute the SVG files on the Internet.
In addition to system fonts, you can also provide fonts that are not necessarily installed on the system (i.e., fonts that live in user space). The main reason to do this is to generate reproducible SVG files as different platforms can have different versions of a font and thus produce different text metrics. The
user_fonts arguments takes either paths to font files, fonts from the
fontquiver package, or a list that specifies the alias. Whereas
system_fonts gets a named list of families as argument,
user_fonts takes a named tree of lists of families (
symbol) and faces (
# Using ttf files from fontquiver here, but it could be any ttf some_file <- fontquiver::font("Liberation", "Sans", "Regular")$ttf other_file <- fontquiver::font("Liberation", "Sans", "Italic")$ttf serif_file <- fontquiver::font("Liberation", "serif", "Italic")$ttf # The outer named list contains families while the inner named list # contains faces: fonts <- list( sans = list( plain = some_file, italic = other_file ), serif = list(plain = serif_file) ) ss <- svglite("plot.svg", user_fonts = fonts) plot.new() text(0.5, 0.5, "Sans Plain text") text(0.2, 0.2, "Sans Italic text", font = 3) text(0.8, 0.8, "Serif text", family = "serif") dev.off()
You can also control which font gets written in the
font-family fields of SVGs by supplying a list containing
fontquiver fonts are particularly useful for creating reproducible SVG files. The
vdiffr package uses svglite with fontquiver fonts to create visual unit tests reliably across platforms. The Liberation fontset is appropriate for this usage because it features all 12 combinations of standard R families and faces. In addition fontquiver provides Symbola for the symbol font. The function
fontquiver::font_families() produces a list with the appropriate structure and can be directly supplied to svglite:
The C library Fontconfig is used as backend to find fonts installed on the system. Fontconfig is the standard interface to system fonts on Linux systems. It is also provided on macOS alongside the X11 graphics system and comes with R on Windows. A warning is issued if Fontconfig cannot find a system font. The gdtools package provides tools in case you have trouble with a particular font:
Sometimes Fontconfig cannot find a font because it is not configured correctly. Use the
debug argument to find out which configuration files Fontconfig is currently using:
See https://www.freedesktop.org/software/fontconfig/fontconfig-user.html for more information on configuring Fontconfig.