From 9979612c72ebee4674bfd99eaabb373034b5efe4 Mon Sep 17 00:00:00 2001 From: Matthias Clasen Date: Fri, 27 Aug 2021 11:25:49 -0400 Subject: docs: Some detail for PangoGlyphGeometry --- pango/pango-glyph.h | 13 +++++++++++++ 1 file changed, 13 insertions(+) (limited to 'pango/pango-glyph.h') diff --git a/pango/pango-glyph.h b/pango/pango-glyph.h index 4dc77fd1..2094fa53 100644 --- a/pango/pango-glyph.h +++ b/pango/pango-glyph.h @@ -58,6 +58,19 @@ typedef gint32 PangoGlyphUnit; * * The `PangoGlyphGeometry` structure contains width and positioning * information for a single glyph. + * + * Note that @width is not guaranteed to be the same as the glyph + * extents. Kerning and other positioning applied during shaping will + * affect both the @width and the @x_offset for the glyphs in the + * glyph string that results from shaping. + * + * The information in this struct is intended for rendering the glyphs, + * as follows: + * + * 1. Render the current glyph at (x + x_offset, y + y_offset), + * where (x, y) is the current point + * 2. Advance the current point to (x + xoffset, y) + * 3. Render the next glyph... */ struct _PangoGlyphGeometry { -- cgit v1.2.1