10.1.0 ------ Backwards Incompatible Changes ============================== Setting image mode ^^^^^^^^^^^^^^^^^^ If you attempt to set the mode of an image directly, e.g. ``im.mode = "RGBA"``, 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 ``convert`` method is the correct way to change an image's mode. Deprecations ============ TODO ^^^^ TODO API Changes =========== Accept a list in getpixel() ^^^^^^^^^^^^^^^^^^^^^^^^^^^ py:meth:`~PIL.Image.Image.getpixel` now accepts a list of coordinates, as well as a tuple. :: from PIL import Image im = Image.new("RGB", (1, 1)) im.getpixel((0, 0)) im.getpixel([0, 0]) BoxBlur and GaussianBlur allow for different x and y radii ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ py:meth:`~PIL.ImageFilter.BoxBlur` and py:meth:`~PIL.ImageFilter.GaussianBlur` now allow a sequence of x and y radii to be specified, rather than a single number for both dimensions. :: from PIL import ImageFilter ImageFilter.BoxBlur((2, 5)) ImageFilter.GaussianBlur((2, 5)) API Additions ============= has_transparency_data ^^^^^^^^^^^^^^^^^^^^^ Images now have :py:attr:`~PIL.Image.Image.has_transparency_data` to indicate whether the image has transparency data, whether in the form of an alpha channel, a palette with an alpha channel, or a "transparency" key in the :py:attr:`~PIL.Image.Image.info` dictionary. Even if this attribute is true, the image might still appear solid, if all of the values shown within are opaque. Security ======== TODO ^^^^ TODO Other Changes ============= Added support for DDS BC5U and 8-bit color indexed images ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ Support has been added to read BC5U DDS files as RGB images, and PALETTEINDEXED8 DDS files as P mode images. Support reading signed 8-bit YCbCr TIFF images ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ TIFF images with unsigned integer data, 8 bits per sample and a photometric interpretation of YCbCr can now be read.