Package: cairo

Function cairo-show-text

Lambda List

cairo-show-text (cr utf8)

Arguments

cr -- a cairo-t context
utf8 -- a string of text encoded in UTF-8, or nil

Details

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.

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 the cairo-show-text function.

Note

The cairo-show-text function 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 the cairo-show-glyphs function for the "real" text display API in Cairo.
 

See also

*2021-12-12