From aaa473091d6c837b52f54d21e1ca3a884e42889a Mon Sep 17 00:00:00 2001
From: Matthias Clasen <mclasen@redhat.com>
Date: Sun, 8 Aug 2021 17:49:27 -0400
Subject: docs: Add some more images

Add a visual example of bidi reordering.
---
 docs/pango_bidi.md | 14 ++++++++++++++
 1 file changed, 14 insertions(+)

(limited to 'docs/pango_bidi.md')

diff --git a/docs/pango_bidi.md b/docs/pango_bidi.md
index 5d418422..996e9781 100644
--- a/docs/pango_bidi.md
+++ b/docs/pango_bidi.md
@@ -14,6 +14,20 @@ control over bidirectional setting of text, Pango provides APIs such as
 [func@unichar_direction], [func@find_base_dir], [func@get_mirror_char]
 or [func@Pango.BidiType.for_unichar].
 
+Here is an example for mixed-direction text (shown in logical order):
+
+<picture>
+  <source srcset="bidi-input-dark.png" media="(prefers-color-scheme: dark)">
+  <img alt="mixed-direction text, logical order" src="bidi-input-light.png">
+</picture>
+
+Pango reorders the text according to the direction of the runs:
+
+<picture>
+  <source srcset="bidi-annotate-dark.png" media="(prefers-color-scheme: dark)">
+  <img alt="mixed-direction text, visual order" src="bidi-annotate-light.png">
+</picture>
+
 # Vertical Text
 
 Pango is not only capable of vertical text layout, it can handle mixed vertical
-- 
cgit v1.2.1