RGtk2 (version 2.20.31)

cairoScaledFontGlyphExtents: cairoScaledFontGlyphExtents

Description

Gets the extents for a list of glyphs. The extents describe a user-space rectangle that encloses the "inked" portion of the glyphs, (as they would be drawn by cairoShowGlyphs 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 cairoShowGlyphs.

Usage

cairoScaledFontGlyphExtents(scaled.font, glyphs, num.glyphs)

Arguments

glyphs
[CairoGlyph] a list of glyph IDs with X and Y offsets.
num.glyphs
[integer] the number of glyphs in the glyphs list

Value

A list containing the following elements:
extents
[CairoTextExtents] a CairoTextExtents which to store the retrieved extents.

Details

Note that whitespace glyphs do not contribute to the size of the rectangle (extents.width and extents.height).