summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorMatthias Clasen <mclasen@redhat.com>2019-08-04 15:57:03 -0400
committerMatthias Clasen <mclasen@redhat.com>2019-08-04 15:57:03 -0400
commita43d5d3b4a15e9faf9c50e9c44aeb547cd53ce34 (patch)
tree915fb2ceeeab7cfb4adf47f819a09c74ee6af9e5
parente160a3cdf059ab8cd17a66655aa08616876d3376 (diff)
downloadpango-a43d5d3b4a15e9faf9c50e9c44aeb547cd53ce34.tar.gz
docs: Add extent images
Add an illustration of logical and ink rects.
-rw-r--r--docs/meson.build2
-rw-r--r--docs/rects1.pngbin0 -> 11457 bytes
-rw-r--r--docs/rects2.pngbin0 -> 11910 bytes
-rw-r--r--pango/glyphstring.c4
4 files changed, 6 insertions, 0 deletions
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
--- /dev/null
+++ b/docs/rects1.png
Binary files differ
diff --git a/docs/rects2.png b/docs/rects2.png
new file mode 100644
index 00000000..e79ec448
--- /dev/null
+++ b/docs/rects2.png
Binary files 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,