cairoShowText {RGtk2} | R Documentation

## cairoShowText

### Description

A drawing operator that generates the shape from a string of UTF-8 characters, rendered according to the current font_face, font_size (font_matrix), and font_options.

### Usage

    cairoShowText(cr, utf8)

### Arguments

``cr`` | [`Cairo`] a cairo context
``utf8`` | [char] a string of text encoded in UTF-8, or `NULL`

### Details

This function first computes a set of glyphs for the string of text. The first glyph is placed so that its origin is at the current point. The origin of each subsequent glyph is offset from that of the previous glyph by the advance values of the previous glyph.

After this call the current point is moved to the origin of where the next glyph would be placed in this same progression. That is, the current point will be at the origin of the final glyph offset by its advance values. This allows for easy display of a single logical string with multiple calls to `cairoShowText`.

Note: The `cairoShowText` function call is part of what the cairo designers call the "toy" text API. It is convenient for short demos and simple programs, but it is not expected to be adequate for serious text-using applications. See `cairoShowGlyphs` for the "real" text display API in cairo.

### Author(s)

Derived by RGtkGen from GTK+ documentation

[Package RGtk2 version 2.20.40 Index]