Get general information about a font, relative to a given size. Size specific measures will be returned in pixel units. The function is vectorised to the length of the longest argument.
Usage
font_info(
family = "",
italic = FALSE,
bold = FALSE,
size = 12,
res = 72,
path = NULL,
index = 0
)Arguments
- family
The name of the font families to match
- italic
logical indicating the font slant
- bold
logical indicating whether the font weight
- size
The pointsize of the font to use for size related measures
- res
The ppi of the size related mesures
- path, index
path an index of a font file to circumvent lookup based on family and style
Value
A data.frame giving info on the requested font + size combinations. The data.frame will contain the following columns:
- path
The path to the font file
- index
The 0-based index of the font in the fontfile
- family
The family name of the font
- style
The style name of the font
- italic
A logical giving if the font is italic
- bold
A logical giving if the font is bold
- monospace
A logical giving if the font is monospace
- weight
A factor giving the weight of the font
- width
A factor giving the width of the font
- kerning
A logical giving if the font supports kerning
- color
A logical giving if the font has color glyphs
- scalable
A logical giving if the font is scalable
- vertical
A logical giving if the font is vertical
- n_glyphs
The number of glyphs in the font
- n_sizes
The number of predefined sizes in the font
- n_charmaps
The number of character mappings in the font file
- bbox
A bounding box large enough to contain any of the glyphs in the font
- max_ascend
The maximum ascend of the tallest glyph in the font
- max_descent
The maximum descend of the most descending glyph in the font
- max_advance_width
The maximum horizontal advance a glyph can make
- max_advance_height
The maximum vertical advance a glyph can make
- lineheight
The height of a single line of text in the font
- underline_pos
The position of a potential underlining segment
- underline_size
The width the the underline
Examples
font_info('serif')
#> # A tibble: 1 × 24
#> path index family style italic bold monospace weight width kerning
#> <chr> <int> <chr> <chr> <lgl> <lgl> <lgl> <ord> <ord> <lgl>
#> 1 /usr/sha… 0 DejaV… Book FALSE FALSE FALSE normal norm… TRUE
#> # ℹ 14 more variables: color <lgl>, scalable <lgl>, vertical <lgl>,
#> # n_glyphs <int>, n_sizes <int>, n_charmaps <int>, bbox <list>,
#> # max_ascend <dbl>, max_descend <dbl>, max_advance_width <dbl>,
#> # max_advance_height <dbl>, lineheight <dbl>, underline_pos <dbl>,
#> # underline_size <dbl>
# Avoid lookup if font file is already known
sans <- match_fonts('sans')
font_info(path = sans$path, index = sans$index)
#> # A tibble: 1 × 24
#> path index family style italic bold monospace weight width kerning
#> <chr> <int> <chr> <chr> <lgl> <lgl> <lgl> <ord> <ord> <lgl>
#> 1 /usr/sha… 0 DejaV… Book FALSE FALSE FALSE normal norm… TRUE
#> # ℹ 14 more variables: color <lgl>, scalable <lgl>, vertical <lgl>,
#> # n_glyphs <int>, n_sizes <int>, n_charmaps <int>, bbox <list>,
#> # max_ascend <dbl>, max_descend <dbl>, max_advance_width <dbl>,
#> # max_advance_height <dbl>, lineheight <dbl>, underline_pos <dbl>,
#> # underline_size <dbl>