7.0.0¶
Backwards Incompatible Changes¶
Python 2.7¶
Pillow has dropped support for Python 2.7, which reached end-of-life on 2020-01-01.
PILLOW_VERSION constant¶
PILLOW_VERSION has been removed. Use __version__ instead.
PIL.*ImagePlugin.__version__ attributes¶
The version constants of individual plugins have been removed. Use PIL.__version__
instead.
Removed |
Removed |
Removed |
|---|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
PyQt4 and PySide¶
Qt 4 reached end-of-life on 2015-12-19. Its Python bindings are also EOL: PyQt4 since 2018-08-31 and PySide since 2015-10-14.
Support for PyQt4 and PySide has been removed from ImageQt. Please upgrade to PyQt5
or PySide2.
Setting the size of TIFF images¶
Setting the size of a TIFF image directly (eg. im.size = (256, 256)) throws
an error. Use Image.resize instead.
Default resampling filter¶
The default resampling filter has been changed to the high-quality convolution
Image.BICUBIC instead of Image.NEAREST, for the resize()
method and the pad(), scale()
and fit() functions.
Image.NEAREST is still always used for images in “P” and “1” modes.
See Filters to learn the difference. In short,
Image.NEAREST is a very fast filter, but simple and low-quality.
Image.draft() return value¶
If the draft() method has no effect, it returns None.
If it does have an effect, then it previously returned the image itself.
However, unlike other chain methods, draft() does not
return a modified version of the image, but modifies it in-place. So instead, if
draft() has an effect, Pillow will now return a tuple
of the image mode and a co-ordinate box. The box is the original coordinates in the
bounds of resulting image. This may be useful in a subsequent
resize() call.
API Additions¶
Custom unidentified image error¶
Pillow will now throw a custom UnidentifiedImageError when an image cannot be
identified. For backwards compatibility, this will inherit from OSError.
New argument reducing_gap for Image.resize() and Image.thumbnail() methods¶
Speeds up resizing by resizing the image in two steps. The bigger reducing_gap,
the closer the result to the fair resampling. The smaller reducing_gap,
the faster resizing. With reducing_gap greater or equal to 3.0,
the result is indistinguishable from fair resampling.
The default value for resize() is None,
which means that the optimization is turned off by default.
The default value for thumbnail() is 2.0,
which is very close to fair resampling while still being faster in many cases.
In addition, the same gap is applied when thumbnail()
calls draft(), which may greatly improve the quality
of JPEG thumbnails. As a result, thumbnail()
in the new version provides equally high speed and high quality from any
source (JPEG or arbitrary images).
New Image.reduce() method¶
reduce() is a highly efficient operation
to reduce an image by integer times. Normally, it shouldn’t be used directly.
Used internally by resize() and thumbnail()
methods to speed up resize when a new argument reducing_gap is set.
Loading WMF images at a given DPI¶
On Windows, Pillow can read WMF files, with a default DPI of 72. An image can now also be loaded at another resolution:
from PIL import Image
with Image.open("drawing.wmf") as im:
im.load(dpi=144)
Other Changes¶
Image.__del__¶
Implicitly closing the image’s underlying file in Image.__del__ has been removed.
Use a context manager or call close() instead to close
the file in a deterministic way.
Previous method:
im = Image.open("hopper.png")
im.save("out.jpg")
Use instead:
with Image.open("hopper.png") as im:
im.save("out.jpg")
Better thumbnail geometry¶
When calculating the new dimensions in thumbnail(),
round to the nearest integer, instead of always rounding down.
This better preserves the original aspect ratio.
When the image width or height is not divisible by 8 the last row and column in the image get the correct weight after JPEG DCT scaling.