cairo-text-extents (cr utf8)

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

A cairo-text-extents-t instance with the extents of utf8.

Gets the extents for a string of text. The extents describe a user-space rectangle that encloses the "inked" portion of the text, as it would be drawn by the cairo-show-text function. Additionally, the x-advance and y-advance values indicate the amount by which the current point would be advanced by the cairo-show-text function.

Note that whitespace characters do not directly contribute to the size of the rectangle (width and 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.