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

wording

Browse Source
This commit is contained in:
Alexander 2019-12-27 15:35:17 +03:00
parent 222c2f6978
commit 1bd9b16e97
2 changed files with 13 additions and 13 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

8
docs/releasenotes/7.0.0.rst
View File

@ -99,16 +99,16 @@ 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``, 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 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 faster resizing. With ``reducing_gap`` greater or equal to 3.0,
indistinguishable from fair resampling. the result is indistinguishable from fair resampling.
The default value for :py:meth:`~PIL.Image.Image.resize` is ``None``, The default value for :py:meth:`~PIL.Image.Image.resize` is ``None``,
which means that the optimization is turned off by default. which means that the optimization is turned off by default.
The default value for :py:meth:`~PIL.Image.Image.thumbnail` is 2.0, 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. which is very close to fair resampling while still being faster in many cases.
In addition, the same gap is applied when :py:meth:`~PIL.Image.Image.thumbnail` 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 calls :py:meth:`~PIL.Image.Image.draft`, which may greatly improve the quality
of JPEG thumbnails. As a result, :py:meth:`~PIL.Image.Image.thumbnail` 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 in the new version provides equally high speed and high quality from any
sources (JPEG or arbitrary images). sources (JPEG or arbitrary images).

18
src/PIL/Image.py
View File

@ -1767,8 +1767,8 @@ class Image:
return m_im return m_im
def _get_safe_box(self, size, resample, box): def _get_safe_box(self, size, resample, box):
"""Expands the box so it includes neighboring pixels """Expands the box so it includes adjacent pixels
that could be used by resampling with the given resampling filter. that may be used by resampling with the given resampling filter.
""" """
filter_support = _filters_support[resample] - 0.5 filter_support = _filters_support[resample] - 0.5
scale_x = (box[2] - box[0]) / size[0] scale_x = (box[2] - box[0]) / size[0]
@ -1802,11 +1802,11 @@ class Image:
The values must be within (0, 0, width, height) rectangle. The values must be within (0, 0, width, height) rectangle.
If omitted or None, the entire source is used. If omitted or None, the entire source is used.
:param reducing_gap: Apply optimization by resizing the image :param reducing_gap: Apply optimization by resizing the image
in two steps. First, reducing the image in integer times in two steps. First, reducing the image by integer times
using :py:meth:`~PIL.Image.Image.reduce`. using :py:meth:`~PIL.Image.Image.reduce`.
Second, resizing using regular resampling. The last step Second, resizing using regular resampling. The last step
changes size not less than in ``reducing_gap`` times. changes size no less than by ``reducing_gap`` times.
``reducing_gap`` could be None (no first step is performed) ``reducing_gap`` may 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 closer the result to the fair resampling.
The smaller ``reducing_gap``, the faster resizing. The smaller ``reducing_gap``, the faster resizing.
@ -2216,19 +2216,19 @@ class Image:
If omitted, it defaults to :py:attr:`PIL.Image.BICUBIC`. If omitted, it defaults to :py:attr:`PIL.Image.BICUBIC`.
(was :py:attr:`PIL.Image.NEAREST` prior to version 2.5.0). (was :py:attr:`PIL.Image.NEAREST` prior to version 2.5.0).
:param reducing_gap: Apply optimization by resizing the image :param reducing_gap: Apply optimization by resizing the image
in two steps. First, reducing the image in integer times in two steps. First, reducing the image by integer times
using :py:meth:`~PIL.Image.Image.reduce` or using :py:meth:`~PIL.Image.Image.reduce` or
:py:meth:`~PIL.Image.Image.draft` for JPEG images. :py:meth:`~PIL.Image.Image.draft` for JPEG images.
Second, resizing using regular resampling. The last step Second, resizing using regular resampling. The last step
changes size not less than in ``reducing_gap`` times. changes size no less than by ``reducing_gap`` times.
``reducing_gap`` could be None (no first step is performed) ``reducing_gap`` may 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 closer the result to the fair resampling.
The smaller ``reducing_gap``, the faster resizing. The smaller ``reducing_gap``, the faster resizing.
With ``reducing_gap`` greater or equal to 3.0 result is With ``reducing_gap`` greater or equal to 3.0 result is
indistinguishable from fair resampling in most cases. indistinguishable from fair resampling in most cases.
The default value is 2.0 (very close to fair resampling The default value is 2.0 (very close to fair resampling
while still faster in many cases). while still being faster in many cases).
:returns: None :returns: None
""" """