diff --git a/src/PIL/ImageFont.py b/src/PIL/ImageFont.py index 8be7f0f103f..b3a7cdb9880 100644 --- a/src/PIL/ImageFont.py +++ b/src/PIL/ImageFont.py @@ -955,6 +955,11 @@ def truetype(font=None, size=10, index=0, encoding="", layout_engine=None): encoding of any text provided in subsequent operations. :param layout_engine: Which layout engine to use, if available: :data:`.ImageFont.Layout.BASIC` or :data:`.ImageFont.Layout.RAQM`. + If it is available, Raqm layout will be used by default. + Otherwise, basic layout will be used. + + Raqm layout is recommended for all non-English text. If Raqm layout + is not required, basic layout will have better performance. You can check support for Raqm layout using :py:func:`PIL.features.check_feature` with ``feature="raqm"``.