mirror of
https://github.com/python-pillow/Pillow.git
synced 2024-09-21 03:18:57 +03:00
144 lines
4.8 KiB
ReStructuredText
144 lines
4.8 KiB
ReStructuredText
8.2.0
|
|
-----
|
|
|
|
Deprecations
|
|
============
|
|
|
|
Tk/Tcl 8.4
|
|
^^^^^^^^^^
|
|
|
|
Support for Tk/Tcl 8.4 is deprecated and will be removed in Pillow 10.0.0 (2023-01-02),
|
|
when Tk/Tcl 8.5 will be the minimum supported.
|
|
|
|
Categories
|
|
^^^^^^^^^^
|
|
|
|
``im.category`` is deprecated and will be removed in Pillow 10.0.0 (2023-01-02),
|
|
along with the related ``Image.NORMAL``, ``Image.SEQUENCE`` and
|
|
``Image.CONTAINER`` attributes.
|
|
|
|
To determine if an image has multiple frames or not,
|
|
``getattr(im, "is_animated", False)`` can be used instead.
|
|
|
|
API Changes
|
|
===========
|
|
|
|
Image.alpha_composite: dest
|
|
^^^^^^^^^^^^^^^^^^^^^^^^^^^
|
|
|
|
When calling :py:meth:`~PIL.Image.Image.alpha_composite`, the ``dest`` argument now
|
|
accepts negative co-ordinates, like the upper left corner of the ``box`` argument of
|
|
:py:meth:`~PIL.Image.Image.paste` can be negative. Naturally, this has effect of
|
|
cropping the overlaid image.
|
|
|
|
Image.getexif: EXIF and GPS IFD
|
|
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
|
|
|
|
Previously, :py:meth:`~PIL.Image.Image.getexif` flattened the EXIF IFD into the rest of
|
|
the data, losing information. This information is now kept separate, moved under
|
|
``im.getexif().get_ifd(0x8769)``.
|
|
|
|
Direct access to the GPS IFD dictionary was possible through ``im.getexif()[0x8825]``.
|
|
This is now consistent with other IFDs, and must be accessed through
|
|
``im.getexif().get_ifd(0x8825)``.
|
|
|
|
These changes only affect :py:meth:`~PIL.Image.Image.getexif`, introduced in Pillow
|
|
6.0. The older ``_getexif()`` methods are unaffected.
|
|
|
|
Image._MODEINFO
|
|
^^^^^^^^^^^^^^^
|
|
|
|
This internal dictionary has been deprecated by a comment since PIL, and is now
|
|
removed. Instead, ``Image.getmodebase()``, ``Image.getmodetype()``,
|
|
``Image.getmodebandnames()``, ``Image.getmodebands()`` or ``ImageMode.getmode()``
|
|
can be used.
|
|
|
|
API Additions
|
|
=============
|
|
|
|
ImageDraw.rounded_rectangle
|
|
^^^^^^^^^^^^^^^^^^^^^^^^^^^
|
|
|
|
Added :py:meth:`~PIL.ImageDraw.ImageDraw.rounded_rectangle`. It works the same as
|
|
:py:meth:`~PIL.ImageDraw.ImageDraw.rectangle`, except with an additional ``radius``
|
|
argument. ``radius`` is limited to half of the width or the height, so that users can
|
|
create a circle, but not any other ellipse.
|
|
|
|
.. code-block:: python
|
|
|
|
from PIL import Image, ImageDraw
|
|
im = Image.new("RGB", (200, 200))
|
|
draw = ImageDraw.Draw(im)
|
|
draw.rounded_rectangle(xy=(10, 20, 190, 180), radius=30, fill="red")
|
|
|
|
ImageShow.IPythonViewer
|
|
^^^^^^^^^^^^^^^^^^^^^^^
|
|
|
|
If IPython is present, this new :py:class:`PIL.ImageShow.Viewer` subclass will be
|
|
registered. It displays images on all IPython frontends. This will be helpful
|
|
to users of Google Colab, allowing ``im.show()`` to display images.
|
|
|
|
It is lower in priority than the other default :py:class:`PIL.ImageShow.Viewer`
|
|
instances, so it will only be used by ``im.show()`` or :py:func:`.ImageShow.show()`
|
|
if none of the other viewers are available. This means that the behaviour of
|
|
:py:class:`PIL.ImageShow` will stay the same for most Pillow users.
|
|
|
|
Saving TIFF with ICC profile
|
|
^^^^^^^^^^^^^^^^^^^^^^^^^^^^
|
|
|
|
As is already possible for JPEG, PNG and WebP, the ICC profile for TIFF files can now
|
|
be specified through a keyword argument::
|
|
|
|
im.save("out.tif", icc_profile=...)
|
|
|
|
|
|
ImageOps.autocontrast: preserve_tone
|
|
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
|
|
|
|
The default behaviour of :py:meth:`~PIL.ImageOps.autocontrast` is to normalize
|
|
separate histograms for each color channel, changing the tone of the image. The new
|
|
``preserve_tone`` argument keeps the tone unchanged by using one luminance histogram
|
|
for all channels.
|
|
|
|
Security
|
|
========
|
|
|
|
TODO
|
|
|
|
Other Changes
|
|
=============
|
|
|
|
GIF writer uses LZW encoding
|
|
^^^^^^^^^^^^^^^^^^^^^^^^^^^^
|
|
|
|
GIF files are now written using LZW encoding, which will generate smaller files,
|
|
typically about 70% of the size generated by the older encoder.
|
|
|
|
The pixel data is encoded using the format specified in the [Compuserve GIF
|
|
standard](https://www.w3.org/Graphics/GIF/spec-gif89a.txt). The older encoder
|
|
used a variant of run-length encoding that was compatible but less efficient.
|
|
|
|
Libraqm and FriBiDi linking
|
|
^^^^^^^^^^^^^^^^^^^^^^^^^^^
|
|
|
|
The way the libraqm dependency for complex text scripts is linked has been changed:
|
|
|
|
Source builds will now link against the system version of libraqm at build time
|
|
rather than at runtime by default.
|
|
|
|
Binary wheels now include a statically linked modified version of libraqm that
|
|
links against FriBiDi at runtime instead. This change is intended to address
|
|
issues with the previous implementation on some platforms. These are created
|
|
by building Pillow with the new build flags ``--vendor-raqm --vendor-fribidi``.
|
|
|
|
Windows users will now need to install ``fribidi.dll`` (or ``fribidi-0.dll``) only,
|
|
``libraqm.dll`` is no longer used.
|
|
|
|
See :doc:`installation documentation<../installation>` for more information.
|
|
|
|
PyQt6
|
|
^^^^^
|
|
|
|
Support has been added for PyQt6. If it is installed, it will be used instead of
|
|
PySide6, PyQt5 or PySide2.
|