summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorMatthias Clasen <mclasen@redhat.com>2021-08-08 18:09:02 +0000
committerMatthias Clasen <mclasen@redhat.com>2021-08-08 18:09:02 +0000
commit2fc159927c7b36be2d59edd991ecbdb558705284 (patch)
tree20ac6bae27da6f88548b0f90145f6ae11072cd08
parentb312191e48c2ea8f0894c4077af69f1aff6c195c (diff)
parentb69c5063162d779020f331f291431e250a769d5c (diff)
downloadpango-2fc159927c7b36be2d59edd991ecbdb558705284.tar.gz
Merge branch 'layout-docs' into 'main'
docs: Add more details See merge request GNOME/pango!393
-rw-r--r--docs/align-center-justify.pngbin0 -> 649 bytes
-rw-r--r--docs/align-center.pngbin0 -> 539 bytes
-rw-r--r--docs/align-left-justify.pngbin0 -> 622 bytes
-rw-r--r--docs/align-left.pngbin0 -> 513 bytes
-rw-r--r--docs/align-right-justify.pngbin0 -> 628 bytes
-rw-r--r--docs/align-right.pngbin0 -> 497 bytes
-rw-r--r--docs/pango.toml.in8
-rw-r--r--pango/pango-layout.c10
8 files changed, 17 insertions, 1 deletions
diff --git a/docs/align-center-justify.png b/docs/align-center-justify.png
new file mode 100644
index 00000000..c9244853
--- /dev/null
+++ b/docs/align-center-justify.png
Binary files differ
diff --git a/docs/align-center.png b/docs/align-center.png
new file mode 100644
index 00000000..a32ba3ca
--- /dev/null
+++ b/docs/align-center.png
Binary files differ
diff --git a/docs/align-left-justify.png b/docs/align-left-justify.png
new file mode 100644
index 00000000..4c6f3970
--- /dev/null
+++ b/docs/align-left-justify.png
Binary files differ
diff --git a/docs/align-left.png b/docs/align-left.png
new file mode 100644
index 00000000..775c0721
--- /dev/null
+++ b/docs/align-left.png
Binary files differ
diff --git a/docs/align-right-justify.png b/docs/align-right-justify.png
new file mode 100644
index 00000000..430c57e5
--- /dev/null
+++ b/docs/align-right-justify.png
Binary files differ
diff --git a/docs/align-right.png b/docs/align-right.png
new file mode 100644
index 00000000..05968f2a
--- /dev/null
+++ b/docs/align-right.png
Binary files differ
diff --git a/docs/pango.toml.in b/docs/pango.toml.in
index c4a1c11e..0b1cef06 100644
--- a/docs/pango.toml.in
+++ b/docs/pango.toml.in
@@ -71,5 +71,11 @@ content_images = [
"rects1.png",
"rects2.png",
"arabic-markup.png",
- "blue-text.png"
+ "blue-text.png",
+ "align-left.png",
+ "align-center.png",
+ "align-right.png",
+ "align-left-justify.png",
+ "align-center-justify.png",
+ "align-right-justify.png",
]
diff --git a/pango/pango-layout.c b/pango/pango-layout.c
index b39ca62b..e0475a5e 100644
--- a/pango/pango-layout.c
+++ b/pango/pango-layout.c
@@ -45,6 +45,16 @@
*
* ![Pango Layout Parameters](layout.png)
*
+ * The following images demonstrate the effect of alignment and
+ * justification on the layout of text:
+ *
+ * | | |
+ * | --- | --- |
+ * | ![align=left](align-left.png) | ![align=left, justify](align-left-justify.png) |
+ * | ![align=center](align-center.png) | ![align=center, justify](align-center-justify.png) |
+ * | ![align=right](align-right.png) | ![align=right, justify](align-right-justify.png) |
+ *
+ *
* It is possible, as well, to ignore the 2-D setup,
* and simply treat the results of a `PangoLayout` as a list of lines.
*/