From d3b974b78607d36fbfa392b80c81adbd08d277ac Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sat, 17 Feb 2024 11:19:32 +1100
Subject: [PATCH 1/6] Use font in ImageDraw examples

---
 docs/deprecations.rst       | 8 ++++----
 docs/releasenotes/9.2.0.rst | 8 ++++----
 2 files changed, 8 insertions(+), 8 deletions(-)

diff --git a/docs/deprecations.rst b/docs/deprecations.rst
index 205fcb9ab..a58ce9bcb 100644
--- a/docs/deprecations.rst
+++ b/docs/deprecations.rst
@@ -232,10 +232,10 @@ Previous code::
 
     im = Image.new("RGB", (100, 100))
     draw = ImageDraw.Draw(im)
-    width, height = draw.textsize("Hello world")
+    width, height = draw.textsize("Hello world", font)
 
     width, height = font.getsize_multiline("Hello\nworld")
-    width, height = draw.multiline_textsize("Hello\nworld")
+    width, height = draw.multiline_textsize("Hello\nworld", font)
 
 Use instead::
 
@@ -247,9 +247,9 @@ Use instead::
 
     im = Image.new("RGB", (100, 100))
     draw = ImageDraw.Draw(im)
-    width = draw.textlength("Hello world")
+    width = draw.textlength("Hello world", font)
 
-    left, top, right, bottom = draw.multiline_textbbox((0, 0), "Hello\nworld")
+    left, top, right, bottom = draw.multiline_textbbox((0, 0), "Hello\nworld", font)
     width, height = right - left, bottom - top
 
 FreeTypeFont.getmask2 fill parameter
diff --git a/docs/releasenotes/9.2.0.rst b/docs/releasenotes/9.2.0.rst
index b875edf8e..3b8d2535f 100644
--- a/docs/releasenotes/9.2.0.rst
+++ b/docs/releasenotes/9.2.0.rst
@@ -69,10 +69,10 @@ Previous code::
 
     im = Image.new("RGB", (100, 100))
     draw = ImageDraw.Draw(im)
-    width, height = draw.textsize("Hello world")
+    width, height = draw.textsize("Hello world", font)
 
     width, height = font.getsize_multiline("Hello\nworld")
-    width, height = draw.multiline_textsize("Hello\nworld")
+    width, height = draw.multiline_textsize("Hello\nworld", font)
 
 Use instead::
 
@@ -84,9 +84,9 @@ Use instead::
 
     im = Image.new("RGB", (100, 100))
     draw = ImageDraw.Draw(im)
-    width = draw.textlength("Hello world")
+    width = draw.textlength("Hello world", font)
 
-    left, top, right, bottom = draw.multiline_textbbox((0, 0), "Hello\nworld")
+    left, top, right, bottom = draw.multiline_textbbox((0, 0), "Hello\nworld", font)
     width, height = right - left, bottom - top
 
 API Additions

From 617b9cbc00759f042d2c38ea63a14adca2bc902b Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sat, 17 Feb 2024 11:50:48 +1100
Subject: [PATCH 2/6] Describe difference between size and bbox

---
 docs/deprecations.rst       | 4 ++++
 docs/releasenotes/9.2.0.rst | 4 ++++
 2 files changed, 8 insertions(+)

diff --git a/docs/deprecations.rst b/docs/deprecations.rst
index a58ce9bcb..c90ad481a 100644
--- a/docs/deprecations.rst
+++ b/docs/deprecations.rst
@@ -252,6 +252,10 @@ Use instead::
     left, top, right, bottom = draw.multiline_textbbox((0, 0), "Hello\nworld", font)
     width, height = right - left, bottom - top
 
+Previously, the ``size`` methods returned a ``height`` that included the vertical
+offset of the text, while the new ``bbox`` methods explicitly distinguish this as a
+``top`` offset.
+
 FreeTypeFont.getmask2 fill parameter
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
diff --git a/docs/releasenotes/9.2.0.rst b/docs/releasenotes/9.2.0.rst
index 3b8d2535f..495926ca7 100644
--- a/docs/releasenotes/9.2.0.rst
+++ b/docs/releasenotes/9.2.0.rst
@@ -89,6 +89,10 @@ Use instead::
     left, top, right, bottom = draw.multiline_textbbox((0, 0), "Hello\nworld", font)
     width, height = right - left, bottom - top
 
