systemfonts: string_metrics_dev – R documentation

Become an expert in R — Interactive courses, Cheat Sheets, certificates and more!

string_metrics_dev

Get string metrics as measured by the current device

Description

This function is much like string_widths_dev() but also returns the ascent and descent of the string making it possible to construct a tight bounding box around the string.

Usage

string_metrics_dev(
  strings,
  family = "",
  face = 1,
  size = 12,
  cex = 1,
  unit = "cm"
)

Arguments

`strings`	A character vector of strings to measure
`family`	The font families to use. Will get recycled
`face`	The font faces to use. Will get recycled
`size`	The font size to use. Will get recycled
`cex`	The cex multiplier to use. Will get recycled
`unit`	The unit to return the width in. Either `"cm"`, `"inches"`, `"device"`, or `"relative"`

Value

A data.frame with width, ascent, and descent columns giving the metrics in the requested unit.

Examples

# Get the metrics as measured in cm (default)
string_metrics_dev(c('some text', 'a string with descenders'))

systemfonts

System Native Font Finding

v1.0.2

MIT + file LICENSE

Authors

Thomas Lin Pedersen [aut, cre] (<https://orcid.org/0000-0002-5147-4711>), Jeroen Ooms [aut] (<https://orcid.org/0000-0002-4035-0289>), Devon Govett [aut] (Author of font-manager), RStudio [cph]

Initial release