python-pillow/Pillow
1
1
Fork 0
mirror of https://github.com/python-pillow/Pillow.git synced 2024-12-27 02:16:19 +03:00
Code Issues Packages Projects Releases Wiki Activity

Move "Image size" under "API Changes"

Browse Source 
To try to keep the headings consistent with before:

https://pillow.readthedocs.io/en/5.2.x/releasenotes/index.html

[CI skip]
This commit is contained in:
Hugo 2018-09-30 17:12:20 +03:00 committed by GitHub
parent 39e95a6a43
commit bb795fc2d1
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
1 changed files with 19 additions and 14 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

33
docs/releasenotes/5.3.0.rst
View File

@ -1,6 +1,24 @@
5.3.0 5.3.0
----- -----
API Changes
===========
Image size
^^^^^^^^^^
If you attempt to set the size of an image directly, e.g.
``im.size = (100, 100)``, you will now receive an ``AttributeError``. This is
not about removing existing functionality, but instead about raising an
explicit error to prevent later consequences. The ``resize`` method is the
correct way to change an image's size.
The exceptions to this are:
* The ICO and ICNS image formats, which use ``im.size = (100, 100)`` to select a subimage.
* The TIFF image format, which now has a ``DeprecationWarning`` for this action, as direct image size setting was previously necessary to work around an issue with tile extents.
API Additions API Additions
============= =============
@ -28,6 +46,7 @@ Now it supports three-color mapping with the optional ``mid`` parameter, and
the positions for all three color arguments can each be optionally specified the positions for all three color arguments can each be optionally specified
(``blackpoint``, ``whitepoint`` and ``midpoint``). (``blackpoint``, ``whitepoint`` and ``midpoint``).
For example, with all optional arguments:: For example, with all optional arguments::
ImageOps.colorize(im, black=(32, 37, 79), white='white', mid=(59, 101, 175), ImageOps.colorize(im, black=(32, 37, 79), white='white', mid=(59, 101, 175),
blackpoint=15, whitepoint=240, midpoint=100) blackpoint=15, whitepoint=240, midpoint=100)
@ -39,20 +58,6 @@ and size, new method ``ImageOps.pad`` pads images to fill a requested aspect
ratio and size, filling new space with a provided ``color`` and positioning the ratio and size, filling new space with a provided ``color`` and positioning the
image within the new area through a ``centering`` argument. image within the new area through a ``centering`` argument.
Image Size
==========
If you attempt to set the size of an image directly, e.g.
``im.size = (100, 100)``, you will now receive an ``AttributeError``. This is
not about removing existing functionality, but instead about raising an
explicit error to prevent later consequences. The ``resize`` method is the
correct way to change an image's size.
The exceptions to this are:
* The ICO and ICNS image formats, which use ``im.size = (100, 100)`` to select a subimage.
* The TIFF image format, which now has a ``DeprecationWarning`` for this action, as direct image size setting was previously necessary to work around an issue with tile extents.
Other Changes Other Changes
============= =============