+Previously, the ``size`` methods returned a ``height`` that included the vertical
+offset of the text, while the new ``bbox`` methods explicitly distinguish this as a
+``top`` offset.
+
 API Additions
 =============
 

From 55d0289a7dd5f5261e89b9084fbeac681bf2d626 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Mon, 19 Feb 2024 17:08:21 +1100
Subject: [PATCH 3/6] Added image to illustrate size vs bbox

---
 docs/deprecations.rst         |   8 ++++++--
 docs/example/size_vs_bbox.png | Bin 0 -> 12934 bytes
 docs/releasenotes/9.2.0.rst   |   8 ++++++--
 3 files changed, 12 insertions(+), 4 deletions(-)
 create mode 100644 docs/example/size_vs_bbox.png

diff --git a/docs/deprecations.rst b/docs/deprecations.rst
index c90ad481a..74021a218 100644
--- a/docs/deprecations.rst
+++ b/docs/deprecations.rst
@@ -253,8 +253,12 @@ Use instead::
     width, height = right - left, bottom - top
 
 Previously, the ``size`` methods returned a ``height`` that included the vertical
-offset of the text, while the new ``bbox`` methods explicitly distinguish this as a
-``top`` offset.
+offset of the text, while the new ``bbox`` methods distinguish this as a ``top``
+offset.
+
+.. image:: ./example/size_vs_bbox.png
+    :alt: Demonstration of size height vs bbox top and bottom
+    :align: center
 
 FreeTypeFont.getmask2 fill parameter
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
diff --git a/docs/example/size_vs_bbox.png b/docs/example/size_vs_bbox.png
new file mode 100644
index 0000000000000000000000000000000000000000..11a05d2a8146a612741c7e4ec4d3cf0ce05a35a0
GIT binary patch
literal 12934
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
S1_tO*7#T?giAu0x(EkB>8JTGS

literal 0
HcmV?d00001

diff --git a/docs/releasenotes/9.2.0.rst b/docs/releasenotes/9.2.0.rst
index 495926ca7..db514068f 100644
--- a/docs/releasenotes/9.2.0.rst
+++ b/docs/releasenotes/9.2.0.rst
@@ -90,8 +90,12 @@ Use instead::
     width, height = right - left, bottom - top
 
 Previously, the ``size`` methods returned a ``height`` that included the vertical
-offset of the text, while the new ``bbox`` methods explicitly distinguish this as a
-``top`` offset.
+offset of the text, while the new ``bbox`` methods distinguish this as a ``top``
+offset.
+
+.. image:: ./example/size_vs_bbox.png
+    :alt: Demonstration of size height vs bbox top and bottom
+    :align: center
 
 API Additions
 =============

From 7490aee8362c589a475035bf86c05b29c894593c Mon Sep 17 00:00:00 2001
From: Nulano <nulano@nulano.eu>
Date: Mon, 19 Feb 2024 20:18:18 +0100
Subject: [PATCH 4/6] Show how to use anchors to align text in imagefont
 deprecations

---
 docs/deprecations.rst       | 24 ++++++++++++++++++++++++
 docs/releasenotes/9.2.0.rst | 24 ++++++++++++++++++++++++
 2 files changed, 48 insertions(+)

diff --git a/docs/deprecations.rst b/docs/deprecations.rst
index 74021a218..9efb1316d 100644
--- a/docs/deprecations.rst
+++ b/docs/deprecations.rst
@@ -260,6 +260,30 @@ offset.
     :alt: Demonstration of size height vs bbox top and bottom
     :align: center
 
+If you are using these methods for aligning text, consider using :ref:`text-anchors` instead
+which avoid issues that can occur with non-English text or unusual fonts.
+For example, instead of the following code::
+
+    from PIL import Image, ImageDraw, ImageFont
+
+    font = ImageFont.truetype("Tests/fonts/FreeMono.ttf")
+
+    im = Image.new("RGB", (100, 100))
+    draw = ImageDraw.Draw(im)
+    width, height = draw.textsize("Hello world", font)
+    x, y = (100 - width) / 2, (100 - height) / 2
+    draw.text((x, y), "Hello world", font=font)
+
+Use instead::
+
+    from PIL import Image, ImageDraw, ImageFont
+
+    font = ImageFont.truetype("Tests/fonts/FreeMono.ttf")
+
+    im = Image.new("RGB", (100, 100))
+    draw = ImageDraw.Draw(im)
+    draw.text((100 / 2, 100 / 2), "Hello world", font=font, anchor="mm")
+
 FreeTypeFont.getmask2 fill parameter
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
diff --git a/docs/releasenotes/9.2.0.rst b/docs/releasenotes/9.2.0.rst
index db514068f..e8bf33b60 100644
--- a/docs/releasenotes/9.2.0.rst
+++ b/docs/releasenotes/9.2.0.rst
@@ -97,6 +97,30 @@ offset.
     :alt: Demonstration of size height vs bbox top and bottom
     :align: center
 
