systemfonts is a package that locates installed fonts. It uses the system-native libraries on Mac (CoreText) and Linux (FontConfig), and uses Freetype to parse the fonts in the registry on Windows.
systemfonts is available from CRAN using
install.packages('systemfonts'). It is however still under development
and you can install the development version using devtools.
# install.packages('devtools') devtools::install_github('r-lib/systemfonts')
The main use of this package is to locate font files based on family and style:
library(systemfonts) match_font('Avenir', italic = TRUE) #> $path #>  "/System/Library/Fonts/Avenir.ttc" #> #> $index #>  1 #> #> $features #> NULL
This function returns the path to the file holding the font, as well as the 0-based index of the font in the file.
It is also possible to get a data.frame of all available fonts:
system_fonts() #> # A tibble: 678 x 9 #> path index name family style weight width italic monospace #> <chr> <int> <chr> <chr> <chr> <ord> <ord> <lgl> <lgl> #> 1 /System/Library… 2 Rockwel… Rockwell Bold bold norm… FALSE FALSE #> 2 /System/Library… 0 Notewor… Notewort… Light normal norm… FALSE FALSE #> 3 /Users/thomas/L… 0 SourceS… Source S… Bold… bold norm… TRUE FALSE #> 4 /System/Library… 1 Devanag… Devanaga… Bold bold norm… FALSE FALSE #> 5 /System/Library… 0 Kannada… Kannada … Regu… normal norm… FALSE FALSE #> 6 /System/Library… 0 Verdana… Verdana Bold bold norm… FALSE FALSE #> 7 /System/Library… 8 ArialHe… Arial He… Light light norm… FALSE FALSE #> 8 /System/Library… 10 AppleSD… Apple SD… Thin thin norm… FALSE FALSE #> 9 /System/Library… 0 DecoTyp… DecoType… Regu… normal norm… FALSE FALSE #> 10 /System/Library… 0 Trebuch… Trebuche… Ital… normal norm… TRUE FALSE #> # … with 668 more rows
Further, you can query additional information about fonts and specific
glyphs, if that is of interest using the
While getting this information in R is nice, the intended use is mostly through compiled code so that graphic devices can easily locate relevant font files etc.
In order to use functions from systemfonts in C(++) code your package
should list systemfonts in the
LinkingTo field in the
file. Once this is done you can now
#include <systemfonts.h> in your
code and use the provided functions. Look into the
file to familiarise yourself with the C API.
systemfonts will always try to find a font for you, even if none exist with the given family name or style. How it resolves this is system specific and should not be relied on, but it can be expected that a valid font file is always returned no matter the input.
A few special aliases exist that behaves predictably but system dependent:
"sans"return Helvetica on Mac, Arial on Windows, and the default sans-serif font on Linux (DejaVu Sans on Ubuntu)
"serif"return Times on Mac, Times New Roman on Windows, and the default serif font on Linux (DejaVu Serif on Ubuntu)
"mono"return Courier on Mac, Courier New on Windows, and the default mono font on Linux (DejaVu Mono on Ubuntu)
"emoji"return Apple Color Emoji on Mac, Segoe UI Emoji on Windows, and the default emoji font on Linux (Noto Color on Ubuntu)
Please note that the ‘systemfonts’ project is released with a Contributor Code of Conduct. By contributing to this project, you agree to abide by its terms.
Any scripts or data that you put into this service are public.
Add the following code to your website.
For more information on customizing the embed code, read Embedding Snippets.