Merge pull request #4969 from nulano/release-notes

Release notes for TrueType functions and PyPy support
This commit is contained in:
mergify[bot] 2020-10-13 10:52:20 +00:00 committed by GitHub
commit 4658c0523f
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23

View File

@ -9,6 +9,12 @@ Python 3.5
Pillow has dropped support for Python 3.5, which reached end-of-life on 2020-09-13.
PyPy 7.1.x
^^^^^^^^^^
Pillow has dropped support for PyPy3 7.1.1.
PyPy3 7.2.0, released on 2019-10-14, is now the minimum compatible version.
im.offset
^^^^^^^^^
@ -41,6 +47,20 @@ Removed Use instead
API Changes
===========
ImageDraw.text: stroke_width
^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Fixed issue where passing ``stroke_width`` with a non-zero value
to :py:meth:`.ImageDraw.text` would cause the text to be offset by that amount.
ImageDraw.text: anchor
^^^^^^^^^^^^^^^^^^^^^^
The ``anchor`` parameter of :py:meth:`.ImageDraw.text` has been implemented.
Use this parameter to change the position of text relative to the
specified ``xy`` point. See :ref:`text-anchors` for details.
Add MIME type to PsdImagePlugin
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
@ -86,9 +106,47 @@ A new method :py:meth:`.ImageDraw.regular_polygon`, draws a regular polygon of `
For example ``draw.regular_polygon(((100, 100), 50), 5)``
draws a pentagon centered at the point ``(100, 100)`` with a polygon radius of ``50``.
ImageDraw.text: embedded_color
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
The methods :py:meth:`.ImageDraw.text` and :py:meth:`.ImageDraw.multiline_text`
now support fonts with embedded color data.
To render text with embedded color data, use the parameter ``embedded_color=True``.
Support for CBDT fonts requires FreeType 2.5 compiled with libpng.
Support for COLR fonts requires FreeType 2.10.
SBIX and SVG fonts are not yet supported.
ImageDraw.textlength
^^^^^^^^^^^^^^^^^^^^
Two new methods :py:meth:`.ImageDraw.textlength` and :py:meth:`.FreeTypeFont.getlength`
were added, returning the exact advance length of text with 1/64 pixel precision.
These can be used for word-wrapping or rendering text in parts.
ImageDraw.textbbox
^^^^^^^^^^^^^^^^^^
Three new methods :py:meth:`.ImageDraw.textbbox`, :py:meth:`.ImageDraw.multiline_textbbox`,
and :py:meth:`.FreeTypeFont.getbbox` return the bounding box of rendered text.
These functions accept an ``anchor`` parameter, see :ref:`text-anchors` for details.
Other Changes
=============
ImageDraw.text and ImageDraw.multiline_text
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Fixed multiple issues in methods :py:meth:`.ImageDraw.text` and :py:meth:`.ImageDraw.multiline_text`
sometimes causing unexpected text alignment issues.
The ``align`` parameter of :py:meth:`.ImageDraw.multiline_text` now gives better results in some cases.
TrueType fonts with embedded bitmaps are now supported.
Added writing of subIFDs
^^^^^^^^^^^^^^^^^^^^^^^^