@@ -5,24 +5,37 @@ API Changes
55===========
66
77Raise an error when performing a negative crop
8- ----------------------------------------------
8+ ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
99
1010Performing a negative crop on an image previously just returned a `(0, 0) ` image. Now
1111it will raise a `ValueError `, to help reduce confusion if a user has unintentionally
1212provided the wrong arguments.
1313
1414Added specific error if path coordinate type is incorrect
15- ---------------------------------------------------------
15+ ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
1616
1717Rather than returning a `SystemError `, passing the incorrect types of coordinates into
1818a path will now raise a more specific `ValueError `, with the message "incorrect
1919coordinate type".
2020
21+ Deprecations
22+ ^^^^^^^^^^^^
23+
24+ ImageShow.Viewer.show_file file argument
25+ ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
26+
27+ The ``file `` argument in :py:meth: `~PIL.ImageShow.Viewer.show_file() ` has been
28+ deprecated, replaced by ``path ``.
29+
30+ In effect, ``viewer.show_file("test.jpg") `` will continue to work unchanged.
31+ ``viewer.show_file(file="test.jpg") `` will raise a deprecation warning, and suggest
32+ ``viewer.show_file(path="test.jpg") `` instead.
33+
2134API Additions
2235=============
2336
2437Added get_photoshop_blocks() to parse Photoshop TIFF tag
25- --------------------------------------------------------
38+ ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
2639
2740:py:meth: `~PIL.TiffImagePlugin.TiffImageFile.get_photoshop_blocks ` has been added, to
2841allow users to determine what Photoshop "Image Resource Blocks" are contained within an
@@ -36,7 +49,7 @@ Other Changes
3649=============
3750
3851Image._repr_pretty_
39- -------------------
52+ ^^^^^^^^^^^^^^^^^^^
4053
4154:py:meth: `~PIL.Image.Image._repr_pretty_ ` has been added to provide a representation of
4255an image without the identity of the object. This allows Jupyter to describe an image
0 commit comments