RGtk2 (version 2.20.31)

cairoShowText: 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.