strings_sizes: Compute strings sizes

In gdtools: Utilities for Graphical Rendering and Fonts Management

Compute strings sizes

Description

This function is a simple wrapper around systemfonts::string_metrics_dev(). It determines widths, ascent and descent in inches.

This function will replace the following functions defined in this file: str_extents(), str_metrics() and m_str_extents().

Usage

strings_sizes(
  x,
  fontname = "sans",
  fontsize = 10,
  bold = FALSE,
  italic = FALSE
)

Arguments

x	A character vector of strings to measure. All arguments are vectorized and recycled to match the length of x.
fontname	A character vector specifying the font family name (e.g., "sans", "serif", "mono"). Default is "sans". This argument is vectorized.
fontsize	A numeric vector specifying the font size in points. Default is 10. This argument is vectorized.
bold	A logical vector indicating whether the text should be bold. Default is FALSE. This argument is vectorized.
italic	A logical vector indicating whether the text should be italic. Default is FALSE. This argument is vectorized.

Examples

strings_sizes(letters)
strings_sizes("Hello World!", bold = TRUE, italic = FALSE,
  fontname = "sans", fontsize = 12)

gdtools documentation built on Nov. 6, 2025, 1:15 a.m.