[pango/layout-docs: 4/7] docs: Improve image placement
- From: Matthias Clasen <matthiasc src gnome org>
- To: commits-list gnome org
- Cc:
- Subject: [pango/layout-docs: 4/7] docs: Improve image placement
- Date: Sun, 8 Aug 2021 21:50:43 +0000 (UTC)
commit cb27301a0ed591de6fe2121b0451e8f8e1226576
Author: Matthias Clasen <mclasen redhat com>
Date: Sun Aug 8 15:52:38 2021 -0400
docs: Improve image placement
Move the vertical text example up, in the bidi docs.
docs/pango_bidi.md | 9 ++++-----
1 file changed, 4 insertions(+), 5 deletions(-)
---
diff --git a/docs/pango_bidi.md b/docs/pango_bidi.md
index 1f77c1e0..dcb5ddf1 100644
--- a/docs/pango_bidi.md
+++ b/docs/pango_bidi.md
@@ -20,17 +20,16 @@ Pango is not only capable of vertical text layout, it can handle mixed vertical
and non-vertical text correctly. This section describes the types used for setting
vertical text parameters.
-The way this is implemented is through the concept of *gravity*. Gravity of
-normal Latin text is south. A gravity value of east means that glyphs will be
-rotated ninety degrees counterclockwise. So, to render vertical text one needs
+ <img alt="gravity west, rotated 90 degrees" align="right" valign="top" src="vertical.png">
+The way this is implemented is through the concept of *gravity*. Gravity tells glyphs which way is down, so
the gravity of normal Latin text is south. A gravity value of east means that glyphs will be rotated ninety
degrees
+counterclockwise. So, to render vertical text one needs
to set the gravity and rotate the layout using the matrix machinery already
in place. This has the huge advantage that most algorithms working on a
[class@Pango.Layout] do not need any change as the assumption that lines run
in the X direction and stack in the Y direction holds even for vertical text
layouts.
-Here is an example for some English text rendered with gravity west, rotated
-90 degrees: ![vertical english](vertical.png)
+Here is an example for some English text rendered with gravity west, rotated 90 degrees:
Applications should only need to set base gravity on [class@Pango.Context] in use,
and let Pango decide the gravity assigned to each run of text. This automatically
[
Date Prev][
Date Next] [
Thread Prev][
Thread Next]
[
Thread Index]
[
Date Index]
[
Author Index]