str_metrics: Get font metrics for a string.

In gdtools: Font Metrics and Font Management Utilities for R Graphics

Get font metrics for a string.

Description

Compute the width, ascent and descent of a single string in points using Cairo text measurement.

Usage

str_metrics(
  x,
  fontname = "sans",
  fontsize = 12,
  bold = FALSE,
  italic = FALSE,
  fontfile = ""
)

Arguments

x	Character vector of strings to measure (only the first element is used).
fontname	Font name.
fontsize	Font size in points.
bold, italic	Is text bold/italic?
fontfile	Path to a font file. If empty, the font is resolved by name via systemfonts.

Value

A named numeric vector with elements width, ascent and descent (unit is points).

Note

This function will be deprecated in a future release. Use strings_sizes() instead.

See Also

Other functions for font metrics: m_str_extents(), strings_sizes()

Examples

str_metrics("Hello World!")

gdtools documentation built on May 26, 2026, 1:06 a.m.