From a43d5d3b4a15e9faf9c50e9c44aeb547cd53ce34 Mon Sep 17 00:00:00 2001 From: Matthias Clasen Date: Sun, 4 Aug 2019 15:57:03 -0400 Subject: docs: Add extent images Add an illustration of logical and ink rects. --- docs/meson.build | 2 ++ docs/rects1.png | Bin 0 -> 11457 bytes docs/rects2.png | Bin 0 -> 11910 bytes pango/glyphstring.c | 4 ++++ 4 files changed, 6 insertions(+) create mode 100644 docs/rects1.png create mode 100644 docs/rects2.png diff --git a/docs/meson.build b/docs/meson.build index 6f148221..419ab503 100644 --- a/docs/meson.build +++ b/docs/meson.build @@ -65,6 +65,8 @@ html_images = [ 'layout.png', 'pipeline.png', 'rotated-text.png', + 'rects1.png', + 'rects2.png', ] docdeps = [ libpango_dep ] diff --git a/docs/rects1.png b/docs/rects1.png new file mode 100644 index 00000000..a0dd9e93 Binary files /dev/null and b/docs/rects1.png differ diff --git a/docs/rects2.png b/docs/rects2.png new file mode 100644 index 00000000..e79ec448 Binary files /dev/null and b/docs/rects2.png differ diff --git a/pango/glyphstring.c b/pango/glyphstring.c index 007f8a34..6c674e03 100644 --- a/pango/glyphstring.c +++ b/pango/glyphstring.c @@ -271,6 +271,10 @@ pango_glyph_string_extents_range (PangoGlyphString *glyphs, * Compute the logical and ink extents of a glyph string. See the documentation * for pango_font_get_glyph_extents() for details about the interpretation * of the rectangles. + * + * Examples of logical (red) and ink (green) rects: + * + * ![](rects1.png) ![](rects2.png) */ void pango_glyph_string_extents (PangoGlyphString *glyphs, -- cgit v1.2.1