+If you are using these methods for aligning text, consider using :ref:`text-anchors` instead
+which avoid issues that can occur with non-English text or unusual fonts.
+For example, instead of the following code::
+
+    from PIL import Image, ImageDraw, ImageFont
+
+    font = ImageFont.truetype("Tests/fonts/FreeMono.ttf")
+
+    im = Image.new("RGB", (100, 100))
+    draw = ImageDraw.Draw(im)
+    width, height = draw.textsize("Hello world", font)
+    x, y = (100 - width) / 2, (100 - height) / 2
+    draw.text((x, y), "Hello world", font=font)
+
+Use instead::
+
+    from PIL import Image, ImageDraw, ImageFont
+
+    font = ImageFont.truetype("Tests/fonts/FreeMono.ttf")
+
+    im = Image.new("RGB", (100, 100))
+    draw = ImageDraw.Draw(im)
+    draw.text((100 / 2, 100 / 2), "Hello world", font=font, anchor="mm")
+
 API Additions
 =============
 

From 64579510c018440edb1b0c9c67f36d478f969f38 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Tue, 20 Feb 2024 21:37:06 +1100
Subject: [PATCH 5/6] Updated alt text

---
 docs/deprecations.rst       | 2 +-
 docs/releasenotes/9.2.0.rst | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/docs/deprecations.rst b/docs/deprecations.rst
index 74021a218..9fd64fdaa 100644
--- a/docs/deprecations.rst
+++ b/docs/deprecations.rst
@@ -257,7 +257,7 @@ offset of the text, while the new ``bbox`` methods distinguish this as a ``top``
 offset.
 
 .. image:: ./example/size_vs_bbox.png
-    :alt: Demonstration of size height vs bbox top and bottom
+    :alt: In bbox methods, top measures the vertical distance above the text, while bottom measures that plus the vertical distance of the text itself. In size methods, height also measures the vertical distance above the text plus the vertical distance of the text itself.
     :align: center
 
 FreeTypeFont.getmask2 fill parameter
diff --git a/docs/releasenotes/9.2.0.rst b/docs/releasenotes/9.2.0.rst
index db514068f..b596a6ab2 100644
--- a/docs/releasenotes/9.2.0.rst
+++ b/docs/releasenotes/9.2.0.rst
@@ -94,7 +94,7 @@ offset of the text, while the new ``bbox`` methods distinguish this as a ``top``
 offset.
 
 .. image:: ./example/size_vs_bbox.png
-    :alt: Demonstration of size height vs bbox top and bottom
+    :alt: In bbox methods, top measures the vertical distance above the text, while bottom measures that plus the vertical distance of the text itself. In size methods, height also measures the vertical distance above the text plus the vertical distance of the text itself.
     :align: center
 
 API Additions

From 56a02b76eb403356436e6480c5ada23930825e36 Mon Sep 17 00:00:00 2001
From: Andrew Murray <3112309+radarhere@users.noreply.github.com>
Date: Tue, 20 Feb 2024 21:37:40 +1100
Subject: [PATCH 6/6] Corrected image path
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Co-authored-by: Ondrej Baranovič <nulano@nulano.eu>
---
 docs/releasenotes/9.2.0.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/releasenotes/9.2.0.rst b/docs/releasenotes/9.2.0.rst
index b596a6ab2..677438bc6 100644
--- a/docs/releasenotes/9.2.0.rst
+++ b/docs/releasenotes/9.2.0.rst
@@ -93,7 +93,7 @@ Previously, the ``size`` methods returned a ``height`` that included the vertica
 offset of the text, while the new ``bbox`` methods distinguish this as a ``top``
 offset.
 
-.. image:: ./example/size_vs_bbox.png
+.. image:: ../example/size_vs_bbox.png
     :alt: In bbox methods, top measures the vertical distance above the text, while bottom measures that plus the vertical distance of the text itself. In size methods, height also measures the vertical distance above the text plus the vertical distance of the text itself.
     :align: center