From 698c24350095b0ec31fa9dc60507a36cd5524328 Mon Sep 17 00:00:00 2001 From: Matthias Clasen Date: Sun, 22 Aug 2021 22:07:50 -0400 Subject: docs: Add another illustration Show font metrics. --- docs/fontmetrics-dark.png | Bin 0 -> 25402 bytes docs/fontmetrics-light.png | Bin 0 -> 19613 bytes docs/fontmetrics.svg | 1385 ++++++++++++++++++++++++++++++++++++++++++++ docs/meson.build | 4 +- docs/pango.toml.in | 2 + pango/pango-font.h | 8 + 6 files changed, 1398 insertions(+), 1 deletion(-) create mode 100644 docs/fontmetrics-dark.png create mode 100644 docs/fontmetrics-light.png create mode 100644 docs/fontmetrics.svg diff --git a/docs/fontmetrics-dark.png b/docs/fontmetrics-dark.png new file mode 100644 index 00000000..02508174 Binary files /dev/null and b/docs/fontmetrics-dark.png differ diff --git a/docs/fontmetrics-light.png b/docs/fontmetrics-light.png new file mode 100644 index 00000000..0b3396a5 Binary files /dev/null and b/docs/fontmetrics-light.png differ diff --git a/docs/fontmetrics.svg b/docs/fontmetrics.svg new file mode 100644 index 00000000..2844a9fa --- /dev/null +++ b/docs/fontmetrics.svg @@ -0,0 +1,1385 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + M + Mg + + + + + + + + + + + + + + + + + + + Height + Ascent + Descent + + + + + Strikethrough +thickness / position + Underline +position / thickness + + + + + + diff --git a/docs/meson.build b/docs/meson.build index 6bdfc1f7..9d42a7f2 100644 --- a/docs/meson.build +++ b/docs/meson.build @@ -33,7 +33,9 @@ pango_content_files = [ 'bidi-annotate-dark.png', 'split-cursor.png', 'split-cursor-light.png', - 'split-cursor-dark.png' + 'split-cursor-dark.png', + 'fontmetrics-light.png', + 'fontmetrics-dark.png', ] doc_conf = configuration_data() diff --git a/docs/pango.toml.in b/docs/pango.toml.in index f5e58194..6173d208 100644 --- a/docs/pango.toml.in +++ b/docs/pango.toml.in @@ -92,4 +92,6 @@ content_images = [ "bidi-annotate-dark.png", "split-cursor-light.png", "split-cursor-dark.png", + "fontmetrics-light.png", + "fontmetrics-dark.png", ] diff --git a/pango/pango-font.h b/pango/pango-font.h index 498338b2..e7272e3e 100644 --- a/pango/pango-font.h +++ b/pango/pango-font.h @@ -52,6 +52,14 @@ typedef struct _PangoFontDescription PangoFontDescription; * to a script. The fields of this structure are private to implementations * of a font backend. See the documentation of the corresponding getters * for documentation of their meaning. + * + * For an overview of the most important metrics, see: + * + * + * + * Font metrics + * + */ typedef struct _PangoFontMetrics PangoFontMetrics; -- cgit v1.2.1