cairoScaledFontTextExtents: cairoScaledFontTextExtents

Description Usage Arguments Details Value Author(s)

View source: R/cairoFuncs.R

Description

Gets the extents for a string of text. The extents describe a user-space rectangle that encloses the "inked" portion of the text drawn at the origin (0,0) (as it would be drawn by cairoShowText if the cairo graphics state were set to the same font_face, font_matrix, ctm, and font_options as scaled.font). Additionally, the x_advance and y_advance values indicate the amount by which the current point would be advanced by cairoShowText.

Usage

1
cairoScaledFontTextExtents(scaled.font, utf8)

Arguments

scaled.font

[CairoScaledFont] a CairoScaledFont

utf8

[char] a string of text, encoded in UTF-8

Details

Note that whitespace characters do not directly contribute to the size of the rectangle (extents.width and extents.height). They do contribute indirectly by changing the position of non-whitespace characters. In particular, trailing whitespace characters are likely to not affect the size of the rectangle, though they will affect the x_advance and y_advance values. Since 1.2

Value

A list containing the following elements:

extents

[CairoTextExtents] a CairoTextExtents which to store the retrieved extents.

Author(s)

Derived by RGtkGen from GTK+ documentation


RGtk2 documentation built on Oct. 14, 2021, 5:08 p.m.