summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorMatthias Clasen <mclasen@redhat.com>2021-08-08 17:49:27 -0400
committerMatthias Clasen <mclasen@redhat.com>2021-08-08 17:50:21 -0400
commitaaa473091d6c837b52f54d21e1ca3a884e42889a (patch)
tree6062f758add13a9ddc1fcad3084e3b81fdb04e38
parentb674819929ce158005130d22fe89d9c5e22a55bc (diff)
downloadpango-aaa473091d6c837b52f54d21e1ca3a884e42889a.tar.gz
docs: Add some more images
Add a visual example of bidi reordering.
-rw-r--r--docs/bidi-annotate-dark.pngbin0 -> 13582 bytes
-rw-r--r--docs/bidi-annotate-light.pngbin0 -> 13040 bytes
-rw-r--r--docs/bidi-annotate.pngbin0 -> 6839 bytes
-rw-r--r--docs/bidi-input-dark.pngbin0 -> 9122 bytes
-rw-r--r--docs/bidi-input-light.pngbin0 -> 8948 bytes
-rw-r--r--docs/bidi-input.pngbin0 -> 3030 bytes
-rw-r--r--docs/meson.build4
-rw-r--r--docs/pango.toml.in4
-rw-r--r--docs/pango_bidi.md14
9 files changed, 22 insertions, 0 deletions
diff --git a/docs/bidi-annotate-dark.png b/docs/bidi-annotate-dark.png
new file mode 100644
index 00000000..d462f7f4
--- /dev/null
+++ b/docs/bidi-annotate-dark.png
Binary files differ
diff --git a/docs/bidi-annotate-light.png b/docs/bidi-annotate-light.png
new file mode 100644
index 00000000..9e23f273
--- /dev/null
+++ b/docs/bidi-annotate-light.png
Binary files differ
diff --git a/docs/bidi-annotate.png b/docs/bidi-annotate.png
new file mode 100644
index 00000000..79756f7b
--- /dev/null
+++ b/docs/bidi-annotate.png
Binary files differ
diff --git a/docs/bidi-input-dark.png b/docs/bidi-input-dark.png
new file mode 100644
index 00000000..586d64ce
--- /dev/null
+++ b/docs/bidi-input-dark.png
Binary files differ
diff --git a/docs/bidi-input-light.png b/docs/bidi-input-light.png
new file mode 100644
index 00000000..932b1d32
--- /dev/null
+++ b/docs/bidi-input-light.png
Binary files differ
diff --git a/docs/bidi-input.png b/docs/bidi-input.png
new file mode 100644
index 00000000..fc1892ec
--- /dev/null
+++ b/docs/bidi-input.png
Binary files differ
diff --git a/docs/meson.build b/docs/meson.build
index a29f6578..21230ddd 100644
--- a/docs/meson.build
+++ b/docs/meson.build
@@ -26,6 +26,10 @@ pango_content_files = [
'm-west.png',
'm-north.png',
'm-east.png',
+ 'bidi-input-light.png',
+ 'bidi-input-dark.png',
+ 'bidi-annotate-light.png',
+ 'bidi-annotate-dark.png',
]
doc_conf = configuration_data()
diff --git a/docs/pango.toml.in b/docs/pango.toml.in
index 4c51b9aa..95143360 100644
--- a/docs/pango.toml.in
+++ b/docs/pango.toml.in
@@ -85,4 +85,8 @@ content_images = [
"m-west.png",
"m-north.png",
"m-east.png",
+ "bidi-input-light.png",
+ "bidi-input-dark.png",
+ "bidi-annotate-light.png",
+ "bidi-annotate-dark.png",
]
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