Added ImageText

Author: radarhere

Tests/test_imagetext.py

@@ -0,0 +1,41 @@
+from __future__ import annotations
+
+import pytest
+
+from PIL import ImageFont, ImageText
+
+from .helper import skip_unless_feature
+
+FONT_PATH = "Tests/fonts/FreeMono.ttf"
+
+
+@pytest.fixture(
+    scope="module",
+    params=[
+        pytest.param(ImageFont.Layout.BASIC),
+        pytest.param(ImageFont.Layout.RAQM, marks=skip_unless_feature("raqm")),
+    ],
+)
+def layout_engine(request: pytest.FixtureRequest) -> ImageFont.Layout:
+    return request.param
+
+
+@pytest.fixture(scope="module")
+def font(layout_engine: ImageFont.Layout) -> ImageFont.FreeTypeFont:
+    return ImageFont.truetype(FONT_PATH, 20, layout_engine=layout_engine)
+
+
+def test_get_length(font: ImageFont.FreeTypeFont) -> None:
+    assert ImageText.ImageText("A", font).get_length() == 12
+    assert ImageText.ImageText("AB", font).get_length() == 24
+    assert ImageText.ImageText("M", font).get_length() == 12
+    assert ImageText.ImageText("y", font).get_length() == 12
+    assert ImageText.ImageText("a", font).get_length() == 12
+
+
+def test_get_bbox(font: ImageFont.FreeTypeFont) -> None:
+    assert ImageText.ImageText("A", font).get_bbox() == (0, 4, 12, 16)
+    assert ImageText.ImageText("AB", font).get_bbox() == (0, 4, 24, 16)
+    assert ImageText.ImageText("M", font).get_bbox() == (0, 4, 12, 16)
+    assert ImageText.ImageText("y", font).get_bbox() == (0, 7, 12, 20)
+    assert ImageText.ImageText("a", font).get_bbox() == (0, 7, 12, 16)

docs/reference/ImageText.rst

@@ -0,0 +1,30 @@
+.. py:module:: PIL.ImageText
+.. py:currentmodule:: PIL.ImageText
+
+:py:mod:`~PIL.ImageText` module
+===============================
+
+The :py:mod:`~PIL.ImageText` module defines a class with the same name. Instances of
+this class provide a way to use fonts with text strings or bytes. The result is a
+simple API to apply styling to pieces of text and measure them.
+
+Example
+-------
+
+::
+
+    from PIL import Image, ImageDraw, ImageFont, ImageText
+    font = ImageFont.truetype("Tests/fonts/FreeMono.ttf", 24)
+
+    text = ImageText.ImageText("Hello world", font)
+    text.embed_color()
+    text.stroke(2, "#0f0")
+
+    print(text.get_length())  # 154.0
+    print(text.get_bbox())  # (-2, 3, 156, 22)
+
+Methods
+-------
+
+.. autoclass:: PIL.ImageText.ImageText
+    :members:

docs/reference/index.rst

@@ -24,6 +24,7 @@ Reference
    ImageSequence
    ImageShow
    ImageStat
+   ImageText
    ImageTk
    ImageTransform
    ImageWin