python-pillow/Pillow
1
1
Fork 0
mirror of https://github.com/python-pillow/Pillow.git synced 2025-01-26 17:24:31 +03:00
Code Issues Packages Projects Releases Wiki Activity

add release notes

Browse Source
This commit is contained in:
Alexander 2019-12-21 01:17:08 +03:00
parent fc28182040
commit 59f8eeb290
2 changed files with 33 additions and 6 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

27
docs/releasenotes/7.0.0.rst
View File

@ -94,6 +94,33 @@ Custom unidentified image error
Pillow will now throw a custom ``UnidentifiedImageError`` when an image cannot be
identified. For backwards compatibility, this will inherit from ``IOError``.
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 result is
indistinguishable from fair resampling.
The default value for :py:meth:`~PIL.Image.Image.resize` is ``None``,
which means that the optimization is turned off by default.
The default value for :py:meth:`~PIL.Image.Image.thumbnail` is 2.0,
which is very close to fair resampling while still faster in many cases.
In addition, the same gap is applied when :py:meth:`~PIL.Image.Image.thumbnail`
calls :py:meth:`~PIL.Image.Image.draft`, which could greatly improve the quality
of JPEG thumbnails. As a result, :py:meth:`~PIL.Image.Image.thumbnail`
in the new version provides equally high speed and high quality from any
sources (JPEG or arbitrary images).
New Image.reduce() method
^^^^^^^^^^^^^^^^^^^^^^^^^
:py:meth:`~PIL.Image.Image.reduce` is a highly efficient operation
to reduce an image by integer times. Normally, shouldn't be used directly.
Used internally by :py:meth:`~PIL.Image.Image.resize` and :py:meth:`~PIL.Image.Image.thumbnail`
methods to speed up resize when a new argument ``reducing_gap`` is set.
Other Changes
=============

12
src/PIL/Image.py
View File

@ -1808,10 +1808,10 @@ class Image:
Second, resizing using regular resampling. The last step
changes size not less than in ``reducing_gap`` times.
``reducing_gap`` could be None (no first step is performed)
or should be greater than 1.0. The bigger `reducing_gap`,
or should be greater than 1.0. 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 result is
The smaller ``reducing_gap``, the faster resizing.
With ``reducing_gap`` greater or equal to 3.0 result is
indistinguishable from fair resampling in most cases.
The default value is None (no optimization).
:returns: An :py:class:`~PIL.Image.Image` object.
@ -2223,10 +2223,10 @@ class Image:
Second, resizing using regular resampling. The last step
changes size not less than in ``reducing_gap`` times.
``reducing_gap`` could be None (no first step is performed)
or should be greater than 1.0. The bigger `reducing_gap`,
or should be greater than 1.0. 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 result is
The smaller ``reducing_gap``, the faster resizing.
With ``reducing_gap`` greater or equal to 3.0 result is
indistinguishable from fair resampling in most cases.
The default value is 2.0 (very close to fair resampling
while still faster in many cases).