NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
PyPI, #43 most downloaded on PyPI
Python Imaging Library (fork)
Latest stable
13.0.0
Last release 1 months ago
16 Oct 2026
Ships on a steady schedule
a new release about every 3 months
Nearly every release is documented
notes for 60 of the last 60 stable releases
Nothing withdrawn
no release was ever pulled
16 years old
108 releases · first in 2010
Drag across the ruler to compare, or tap a release to open it.
CVE-2007-4559 patch when building on Windows #6704 [@nulano]
https://pillow.readthedocs.io/en/stable/releasenotes/9.4.0.html
Your coding agent can read these notes before it upgrades. Set up the MCP server →
Fixed null pointer dereference crash with malformed font #6846 [wiredfool, radarhere]
Return from ImagingFill early if image has a zero dimension #6842 [radarhere]
Reversed deprecations for Image constants, except for duplicate Resampling attributes #6830 [radarhere]
Improve exception traceback readability #6836 [hugovk, radarhere]
Do not attempt to read IFD1 if absent #6840 [radarhere]
Fixed writing int as ASCII tag #6800 [radarhere]
If available, use wl-paste or xclip for grabclipboard() on Linux #6783 [radarhere]
Added signed option when saving JPEG2000 images #6709 [radarhere]
Patch OpenJPEG to include ARM64 fix #6718 [radarhere]
Added support for I;16 modes in putdata() #6825 [radarhere]
Added conversion from RGBa to RGB #6708 [radarhere]
Added DDS support for uncompressed L and LA images #6820 [radarhere, REDxEYE]
Added LightSource tag values to ExifTags #6749 [radarhere]
Fixed PyAccess after changing ICO size #6821 [radarhere]
Do not use EXIF from info when saving PNG images #6819 [radarhere]
Fixed saving EXIF data to MPO #6817 [radarhere]
Added Exif hide_offsets() #6762 [radarhere]
Only compare to previous frame when checking for duplicate GIF frames while saving #6787 [radarhere]
Always initialize all plugins in registered_extensions() #6811 [radarhere]
Ignore non-opaque WebP background when saving as GIF #6792 [radarhere]
Only set tile in ImageFile __setstate__ #6793 [radarhere]
When reading BLP, do not trust JPEG decoder to determine image is CMYK #6767 [radarhere]
Added IFD enum to ExifTags #6748 [radarhere]
Fixed bug combining GIF frame durations #6779 [radarhere]
Support saving JPEG comments #6774 [smason, radarhere]
Added getxmp() to WebPImagePlugin #6758 [radarhere]
Added "exact" option when saving WebP #6747 [ashafaei, radarhere]
Use fractional coordinates when drawing text #6722 [radarhere]
Fixed writing int as BYTE tag #6740 [radarhere]
Added MP Format Version when saving MPO #6735 [radarhere]
Added Interop to ExifTags #6724 [radarhere]
CVE-2007-4559 patch when building on Windows #6704 [TrellixVulnTeam, nulano, radarhere]
Fix compiler warning: accessing 64 bytes in a region of size 48 #6714 [wiredfool]
Use verbose flag for pip install #6713 [wiredfool, radarhere]
A corrupt or specially crafted TTF font could have font metrics that lead to unreasonably large sizes when rendering text in font. ImageFont.py did not check the image size before allocating memory for it. This dates to the PIL fork. Pillow 8.2.0 added a check for large sizes, but did not consider the case where one dimension is zero.
Pillow attempted to dereference a null pointer in ImageFont, leading to a crash. An error is now raised instead. This has been present since Pillow 8.0.0.
Text may render differently when starting at fractional coordinates, so .FreeTypeFont.getmask and .FreeTypeFont.getmask2 now support a start argument. This tuple of horizontal and vertical offset will be used internally by .ImageDraw.text to more accurately place text at the xy coordinates.
The exact encoding option for WebP is now supported. The WebP encoder removes the hidden RGB values for better compression by default in libwebp 0.5 or later. By setting this option to True, the encoder will keep the hidden RGB values.
If the signed keyword argument is present and true when saving JPEG2000 images, then tell the encoder to save the image as signed.
~PIL.ExifTags.IFD has been added, allowing enums to be used with ~PIL.Image.Exif.get_ifd:
from PIL import Image, ExifTags
im = Image.open("Tests/images/flower.jpg")
print(im.getexif().get_ifd(ExifTags.IFD.Exif))
IFD1 can also be used with ~PIL.Image.Exif.get_ifd, but it should not be used in other contexts, as the enum value is only internally meaningful.
~PIL.ExifTags.Interop has been added for tags within the Interop IFD:
from PIL import Image, ExifTags
im = Image.open("Tests/images/flower.jpg")
interop_ifd = im.getexif().get_ifd(ExifTags.IFD.Interop)
print(interop_ifd.get(ExifTags.Interop.InteropIndex)) # R98
~PIL.ExifTags.LightSource has been added for values within the LightSource tag:
from PIL import Image, ExifTags
im = Image.open("Tests/images/iptc.jpg")
exif_ifd = im.getexif().get_ifd(ExifTags.IFD.Exif)
print(ExifTags.LightSource(exif_ifd[0x9208])) # LightSource.Unknown
XMP data can now be decoded for WEBP images through getxmp().
When saving a JPEG image, a comment can now be written from ~PIL.Image.Image.info, or by using an argument when saving:
im.save(out, comment="Test comment")
Support has been added to read and write L and LA DDS images in the uncompressed format, known as "luminance" textures.
In Pillow 9.1.0, the following constants were deprecated. That has been reversed and these constants will now remain available.
Image.NONE
Image.NEAREST
Image.ORDERED
Image.RASTERIZE
Image.FLOYDSTEINBERG
Image.WEB
Image.ADAPTIVE
Image.AFFINE
Image.EXTENT
Image.PERSPECTIVE
Image.QUAD
Image.MESH
Image.FLIP_LEFT_RIGHT
Image.FLIP_TOP_BOTTOM
Image.ROTATE_90
Image.ROTATE_180
Image.ROTATE_270
Image.TRANSPOSE
Image.TRANSVERSE
Image.BOX
Image.BILINEAR
Image.HAMMING
Image.BICUBIC
Image.LANCZOS
Image.MEDIANCUT
Image.MAXCOVERAGE
Image.FASTOCTREE
Image.LIBIMAGEQUANT
GHA: replace deprecated set-output command with GITHUB_OUTPUT file #6697 [@nulano]
https://pillow.readthedocs.io/en/stable/releasenotes/9.3.0.html
Limit SAMPLESPERPIXEL to avoid runtime DOS #6700 [wiredfool]
Initialize libtiff buffer when saving #6699 [radarhere]
Inline fname2char to fix memory leak #6329 [nulano]
Fix memory leaks related to text features #6330 [nulano]
Use double quotes for version check on old CPython on Windows #6695 [hugovk]
Remove backup implementation of Round for Windows platforms #6693 [cgohlke]
Fixed set_variation_by_name offset #6445 [radarhere]
Fix malloc in _imagingft.c:font_setvaraxes #6690 [cgohlke]
Release Python GIL when converting images using matrix operations #6418 [hmaarrfk]
Added ExifTags enums #6630 [radarhere]
Do not modify previous frame when calculating delta in PNG #6683 [radarhere]
Added support for reading BMP images with RLE4 compression #6674 [npjg, radarhere]
Decode JPEG compressed BLP1 data in original mode #6678 [radarhere]
Added GPS TIFF tag info #6661 [radarhere]
Added conversion between RGB/RGBA/RGBX and LAB #6647 [radarhere]
Do not attempt normalization if mode is already normal #6644 [radarhere]
Fixed seeking to an L frame in a GIF #6576 [radarhere]
Consider all frames when selecting mode for PNG save_all #6610 [radarhere]
Don't reassign crc on ChunkStream close #6627 [wiredfool, radarhere]
Raise a warning if NumPy failed to raise an error during conversion #6594 [radarhere]
Show all frames in ImageShow #6611 [radarhere]
Allow FLI palette chunk to not be first #6626 [radarhere]
If first GIF frame has transparency for RGB_ALWAYS loading strategy, use RGBA mode #6592 [radarhere]
Round box position to integer when pasting embedded color #6517 [radarhere, nulano]
Removed EXIF prefix when saving WebP #6582 [radarhere]
Pad IM palette to 768 bytes when saving #6579 [radarhere]
Added DDS BC6H reading #6449 [ShadelessFox, REDxEYE, radarhere]
Added support for opening WhiteIsZero 16-bit integer TIFF images #6642 [JayWiz, radarhere]
Raise an error when allocating translucent color to RGB palette #6654 [jsbueno, radarhere]
Added reading of TIFF child images #6569 [radarhere]
Improved ImageOps palette handling #6596 [PososikTeam, radarhere]
Defer parsing of palette into colors #6567 [radarhere]
Apply transparency to P images in ImageTk.PhotoImage #6559 [radarhere]
Use rounding in ImageOps contain() and pad() #6522 [bibinhashley, radarhere]
Fixed GIF remapping to palette with duplicate entries #6548 [radarhere]
Allow remap_palette() to return an image with less than 256 palette entries #6543 [radarhere]
Corrected BMP and TGA palette size when saving #6500 [radarhere]
Do not call load() before draft() in Image.thumbnail #6539 [radarhere]
Copy palette when converting from P to PA #6497 [radarhere]
Allow RGB and RGBA values for PA image putpixel #6504 [radarhere]
Removed support for tkinter in PyPy before Python 3.6 #6551 [nulano]
Do not use CCITTFaxDecode filter if libtiff is not available #6518 [radarhere]
Fallback to not using mmap if buffer is not large enough #6510 [radarhere]
Fixed writing bytes as ASCII tag #6493 [radarhere]
Open 1 bit EPS in mode 1 #6499 [radarhere]
Removed support for tkinter before Python 1.5.2 #6549 [radarhere]
Allow default ImageDraw font to be set #6484 [radarhere, hugovk]
Save 1 mode PDF using CCITTFaxDecode filter #6470 [radarhere]
Added support for RGBA PSD images #6481 [radarhere]
Parse orientation from XMP tag contents #6463 [bigcat88, radarhere]
Added support for reading ATI1/ATI2 (BC4/BC5) DDS images #6457 [REDxEYE, radarhere]
Do not clear GIF tile when checking number of frames #6455 [radarhere]
Support saving multiple MPO frames #6444 [radarhere]
Do not double quote Pillow version for setuptools >= 60 #6450 [radarhere]
Added ABGR BMP mask mode #6436 [radarhere]
Fixed PSDraw rectangle #6429 [radarhere]
Raise ValueError if PNG sRGB chunk is truncated #6431 [radarhere]
Handle missing Python executable in ImageShow on macOS #6416 [bryant1410, radarhere]
When saving a TIFF image to a file object using libtiff, the buffer was not initialized. This behaviour introduced in Pillow 2.0.0, and has now been fixed.
Within the BLP image format, BLP1 data may use JPEG compression. Instead of telling the JPEG library that this data is in BGRX mode, Pillow will now decode the data in its natural CMYK mode, then convert it to RGB and rearrange the channels afterwards. Trying to load the data in an incorrect mode could result in a segmentation fault. This issue was introduced in Pillow 9.1.0.
A large value in the SAMPLESPERPIXEL tag could lead to a memory and runtime DOS in TiffImagePlugin.py when setting up the context for image decoding. This was introduced in Pillow 9.2.0, found with OSS-Fuzz and fixed by limiting SAMPLESPERPIXEL to the number of planes that we can decode.
Rather than specifying a font when calling text-related ImageDraw methods, or setting a font on each ImageDraw instance, the default font can now be set for all future ImageDraw operations:
from PIL import ImageDraw, ImageFont
ImageDraw.ImageDraw.font = ImageFont.truetype("Tests/fonts/FreeMono.ttf")
Multiple MPO frames can now be saved. Using the save_all argument, all of an image's frames will be saved to file:
from PIL import Image
im = Image.open("frozenpond.mpo")
im.save(out, save_all=True)
Additional images can also be appended when saving, by combining the save_all argument with the append_images argument:
im.save(out, save_all=True, append_images=[im1, im2, ...])
The data from ~PIL.ExifTags.TAGS and ~PIL.ExifTags.GPSTAGS is now also exposed as enum.IntEnum classes: ~PIL.ExifTags.Base and ~PIL.ExifTags.GPS.
Pillow 9.2.0 had wheels built against Python 3.11 beta, available as a preview to help others prepare for 3.11, and ensure Pillow can be used immediately on release day of 3.11.0 final (2022-10-24, 664).
Pillow 9.3.0 now officially includes binary wheels for Python 3.11 final.
This release contains wheels for Windows built using GitHub Actions.
Previously they were built by Christoph Gohlke.
A huge thanks to Christoph for building Windows binaries for us for around a decade, plus testing, and fixing over a hundred bug fixes along the way, in addition to building and hosting unofficial Windows binaries for hundreds of Python projects!
Support has been added to read the ATI1, ATI2 and BC6H formats of DDS images.
Python's Global Interpreter Lock is now released when converting images using matrix operations.
When calling ~PIL.Image.Image.show or using ~PIL.ImageShow, all frames will now be shown.
Deprecate ImageFont.getsize and related functions #6381 [@nulano]
https://pillow.readthedocs.io/en/stable/releasenotes/9.2.0.html
Deprecate ImageFont.getsize and related functions #6381 [nulano, radarhere]
Fixed null check for fribidi_version_info in FriBiDi shim #6376 [nulano]
Added GIF decompression bomb check #6402 [radarhere]
Handle PCF fonts files with less than 256 characters #6386 [dawidcrivelli, radarhere]
Improved GIF optimize condition #6378 [raygard, radarhere]
Reverted to __array_interface__ with the release of NumPy 1.23 #6394 [radarhere]
Pad PCX palette to 768 bytes when saving #6391 [radarhere]
Fixed bug with rounding pixels to palette colors #6377 [btrekkie, radarhere]
Use gnome-screenshot on Linux if available #6361 [radarhere, nulano]
Fixed loading L mode BMP RLE8 images #6384 [radarhere]
Fixed incorrect operator in ImageCms error #6370 [LostBenjamin, hugovk, radarhere]
Limit FPX tile size to avoid extending outside image #6368 [radarhere]
Added support for decoding plain PPM formats #5242 [Piolie, radarhere]
Added apply_transparency() #6352 [radarhere]
Fixed behaviour change from endian fix #6197 [radarhere]
Allow remapping P images with RGBA palettes #6350 [radarhere]
Fixed drawing translucent 1px high polygons #6278 [radarhere]
Pad COLORMAP to 768 items when saving TIFF #6232 [radarhere]
Fix P -> PA conversion #6337 [RedShy, radarhere]
Once exif data is parsed, do not reload unless it changes #6335 [radarhere]
Only try to connect discontiguous corners at the end of edges #6303 [radarhere]
Improve transparency handling when saving GIF images #6176 [radarhere]
Do not update GIF frame position until local image is found #6219 [radarhere]
Netscape GIF extension belongs after the global color table #6211 [radarhere]
Only write GIF comments at the beginning of the file #6300 [raygard, radarhere]
Separate multiple GIF comment blocks with newlines #6294 [raygard, radarhere]
Always use GIF89a for comments #6292 [raygard, radarhere]
Ignore compression value from BMP info dictionary when saving as TIFF #6231 [radarhere]
If font is file-like object, do not re-read from object to get variant #6234 [radarhere]
Raise ValueError when trying to access internal fp after close #6213 [radarhere]
Support more affine expression forms in im.point() #6254 [benrg, radarhere]
Populate Python palette in fromarray() #6283 [radarhere]
Raise ValueError if PNG chunks are truncated #6253 [radarhere]
Use durations from each frame by default when saving GIFs #6265 [radarhere]
Adjust BITSPERSAMPLE to match SAMPLESPERPIXEL when opening TIFFs #6270 [radarhere]
Search pkgconf system libs/cflags #6138 [jameshilliard, radarhere]
Raise ValueError for invalid PPM maxval #6242 [radarhere]
Corrected screencapture argument in ImageGrab.grab() #6244 [axt-one]
Deprecate support for Qt 5 (PyQt5 and PySide2) #6237 [hugovk, radarhere]
Increase wait time of temporary file deletion on Windows #6224 [AlexTedeschi]
Deprecate FreeTypeFont.getmask2 fill parameter #6220 [nulano, radarhere, hugovk]
Round lut values where necessary #6188 [radarhere]
Load before getting size in resize() #6190 [radarhere]
Load image before performing size calculations in thumbnail() #6186 [radarhere]
Deprecated PhotoImage.paste() box parameter #6178 [radarhere]
An additional decompression bomb check has been added for the GIF format.
Qt 5 reached end-of-life on 2020-12-08 for open-source users (and will reach EOL on 2023-12-08 for commercial licence holders).
Support for PyQt5 and PySide2 has been deprecated from ImageQt and will be removed in Pillow 10 (2023-07-01). Upgrade to PyQt6 or PySide6 instead.
The undocumented fill parameter of .FreeTypeFont.getmask2 has been deprecated and will be removed in Pillow 10 (2023-07-01).
The box parameter is unused. It will be removed in Pillow 10.0.0 (2023-07-01).
This undocumented method has been deprecated and will be removed in Pillow 10 (2023-07-01).
Several functions for computing the size and offset of rendered text have been deprecated and will be removed in Pillow 10 (2023-07-01):
Deprecated |
Use instead |
|---|---|
FreeTypeFont.getsize() and FreeTypeFont.getoffset() |
.FreeTypeFont.getbbox and .FreeTypeFont.getlength |
FreeTypeFont.getsize_multiline() |
.ImageDraw.multiline_textbbox |
ImageFont.getsize() |
.ImageFont.getbbox and .ImageFont.getlength |
TransposedFont.getsize() |
.TransposedFont.getbbox and .TransposedFont.getlength |
ImageDraw.textsize() and ImageDraw.multiline_textsize() |
.ImageDraw.textbbox, .ImageDraw.textlength and .ImageDraw.multiline_textbbox |
ImageDraw2.Draw.textsize() |
.ImageDraw2.Draw.textbbox and .ImageDraw2.Draw.textlength |
Previous code:
from PIL import Image, ImageDraw, ImageFont
font = ImageFont.truetype("Tests/fonts/FreeMono.ttf")
width, height = font.getsize("Hello world")
left, top = font.getoffset("Hello world")
im = Image.new("RGB", (100, 100))
draw = ImageDraw.Draw(im)
width, height = draw.textsize("Hello world", font)
width, height = font.getsize_multiline("Hello\nworld")
width, height = draw.multiline_textsize("Hello\nworld", font)
Use instead:
from PIL import Image, ImageDraw, ImageFont
font = ImageFont.truetype("Tests/fonts/FreeMono.ttf")
left, top, right, bottom = font.getbbox("Hello world")
width, height = right - left, bottom - top
im = Image.new("RGB", (100, 100))
draw = ImageDraw.Draw(im)
width = draw.textlength("Hello world", font)
left, top, right, bottom = draw.multiline_textbbox((0, 0), "Hello\nworld", font)
width, height = right - left, bottom - top
Previously, the size methods returned a height that included the vertical offset of the text, while the new bbox methods distinguish this as a top offset.
If you are using these methods for aligning text, consider using text-anchors instead which avoid issues that can occur with non-English text or unusual fonts. For example, instead of the following code:
from PIL import Image, ImageDraw, ImageFont
font = ImageFont.truetype("Tests/fonts/FreeMono.ttf")
im = Image.new("RGB", (100, 100))
draw = ImageDraw.Draw(im)
width, height = draw.textsize("Hello world", font)
x, y = (100 - width) / 2, (100 - height) / 2
draw.text((x, y), "Hello world", font=font)
Use instead:
from PIL import Image, ImageDraw, ImageFont
font = ImageFont.truetype("Tests/fonts/FreeMono.ttf")
im = Image.new("RGB", (100, 100))
draw = ImageDraw.Draw(im)
draw.text((100 / 2, 100 / 2), "Hello world", font=font, anchor="mm")
Added ~PIL.Image.Image.apply_transparency, a method to take a P mode image with "transparency" in im.info, and apply the transparency to the palette instead. The image's palette mode will become "RGBA", and "transparency" will be removed from im.info.
In ~PIL.ImageGrab.grab on Linux, if xdisplay is None then gnome-screenshot will be used to capture the display if it is installed. To capture the default X11 display instead, pass xdisplay="".
CVE-2022-30595: When reading a TGA file with RLE packets that cross scan lines, Pillow reads the information past the end of the first line without de…
This release addresses several security problems.
CVE-2022-30595: When reading a TGA file with RLE packets that cross scan lines, Pillow reads the information past the end of the first line without deducting that from the length of the remaining file data. This vulnerability was introduced in Pillow 9.1.0, and can cause a heap buffer overflow.
Opening an image with a zero or negative height has been found to bypass a decompression bomb check. This will now raise a SyntaxError instead, in turn raising a PIL.UnidentifiedImageError.
When reading past the end of a TGA scan line, reduce bytes left. CVE-2022-30595 [radarhere]
Do not open images with zero or negative height #6269 [radarhere]
This release addresses several security issues.
When reading a TGA file with RLE packets that cross scan lines, Pillow reads the information past the end of the first line without deducting that from the length of the remaining file data. This vulnerability was introduced in Pillow 9.1.0, and can cause a heap buffer overflow.
Opening an image with a zero or negative height has been found to bypass a decompression bomb check. This will now raise a SyntaxError instead, in turn raising a PIL.UnidentifiedImageError.
https://pillow.readthedocs.io/en/stable/releasenotes/9.1.0.html
https://pillow.readthedocs.io/en/stable/releasenotes/9.1.0.html
Add support for multiple component transformation to JPEG2000 #5500 [scaramallion, radarhere, hugovk]
Fix loading FriBiDi on Alpine #6165 [nulano]
Added setting for converting GIF P frames to RGB #6150 [radarhere]
Allow 1 mode images to be inverted #6034 [radarhere]
Raise ValueError when trying to save empty JPEG #6159 [radarhere]
Always save TIFF with contiguous planar configuration #5973 [radarhere]
Connected discontiguous polygon corners #5980 [radarhere]
Ensure Tkinter hook is activated for getimage() #6032 [radarhere]
Use screencapture arguments to crop on macOS #6152 [radarhere]
Do not mark L mode JPEG as 1 bit in PDF #6151 [radarhere]
Added support for reading I;16R TIFF images #6132 [radarhere]
If an error occurs after creating a file, remove the file #6134 [radarhere]
Fixed calling DisplayViewer or XVViewer without a title #6136 [radarhere]
Retain RGBA transparency when saving multiple GIF frames #6128 [radarhere]
Save additional ICO frames with other bit depths if supplied #6122 [radarhere]
Handle EXIF data truncated to just the header #6124 [radarhere]
Added support for reading BMP images with RLE8 compression #6102 [radarhere]
Support Python distributions where _tkinter is compiled in #6006 [lukegb]
Added support for PPM arbitrary maxval #6119 [radarhere]
Added BigTIFF reading #6097 [radarhere]
When converting, clip I;16 to be unsigned, not signed #6112 [radarhere]
Fixed loading L mode GIF with transparency #6086 [radarhere]
Improved handling of PPM header #5121 [Piolie, radarhere]
Reset size when seeking away from "Large Thumbnail" MPO frame #6101 [radarhere]
Replace requirements.txt with extras #6072 [hugovk, radarhere]
Added PyEncoder and support BLP saving #6069 [radarhere]
Handle TGA images with packets that cross scan lines #6087 [radarhere]
Added FITS reading #6056 [radarhere, hugovk]
Added rawmode argument to Image.getpalette() #6061 [radarhere]
Fixed BUFR, GRIB and HDF5 stub saving #6071 [radarhere]
Do not automatically remove temporary ImageShow files on Unix #6045 [radarhere]
Correctly read JPEG compressed BLP images #4685 [Meithal, radarhere]
Merged _MODE_CONV typ into ImageMode as typestr #6057 [radarhere]
Consider palette size when converting and in getpalette() #6060 [radarhere]
Added enums #5954 [radarhere]
Ensure image is opaque after converting P to PA with RGB palette #6052 [radarhere]
Attach RGBA palettes from putpalette() when suitable #6054 [radarhere]
Added get_photoshop_blocks() to parse Photoshop TIFF tag #6030 [radarhere]
Drop excess values in BITSPERSAMPLE #6041 [mikhail-iurkov]
Added unpacker from RGBA;15 to RGB #6031 [radarhere]
Enable arm64 for MSVC on Windows #5811 [gaborkertesz-linaro, gaborkertesz]
Keep IPython/Jupyter text/plain output stable #5891 [shamrin, radarhere]
Raise an error when performing a negative crop #5972 [radarhere, hugovk]
Deprecated show_file "file" argument in favour of "path" #5959 [radarhere]
Fixed SPIDER images for use with Bio-formats library #5956 [radarhere]
Ensure duplicated file pointer is closed #5946 [radarhere]
Added specific error if path coordinate type is incorrect #5942 [radarhere]
Return an empty bytestring from tobytes() for an empty image #5938 [radarhere]
Remove readonly from Image.__eq__ #5930 [hugovk]
A number of constants have been deprecated and will be removed in Pillow 10.0.0 (2023-07-01). Instead, enum.IntEnum classes have been added.
Note
Some of these deprecations were restored in Pillow 9.4.0. See restored-image-constants
Deprecated |
Use instead |
|---|---|
Image.NONE |
Either Image.Dither.NONE or Image.Resampling.NEAREST |
Image.NEAREST |
Either Image.Dither.NONE or Image.Resampling.NEAREST |
Image.ORDERED |
Image.Dither.ORDERED |
Image.RASTERIZE |
Image.Dither.RASTERIZE |
Image.FLOYDSTEINBERG |
Image.Dither.FLOYDSTEINBERG |
Image.WEB |
Image.Palette.WEB |
Image.ADAPTIVE |
Image.Palette.ADAPTIVE |
Image.AFFINE |
Image.Transform.AFFINE |
Image.EXTENT |
Image.Transform.EXTENT |
Image.PERSPECTIVE |
Image.Transform.PERSPECTIVE |
Image.QUAD |
Image.Transform.QUAD |
Image.MESH |
Image.Transform.MESH |
Image.FLIP_LEFT_RIGHT |
Image.Transpose.FLIP_LEFT_RIGHT |
Image.FLIP_TOP_BOTTOM |
Image.Transpose.FLIP_TOP_BOTTOM |
Image.ROTATE_90 |
Image.Transpose.ROTATE_90 |
Image.ROTATE_180 |
Image.Transpose.ROTATE_180 |
Image.ROTATE_270 |
Image.Transpose.ROTATE_270 |
Image.TRANSPOSE |
Image.Transpose.TRANSPOSE |
Image.TRANSVERSE |
Image.Transpose.TRANSVERSE |
Image.BOX |
Image.Resampling.BOX |
Image.BILINEAR |
Image.Resampling.BILINEAR |
Image.LINEAR |
Image.Resampling.BILINEAR |
Image.HAMMING |
Image.Resampling.HAMMING |
Image.BICUBIC |
Image.Resampling.BICUBIC |
Image.CUBIC |
Image.Resampling.BICUBIC |
Image.LANCZOS |
Image.Resampling.LANCZOS |
Image.ANTIALIAS |
Image.Resampling.LANCZOS |
Image.MEDIANCUT |
Image.Quantize.MEDIANCUT |
Image.MAXCOVERAGE |
Image.Quantize.MAXCOVERAGE |
Image.FASTOCTREE |
Image.Quantize.FASTOCTREE |
Image.LIBIMAGEQUANT |
Image.Quantize.LIBIMAGEQUANT |
ImageCms.INTENT_PERCEPTUAL |
ImageCms.Intent.PERCEPTUAL |
ImageCms.INTENT_RELATIVE_COLORMETRIC |
ImageCms.Intent.RELATIVE_COLORMETRIC |
ImageCms.INTENT_SATURATION |
ImageCms.Intent.SATURATION |
ImageCms.INTENT_ABSOLUTE_COLORIMETRIC |
ImageCms.Intent.ABSOLUTE_COLORIMETRIC |
ImageCms.DIRECTION_INPUT |
ImageCms.Direction.INPUT |
ImageCms.DIRECTION_OUTPUT |
ImageCms.Direction.OUTPUT |
ImageCms.DIRECTION_PROOF |
ImageCms.Direction.PROOF |
ImageFont.LAYOUT_BASIC |
ImageFont.Layout.BASIC |
ImageFont.LAYOUT_RAQM |
ImageFont.Layout.RAQM |
BlpImagePlugin.BLP_FORMAT_JPEG |
BlpImagePlugin.Format.JPEG |
BlpImagePlugin.BLP_ENCODING_UNCOMPRESSED |
BlpImagePlugin.Encoding.UNCOMPRESSED |
BlpImagePlugin.BLP_ENCODING_DXT |
BlpImagePlugin.Encoding.DXT |
BlpImagePlugin.BLP_ENCODING_UNCOMPRESSED_RAW_RGBA |
BlpImagePlugin.Encoding.UNCOMPRESSED_RAW_RGBA |
BlpImagePlugin.BLP_ALPHA_ENCODING_DXT1 |
BlpImagePlugin.AlphaEncoding.DXT1 |
BlpImagePlugin.BLP_ALPHA_ENCODING_DXT3 |
BlpImagePlugin.AlphaEncoding.DXT3 |
BlpImagePlugin.BLP_ALPHA_ENCODING_DXT5 |
BlpImagePlugin.AlphaEncoding.DXT5 |
FtexImagePlugin.FORMAT_DXT1 |
FtexImagePlugin.Format.DXT1 |
FtexImagePlugin.FORMAT_UNCOMPRESSED |
FtexImagePlugin.Format.UNCOMPRESSED |
PngImagePlugin.APNG_DISPOSE_OP_NONE |
PngImagePlugin.Disposal.OP_NONE |
PngImagePlugin.APNG_DISPOSE_OP_BACKGROUND |
PngImagePlugin.Disposal.OP_BACKGROUND |
PngImagePlugin.APNG_DISPOSE_OP_PREVIOUS |
PngImagePlugin.Disposal.OP_PREVIOUS |
PngImagePlugin.APNG_BLEND_OP_SOURCE |
PngImagePlugin.Blend.OP_SOURCE |
PngImagePlugin.APNG_BLEND_OP_OVER |
PngImagePlugin.Blend.OP_OVER |
The file argument in ~PIL.ImageShow.Viewer.show_file() has been deprecated and will be removed in Pillow 10.0.0 (2023-07-01). It has been replaced by path.
In effect, viewer.show_file("test.jpg") will continue to work unchanged. viewer.show_file(file="test.jpg") will raise a deprecation warning, and suggest viewer.show_file(path="test.jpg") instead.
The stub image plugin FitsStubImagePlugin has been deprecated and will be removed in Pillow 10.0.0 (2023-07-01). FITS images can be read without a handler through ~PIL.FitsImagePlugin instead.
Performing a negative crop on an image previously just returned a (0, 0) image. Now it will raise a ValueError, to help reduce confusion if a user has unintentionally provided the wrong arguments.
Rather than returning a SystemError, passing the incorrect types of coordinates into a path will now raise a more specific ValueError, with the message "incorrect coordinate type".
Rather than installing all dependencies for docs and tests via requirements.txt, extras_require is used instead. This installs only those needed and at the same time as installing Pillow.
For example:
# Install with dependencies for tests:
python3 -m pip install .[tests]
# Or for building docs:
python3 -m pip install .[docs]
# Or for all:
python3 -m pip install .[docs,tests]
On macOS, the last argument may need to be wrapped in quotes, e.g. python3 -m pip install ".[tests]"
Therefore requirements.txt has been removed along with the make install-req command for installing its contents.
~PIL.TiffImagePlugin.TiffImageFile.get_photoshop_blocks has been added, to allow users to determine what Photoshop "Image Resource Blocks" are contained within an image. The keys of the returned dictionary are the image resource IDs.
At present, the information within each block is merely returned as a dictionary with a "data" entry. This will allow more useful information to be added in the future without breaking backwards compatibility.
The PIL.Image.Image.save method now supports the following options for JPEG 2000:
If 1 then enable multiple component transformation when encoding, otherwise use 0 for no component transformation (default). If MCT is enabled and irreversible is True then the Irreversible Color Transformation will be applied, otherwise encoding will use the Reversible Color Transformation. MCT works best with a mode of RGB and is only applicable when the image data has 3 components.
If True then don't wrap the raw codestream in the JP2 file format when saving, otherwise the extension of the filename will be used to determine the format (default).
~PIL.ImageFile.PyEncoder has been added, allowing for file encoders to be written in Python. See Writing Your Own File Codec in Python for more information.
Pillow 9.0.0 introduced the conversion of subsequent GIF frames to RGB or RGBA. This behaviour can now be changed so that the first P frame is converted to RGB as well.
from PIL import GifImagePlugin GifImagePlugin.LOADING_STRATEGY = GifImagePlugin.LoadingStrategy.RGB_ALWAYS
Or subsequent frames can be kept in P mode as long as there is only a single palette.
from PIL import GifImagePlugin GifImagePlugin.LOADING_STRATEGY = GifImagePlugin.LoadingStrategy.RGB_AFTER_DIFFERENT_PALETTE_ONLY
Pillow now builds binary wheels for musllinux, suitable for Linux distributions based on the musl C standard library such as Alpine (rather than the glibc library used by manylinux wheels). See 656.
When calling ~PIL.Image.Image.show or using ~PIL.ImageShow, a temporary file is created from the image. On Unix, Pillow will no longer delete these files, and instead leave it to the operating system to do so.
im._repr_pretty_ has been added to provide a representation of an image without the identity of the object. This allows Jupyter to describe an image and have that description stay the same on subsequent executions of the same code.
Support has been added for reading BigTIFF images.
Support has been added for saving BLP images. blp_version can be used to specify whether the image should be saved as BLP1 or BLP2, e.g. im.save("out.blp", blp_version="BLP1"). By default, BLP2 will be used.
In show_file, use os.remove to remove temporary images. CVE-2022-24303 #6010 [@radarhere, @hugovk]
https://pillow.readthedocs.io/en/stable/releasenotes/9.0.1.html
In show_file, use os.remove to remove temporary images. CVE-2022-24303 #6010 [radarhere, hugovk]
Restrict builtins within lambdas for ImageMath.eval. CVE-2022-22817 #6009 [radarhere]
This release addresses several security problems.
If the path to the temporary directory on Linux or macOS contained a space, this would break removal of the temporary image file after im.show() (and related actions), and potentially remove an unrelated file. This has been present since PIL.
While Pillow 9.0 restricted top-level builtins available to !PIL.ImageMath.eval, it did not prevent builtins available to lambda expressions. These are now also restricted.
Pillow 9.0 added support for xdg-open as an image viewer, but there have been reports that the temporary image file was removed too quickly to be loaded into the final application. A delay has been added.
Removed deprecated PILLOW_VERSION, Image.show command parameter, Image._showxv and ImageFile.raise_ioerror #5776 [@radarhere]
https://pillow.readthedocs.io/en/stable/releasenotes/9.0.0.html
Restrict builtins for ImageMath.eval(). CVE-2022-22817 #5923 [radarhere]
Ensure JpegImagePlugin stops at the end of a truncated file #5921 [radarhere]
Fixed ImagePath.Path array handling. CVE-2022-22815, CVE-2022-22816 #5920 [radarhere]
Remove consecutive duplicate tiles that only differ by their offset #5919 [radarhere]
Improved I;16 operations on big endian #5901 [radarhere]
Limit quantized palette to number of colors #5879 [radarhere]
Fixed palette index for zeroed color in FASTOCTREE quantize #5869 [radarhere]
When saving RGBA to GIF, make use of first transparent palette entry #5859 [radarhere]
Pass SAMPLEFORMAT to libtiff #5848 [radarhere]
Added rounding when converting P and PA #5824 [radarhere]
Improved putdata() documentation and data handling #5910 [radarhere]
Exclude carriage return in PDF regex to help prevent ReDoS #5912 [hugovk]
Fixed freeing pointer in ImageDraw.Outline.transform #5909 [radarhere]
Added ImageShow support for xdg-open #5897 [m-shinder, radarhere]
Support 16-bit grayscale ImageQt conversion #5856 [cmbruns, radarhere]
Convert subsequent GIF frames to RGB or RGBA #5857 [radarhere]
Do not prematurely return in ImageFile when saving to stdout #5665 [infmagic2047, radarhere]
Added support for top right and bottom right TGA orientations #5829 [radarhere]
Corrected ICNS file length in header #5845 [radarhere]
Block tile TIFF tags when saving #5839 [radarhere]
Added line width argument to polygon #5694 [radarhere]
Do not redeclare class each time when converting to NumPy #5844 [radarhere]
Only prevent repeated polygon pixels when drawing with transparency #5835 [radarhere]
Add support for pickling TrueType fonts #5826 [hugovk, radarhere]
Only prefer command line tools SDK on macOS over default MacOSX SDK #5828 [radarhere]
Drop support for soon-EOL Python 3.6 #5768 [hugovk, nulano, radarhere]
Fix compilation on 64-bit Termux #5793 [landfillbaby]
Use title for display in ImageShow #5788 [radarhere]
Remove support for FreeType 2.7 and older #5777 [hugovk, radarhere]
Fix for PyQt6 #5775 [hugovk, radarhere]
Removed deprecated PILLOW_VERSION, Image.show command parameter, Image._showxv and ImageFile.raise_ioerror #5776 [radarhere]
This release is dedicated to the memory of Fredrik Lundh, aka Effbot, who died in November 2021. Fredrik created PIL in 1995 and he was instrumental in the early success of Python.
Fredrik was an early Python contributor (e.g. Elementtree and the 're' module) and his enthusiasm for the language and community were inspiring for all who encountered him or his work. He spent countless hours on comp.lang.python answering questions from newbies and advanced users alike.
He also co-founded an early Python startup, Secret Labs AB, which among other software released an IDE named PythonWorks. Fredrik also created the Python Imaging Library (PIL) which is still THE way to interact with images in Python, now most often through its Pillow fork. His effbot.org site was a valuable resource for generations of Python users, especially its Tkinter documentation.
Thank you, Fredrik.
JpegImagePlugin may append an EOF marker to the end of a truncated file, so that the last segment of the data will still be processed by the decoder.
If the EOF marker is not detected as such however, this could lead to an infinite loop where JpegImagePlugin keeps trying to end the file.
To prevent attempts to slow down loading times for images, if an image has consecutive duplicate tiles that only differ by their offset, only load the last tile. Credit to Google's OSS-Fuzz project for finding this issue.
To limit PIL.ImageMath to working with images, Pillow will now restrict the builtins available to !PIL.ImageMath.eval. This will help prevent problems arising if users evaluate arbitrary expressions, such as ImageMath.eval("exec(exit())").
2022-22815 (126) and 2022-22816 (665) were found when initializing ImagePath.Path.
Pillow has dropped support for Python 3.6, which reached end-of-life on 2021-12-23.
PILLOW_VERSION has been removed. Use __version__ instead.
Support for FreeType 2.7 has been removed; FreeType 2.8 is the minimum supported.
We recommend upgrading to at least FreeType 2.10.4, which fixed a severe vulnerability introduced in FreeType 2.6 (2020-15999).
The command parameter has been removed. Use a subclass of PIL.ImageShow.Viewer instead.
Image._showxv has been removed. Use ~PIL.Image.Image.show instead. If custom behaviour is required, use ~PIL.ImageShow.register to add a custom ~PIL.ImageShow.Viewer class.
IOError was merged into OSError in Python 3.3. So, ImageFile.raise_ioerror has been removed. Use ImageFile.raise_oserror instead.
An optional line width parameter has been added to ImageDraw.Draw.polygon.
If xdg-open is present on Linux, this new PIL.ImageShow.Viewer subclass will be registered. It displays images using the application selected by the system.
It is higher in priority than the other default PIL.ImageShow.Viewer instances, so it will be preferred by im.show() or .ImageShow.show().
Support has been added for the "title" argument in ~PIL.ImageShow.UnixViewer.DisplayViewer, so that when im.show() or .ImageShow.show() use the display command line tool, the "title" argument will also now be supported, e.g. im.show(title="My Image") and ImageShow.show(im, title="My Image").
Since each frame of a GIF can have up to 256 colors, after the first frame it is possible for there to be too many colors to fit in a P mode image. To allow for this, seeking to any subsequent GIF frame will now convert the image to RGB or RGBA, depending on whether or not the first frame had transparency.
The Pillow wheels from PyPI for macOS and Linux have switched from libjpeg to libjpeg-turbo. It is a fork of libjpeg, popular for its speed.
Because different JPEG decoders load images differently, JPEG pixels may be altered slightly with this change.
TrueType fonts may now be pickled and unpickled. For example:
import pickle
from PIL import ImageFont
font = ImageFont.truetype("arial.ttf", size=30)
pickled_font = pickle.dumps(font, protocol=pickle.HIGHEST_PROTOCOL)
# Later...
unpickled_font = pickle.loads(pickled_font)
TGA images with top right or bottom right orientations are now supported.
https://pillow.readthedocs.io/en/stable/releasenotes/8.4.0.html
https://pillow.readthedocs.io/en/stable/releasenotes/8.4.0.html
Prefer global transparency in GIF when replacing with background color #5756 [radarhere]
Added "exif" keyword argument to TIFF saving #5575 [radarhere]
Copy Python palette to new image in quantize() #5696 [radarhere]
Read ICO AND mask from end #5667 [radarhere]
Actually check the framesize in FliDecode.c #5659 [wiredfool]
Determine JPEG2000 mode purely from ihdr header box #5654 [radarhere]
Fixed using info dictionary when writing multiple APNG frames #5611 [radarhere]
Allow saving 1 and L mode TIFF with PhotometricInterpretation 0 #5655 [radarhere]
For GIF save_all with palette, do not include palette with each frame #5603 [radarhere]
Keep transparency when converting from P to LA or PA #5606 [radarhere]
Copy palette to new image in transform() #5647 [radarhere]
Added "transparency" argument to EpsImagePlugin load() #5620 [radarhere]
Corrected pathlib.Path detection when saving #5633 [radarhere]
Added WalImageFile class #5618 [radarhere]
Consider I;16 pixel size when drawing text #5598 [radarhere]
If default conversion from P is RGB with transparency, convert to RGBA #5594 [radarhere]
Speed up rotating square images by 90 or 270 degrees #5646 [radarhere]
Add support for reading DPI information from JPEG2000 images [rogermb, radarhere]
Catch TypeError from corrupted DPI value in EXIF #5639 [homm, radarhere]
Do not close file pointer when saving SGI images #5645 [farizrahman4u, radarhere]
Deprecate ImagePalette size parameter #5641 [radarhere, hugovk]
Prefer command line tools SDK on macOS #5624 [radarhere]
Added tags when saving YCbCr TIFF #5597 [radarhere]
PSD layer count may be negative #5613 [radarhere]
Fixed ImageOps expand with tuple border on P image #5615 [radarhere]
Fixed error saving APNG with duplicate frames and different duration times #5609 [thak1411, radarhere]
The size parameter will be removed in Pillow 10.0.0 (2023-07-01).
Before Pillow 8.3.0, ImagePalette required palette data of particular lengths by default, and the size parameter could be used to override that. Pillow 8.3.0 removed the default required length, also removing the need for the size parameter.
This new argument switches the Ghostscript device from "ppmraw" to "pngalpha", generating an RGBA image with a transparent background instead of an RGB image with a white background.
with Image.open("sample.eps") as im:
im.load(transparency=True)
PIL.WalImageFile.open() previously returned a generic PIL.Image.Image instance. It now returns a dedicated PIL.WalImageFile.WalImageFile class.
Starting with Pillow 3.3.0, the speed of rotating images by 90 or 270 degrees was improved by quickly returning ~PIL.Image.Image.transpose instead, if the rotate operation allowed for expansion and did not specify a center or post-rotate translation.
Since the expand flag makes no difference for square images though, Pillow now uses this faster method for square images without the expand flag as well.
CVE-2021-23437 Raise ValueError if color specifier is too long [hugovk, radarhere]
https://pillow.readthedocs.io/en/stable/releasenotes/8.3.2.html
CVE-2021-23437 Raise ValueError if color specifier is too long [hugovk, radarhere]
Fix 6-byte OOB read in FliDecode [wiredfool]
Ensure TIFF RowsPerStrip is multiple of 8 for JPEG compression #5588
[kmilos, radarhere]
Updates for ImagePalette channel order #5599
[radarhere]
Hide FriBiDi shim symbols to avoid conflict with real FriBiDi library #5651 [nulano]
Avoid a potential ReDoS (regular expression denial of service) in ~PIL.ImageColor's ~PIL.ImageColor.getrgb by raising ValueError if the color specifier is too long. Present since Pillow 5.2.0.
Fix 6-byte out-of-bounds (OOB) read. The previous bounds check in FliDecode.c incorrectly calculated the required read buffer size when copying a chunk, potentially reading six extra bytes off the end of the allocated buffer from the heap. Present since Pillow 7.1.0.
This bug was found by Google's OSS-Fuzz CIFuzz runs.
Pillow now includes binary wheels for Python 3.10.
The Python 3.10 release candidate was released on 2021-08-03 with the final release due 2021-10-04 (619). The CPython core team strongly encourages maintainers of third-party Python projects to prepare for 3.10 compatibility. And as there are no ABI changes planned we are releasing wheels to help others prepare for 3.10, and ensure Pillow can be used immediately on release day of 3.10.0 final.
Ensure TIFF RowsPerStrip is multiple of 8 for JPEG compression (5588).
Updates for ~PIL.ImagePalette channel order (5599).
Hide FriBiDi shim symbols to avoid conflict with real FriBiDi library (5651).
https://pillow.readthedocs.io/en/stable/releasenotes/8.3.1.html
https://pillow.readthedocs.io/en/stable/releasenotes/8.3.1.html
Catch OSError when checking if fp is sys.stdout #5585 [radarhere]
Handle removing orientation from alternate types of EXIF data #5584 [radarhere]
Make Image.__array__ take optional dtype argument #5572 [t-vi, radarhere]
This fixes a regression introduced in 8.3.0 when converting an image to a NumPy array with a dtype argument.
>>> from PIL import Image
>>> import numpy
>>> im = Image.new("RGB", (100, 100))
>>> numpy.array(im, dtype=numpy.float64)
Traceback (most recent call last):
File "<stdin>", line 1, in <module>
TypeError: __array__() takes 1 positional argument but 2 were given
>>>
In 8.3.0, a check to see if the destination was sys.stdout when saving an image was updated. This lead to an OSError being raised if the environment restricted access.
The OSError is now silently caught.
In 8.3.0, ~PIL.ImageOps.exif_transpose was changed to ensure that the original image EXIF data was not modified, and the orientation was only removed from the modified copy.
However, for certain images the orientation was already missing from the modified image, leading to a KeyError.
This error has been resolved, and the copying of metadata to the modified image improved.
Add test for CVE-2021-25292 ReDoS #5393 [@hugovk]
https://pillow.readthedocs.io/en/stable/releasenotes/8.3.0.html
Use snprintf instead of sprintf. CVE-2021-34552 #5567 [radarhere]
Limit TIFF strip size when saving with LibTIFF #5514 [kmilos]
Allow ICNS save on all operating systems #4526 [baletu, radarhere, newpanjing, hugovk]
De-zigzag JPEG's DQT when loading; deprecate convert_dict_qtables #4989 [gofr, radarhere]
Replaced xml.etree.ElementTree #5565 [radarhere]
Moved CVE image to pillow-depends #5561 [radarhere]
Added tag data for IFD groups #5554 [radarhere]
Improved ImagePalette #5552 [radarhere]
Add DDS saving #5402 [radarhere]
Improved getxmp() #5455 [radarhere]
Convert to float for comparison with float in IFDRational __eq__ #5412 [radarhere]
Allow getexif() to access TIFF tag_v2 data #5416 [radarhere]
Read FITS image mode and size #5405 [radarhere]
Merge parallel horizontal edges in ImagingDrawPolygon #5347 [radarhere, hrdrq]
Use transparency behind first GIF frame and when disposing to background #5557 [radarhere, zewt]
Avoid unstable nature of qsort in Quant.c #5367 [radarhere]
Copy palette to new images in ImageOps expand #5551 [radarhere]
Ensure palette string matches RGB mode #5549 [radarhere]
Do not modify EXIF of original image instance in exif_transpose() #5547 [radarhere]
Fixed default numresolution for small JPEG2000 images #5540 [radarhere]
Added DDS BC5 reading #5501 [radarhere]
Raise an error if ImageDraw.textbbox is used without a TrueType font #5510 [radarhere]
Added ICO saving in BMP format #5513 [radarhere]
Ensure PNG seeks to end of previous chunk at start of load_end #5493 [radarhere]
Do not allow TIFF to seek to a past frame #5473 [radarhere]
Avoid race condition when displaying images with eog #5507 [mconst]
Added specific error messages when ink has incorrect number of bands #5504 [radarhere]
Allow converting an image to a numpy array to raise errors #5379 [radarhere]
Removed DPI rounding from BMP, JPEG, PNG and WMF loading #5476, #5470 [radarhere]
Remove spikes when drawing thin pieslices #5460 [xtsm]
Updated default value for SAMPLESPERPIXEL TIFF tag #5452 [radarhere]
Removed TIFF DPI rounding #5446 [radarhere, hugovk]
Include code in WebP error #5471 [radarhere]
Do not alter pixels outside mask when drawing text on an image with transparency #5434 [radarhere]
Reset handle when seeking backwards in TIFF #5443 [radarhere]
Replace sys.stdout with sys.stdout.buffer when saving #5437 [radarhere]
Fixed UNDEFINED TIFF tag of length 0 being changed in roundtrip #5426 [radarhere]
Fixed bug when checking FreeType2 version if it is not installed #5445 [radarhere]
Do not round dimensions when saving PDF #5459 [radarhere]
Added ImageOps contain() #5417 [radarhere, hugovk]
Changed WebP default "method" value to 4 #5450 [radarhere]
Switched to saving 1-bit PDFs with DCTDecode #5430 [radarhere]
Use bpp from ICO header #5429 [radarhere]
Corrected JPEG APP14 transform value #5408 [radarhere]
Changed TIFF tag 33723 length to 1 #5425 [radarhere]
Changed ImageMorph incorrect mode errors to ValueError #5414 [radarhere]
Add EXIF tags specified in EXIF 2.32 #5419 [gladiusglad]
Treat previous contents of first GIF frame as transparent #5391 [radarhere]
For special image modes, revert default resize resampling to NEAREST #5411 [radarhere]
JPEG2000: Support decoding subsampled RGB and YCbCr images #4996 [nulano, radarhere]
Stop decoding BC1 punchthrough alpha in BC2&3 #4144 [jansol]
Use zero if GIF background color index is missing #5390 [radarhere]
Fixed ensuring that GIF previous frame was loaded #5386 [radarhere]
Valgrind fixes #5397 [wiredfool]
Round down the radius in rounded_rectangle #5382 [radarhere]
Fixed reading uncompressed RGB data from DDS #5383 [radarhere]
PIL since 1.1.4 and Pillow since 1.0 allowed parameters passed into a convert function to trigger buffer overflow in Convert.c.
Pillow previously parsed XMP data using Python's xml module. However, this module is not secure.
~PIL.Image.Image.getexif has used xml to potentially retrieve orientation data since Pillow 7.2.0. It has been refactored to use re instead.
getxmp() was added to ~PIL.JpegImagePlugin.JpegImageFile in Pillow 8.2.0. It will now use defusedxml instead. If the dependency is not present, an empty dictionary will be returned and a warning raised.
JPEG quantization is now automatically converted, but still returned as a dictionary. The convert_dict_qtables method no longer performs any operations on the data given to it, has been deprecated and will be removed in Pillow 10.0.0 (2023-07-01).
Previously, it was 0, for the best speed. The default has now been changed to 4, to match WebP's default, for higher quality with still some speed optimisation.
Pillow 7.0 changed the default resampling filter to Image.BICUBIC. However, as this is not supported yet for images with a custom number of bits, the default filter for those modes has been reverted to Image.NEAREST.
For apply(), match() and get_on_pixels(), if the image mode is not L, an Exception was thrown. This has now been changed to a ValueError.
XMP data can now be returned for PNG and TIFF images, through getxmp() for each format.
The returned dictionary will start from the base of the XML, meaning that the top level should contain an "xmpmeta" key. JPEG's getxmp() method has also been updated to this structure.
TIFF ~PIL.TiffImagePlugin.TiffImageFile.tag_v2 data can now be accessed through ~PIL.Image.Image.getexif. This also provides access to the GPS and EXIF IFDs, through im.getexif().get_ifd(0x8825) and im.getexif().get_ifd(0x8769) respectively.
Returns a resized version of the image, set to the maximum width and height within size, while maintaining the original aspect ratio.
To compare it to other ImageOps methods:
~PIL.ImageOps.fit expands an image until is fills size, cropping the parts of the image that do not fit.
~PIL.ImageOps.pad expands an image to fill size, without cropping, but instead filling the extra space with color.
~PIL.ImageOps.contain is similar to ~PIL.ImageOps.pad, but it does not fill the extra space. Instead, the original aspect ratio is maintained. So unlike the other two methods, it is not guaranteed to return an image of size.
By default, Pillow saves ICO files in the PNG format. They can now also be saved in BMP format, through the new bitmap_format argument:
im.save("out.ico", bitmap_format="bmp")
Support has been added to read the BC5 format of DDS images, whether UNORM, SNORM or TYPELESS.
Support has also been added to write the uncompressed format of DDS images.
Security fixes for 8.2.0 #5377 [@hugovk]
https://pillow.readthedocs.io/en/stable/releasenotes/8.2.0.html
Added getxmp() method #5144 [UrielMaD, radarhere]
Add ImageShow support for GraphicsMagick #5349 [latosha-maltba, radarhere]
Do not load transparent pixels from subsequent GIF frames #5333 [zewt, radarhere]
Use LZW encoding when saving GIF images #5291 [raygard]
Set all transparent colors to be equal in quantize() #5282 [radarhere]
Allow PixelAccess to use Python __int__ when parsing x and y #5206 [radarhere]
Removed Image._MODEINFO #5316 [radarhere]
Add preserve_tone option to autocontrast #5350 [elejke, radarhere]
Fixed linear_gradient and radial_gradient I and F modes #5274 [radarhere]
Add support for reading TIFFs with PlanarConfiguration=2 #5364 [kkopachev, wiredfool, nulano]
Deprecated categories #5351 [radarhere]
Do not premultiply alpha when resizing with Image.NEAREST resampling #5304 [nulano]
Dynamically link FriBiDi instead of Raqm #5062 [nulano]
Allow fewer PNG palette entries than the bit depth maximum when saving #5330 [radarhere]
Use duration from info dictionary when saving WebP #5338 [radarhere]
Stop flattening EXIF IFD into getexif() #4947 [radarhere, kkopachev]
Replaced tiff_deflate with tiff_adobe_deflate compression when saving TIFF images #5343 [radarhere]
Save ICC profile from TIFF encoderinfo #5321 [radarhere]
Moved RGB fix inside ImageQt class #5268 [radarhere]
Allow alpha_composite destination to be negative #5313 [radarhere]
Ensure file is closed if it is opened by ImageQt.ImageQt #5260 [radarhere]
Added ImageDraw rounded_rectangle method #5208 [radarhere]
Added IPythonViewer #5289 [radarhere, Kipkurui-mutai]
Only draw each rectangle outline pixel once #5183 [radarhere]
Use mmap instead of built-in Win32 mapper #5224 [radarhere, cgohlke]
Handle PCX images with an odd stride #5214 [radarhere]
Only read different sizes for "Large Thumbnail" MPO frames #5168 [radarhere]
Added PyQt6 support #5258 [radarhere]
Changed Image.open formats parameter to be case-insensitive #5250 [Piolie, radarhere]
Deprecate Tk/Tcl 8.4, to be removed in Pillow 10 (2023-07-01) #5216 [radarhere]
Added tk version to pilinfo #5226 [radarhere, nulano]
Support for ignoring tests when running valgrind #5150 [wiredfool, radarhere, hugovk]
OSS-Fuzz support #5189 [wiredfool, radarhere]
These issues were all found with OSS-Fuzz.
For J2k images with multiple bands, it's legal to have different widths for each band, e.g. 1 byte for L, 4 bytes for A.
This dates to Pillow 2.4.0.
.PsdImagePlugin.PsdImageFile did not sanity check the number of input layers with regard to the size of the data block, this could lead to a denial-of-service on ~PIL.Image.open prior to ~PIL.Image.Image.load.
This dates to the PIL fork.
FliDecode.c did not properly check that the block advance was non-zero, potentially leading to an infinite loop on load.
This dates to the PIL fork.
The readline used in EPS has to deal with any combination of \r and \n as line endings. It accidentally used a quadratic method of accumulating lines while looking for a line ending.
A malicious EPS file could use this to perform a denial-of-service of Pillow in the open phase, before an image was accepted for opening.
This dates to the PIL fork.
BlpImagePlugin did not properly check that reads after jumping to file offsets returned data. This could lead to a denial-of-service where the decoder could be run a large number of times on empty data.
This dates to Pillow 5.1.0.
A corrupt or specially crafted TTF font could have font metrics that lead to unreasonably large sizes when rendering text in font. ImageFont.py did not check the image size before allocating memory for it.
This dates to the PIL fork.
im.category is deprecated and will be removed in Pillow 10.0.0 (2023-07-01), along with the related Image.NORMAL, Image.SEQUENCE and Image.CONTAINER attributes.
To determine if an image has multiple frames or not, getattr(im, "is_animated", False) can be used instead.
Support for Tk/Tcl 8.4 is deprecated and will be removed in Pillow 10.0.0 (2023-07-01), when Tk/Tcl 8.5 will be the minimum supported.
When calling ~PIL.Image.Image.alpha_composite, the dest argument now accepts negative coordinates, like the upper left corner of the box argument of ~PIL.Image.Image.paste can be negative. Naturally, this has effect of cropping the overlaid image.
Previously, ~PIL.Image.Image.getexif flattened the EXIF IFD into the rest of the data, losing information. This information is now kept separate, moved under im.getexif().get_ifd(0x8769).
Direct access to the GPS IFD dictionary was possible through im.getexif()[0x8825]. This is now consistent with other IFDs, and must be accessed through im.getexif().get_ifd(0x8825).
These changes only affect ~PIL.Image.Image.getexif, introduced in Pillow 6.0. The older _getexif() methods are unaffected.
This internal dictionary had been deprecated by a comment since PIL, and is now removed. Instead, Image.getmodebase(), Image.getmodetype(), Image.getmodebandnames(), Image.getmodebands() or ImageMode.getmode() can be used.
A new method has been added to return XMP data for JPEG images. It reads the XML data into a dictionary of names and values.
For example:
>>> from PIL import Image
>>> with Image.open("Tests/images/xmp_test.jpg") as im:
>>> print(im.getxmp())
{'RDF': {}, 'Description': {'Version': '10.4', 'ProcessVersion': '10.0', ...}, ...}
Added ~PIL.ImageDraw.ImageDraw.rounded_rectangle. It works the same as ~PIL.ImageDraw.ImageDraw.rectangle, except with an additional radius argument. radius is limited to half of the width or the height, so that users can create a circle, but not any other ellipse.
from PIL import Image, ImageDraw
im = Image.new("RGB", (200, 200))
draw = ImageDraw.Draw(im)
draw.rounded_rectangle(xy=(10, 20, 190, 180), radius=30, fill="red")
The default behaviour of ~PIL.ImageOps.autocontrast is to normalize separate histograms for each color channel, changing the tone of the image. The new preserve_tone argument keeps the tone unchanged by using one luminance histogram for all channels.
If GraphicsMagick is present, this new PIL.ImageShow.Viewer subclass will be registered. It uses GraphicsMagick, an ImageMagick fork, to display images.
The GraphicsMagick based viewer has a lower priority than its ImageMagick counterpart. Thus, if both ImageMagick and GraphicsMagick are installed, im.show() and .ImageShow.show() prefer the viewer based on ImageMagick, i.e the behaviour stays the same for Pillow users having ImageMagick installed.
If IPython is present, this new PIL.ImageShow.Viewer subclass will be registered. It displays images on all IPython frontends. This will be helpful to users of Google Colab, allowing im.show() to display images.
It is lower in priority than the other default PIL.ImageShow.Viewer instances, so it will only be used by im.show() or .ImageShow.show() if none of the other viewers are available. This means that the behaviour of PIL.ImageShow will stay the same for most Pillow users.
As is already possible for JPEG, PNG and WebP, the ICC profile for TIFF files can now be specified through a keyword argument:
im.save("out.tif", icc_profile=...)
GIF files are now written using LZW encoding, which will generate smaller files, typically about 70% of the size generated by the older encoder.
The pixel data is encoded using the format specified in the CompuServe GIF standard.
The older encoder used a variant of run-length encoding that was compatible but less efficient.
The test suite can now be run on systems which have GraphicsMagick but not ImageMagick installed. If both are installed, the tests prefer ImageMagick.
The way the libraqm dependency for complex text scripts is linked has been changed:
Source builds will now link against the system version of libraqm at build time rather than at runtime by default.
Binary wheels now include a statically linked modified version of libraqm that links against FriBiDi at runtime instead. This change is intended to address issues with the previous implementation on some platforms. These are created by building Pillow with the new build flags --vendor-raqm --vendor-fribidi.
Windows users will now need to install fribidi.dll (or fribidi-0.dll) only, libraqm.dll is no longer used.
See installation documentation for more information.
Support has been added for PyQt6. If it is installed, it will be used instead of PySide6, PyQt5 or PySide2.
https://pillow.readthedocs.io/en/stable/releasenotes/8.1.2.html
https://pillow.readthedocs.io/en/stable/releasenotes/8.1.2.html
Fix Memory DOS in BLP (CVE-2021-27921), ICNS (CVE-2021-27922) and ICO (CVE-2021-27923) Image Plugins [wiredfool]
There is an exhaustion of memory DOS attack in BLP, ICNS, ICO images where Pillow did not properly check the reported size of the contained image. These images could cause arbitrarily large memory allocations.
These issues were reported by Jiayi Lin, Luke Shaffer, Xinran Xie and Akshay Ajayan of Arizona State University.
https://pillow.readthedocs.io/en/stable/releasenotes/8.1.1.html
https://pillow.readthedocs.io/en/stable/releasenotes/8.1.1.html
Use more specific regex chars to prevent ReDoS. CVE-2021-25292 [hugovk]
Fix OOB Read in TiffDecode.c, and check the tile validity before reading. CVE-2021-25291 [wiredfool]
Fix negative size read in TiffDecode.c. CVE-2021-25290 [wiredfool]
Fix OOB read in SgiRleDecode.c. CVE-2021-25293 [wiredfool]
Incorrect error code checking in TiffDecode.c. CVE-2021-25289 [wiredfool]
PyModule_AddObject fix for Python 3.10 #5194 [radarhere]
The previous fix for 2020-35654 was insufficient due to incorrect error checking in TiffDecode.c.
In TiffDecode.c, there is a negative-offset memcpy with an invalid size.
In TiffDecode.c, invalid tile boundaries could lead to an out-of-bounds read in TIFFReadRGBATile.
The PDF parser has a catastrophic backtracking regex that could be used as a DOS attack.
There is an out-of-bounds read in SgiRleDecode.c since Pillow 4.3.0.
A crash with the feature flags for libimagequant, libjpeg-turbo, WebP and XCB on unreleased Python 3.10 has been fixed (5193).
Deprecate FreeType 2.7 #5098 [@hugovk]
https://pillow.readthedocs.io/en/stable/releasenotes/8.1.0.html
Fix TIFF OOB Write error. CVE-2020-35654 #5175 [wiredfool]
Fix for Read Overflow in PCX Decoding. CVE-2020-35653 #5174 [wiredfool, radarhere]
Fix for SGI Decode buffer overrun. CVE-2020-35655 #5173 [wiredfool, radarhere]
Fix OOB Read when saving GIF of xsize=1 #5149 [wiredfool]
Makefile updates #5159 [wiredfool, radarhere]
Add support for PySide6 #5161 [hugovk]
Use disposal settings from previous frame in APNG #5126 [radarhere]
Added exception explaining that _repr_png_ saves to PNG #5139 [radarhere]
Use previous disposal method in GIF load_end #5125 [radarhere]
Allow putpalette to accept 1024 integers to include alpha values #5089 [radarhere]
Fix OOB Read when writing TIFF with custom Metadata #5148 [wiredfool]
Added append_images support for ICO #4568 [ziplantil, radarhere]
Block TIFFTAG_SUBIFD #5120 [radarhere]
Fixed dereferencing potential null pointers #5108, #5111 [cgohlke, radarhere]
Deprecate FreeType 2.7 #5098 [hugovk, radarhere]
Moved warning to end of execution #4965 [radarhere]
Removed unused fromstring and tostring C methods #5026 [radarhere]
init() if one of the formats is unrecognised #5037 [radarhere]
Moved string_dimension CVE image to pillow-depends #4993 [radarhere]
Support raw rgba8888 for DDS #4760 [qiankanglai]
This release includes security fixes.
An out-of-bounds read when saving TIFFs with custom metadata through LibTIFF
An out-of-bounds read when saving a GIF of 1px width
The PCX image decoder used the reported image stride to calculate the row buffer, rather than calculating it from the image size. This issue dates back to the PIL fork. Thanks to Google's OSS-Fuzz project for finding this.
Out-of-bounds write in TiffDecode.c when reading corrupt YCbCr files in some LibTIFF versions (4.1.0/Ubuntu 20.04, but not 4.0.9/Ubuntu 18.04). In some cases LibTIFF's interpretation of the file is different when reading in RGBA mode, leading to an out-of-bounds write in TiffDecode.c. This potentially affects Pillow versions from 6.0.0 to 8.0.1, depending on the version of LibTIFF. This was reported through Tidelift.
4 byte read overflow in SgiRleDecode.c, where the code was not correctly checking the offsets and length tables. Independently reported through Tidelift and Google's OSS-Fuzz. This vulnerability covers Pillow versions 4.3.0->8.0.1.
OpenJPEG in the macOS and Linux wheels has been updated from 2.3.1 to 2.4.0, including security fixes.
LibTIFF in the macOS and Linux wheels has been updated from 4.1.0 to 4.2.0, including security fixes discovered by fuzzers.
Support for FreeType 2.7 is deprecated and will be removed in Pillow 9.0.0 (2022-01-02), when FreeType 2.8 will be the minimum supported.
We recommend upgrading to at least FreeType 2.10.4, which fixed a severe vulnerability introduced in FreeType 2.6 (2020-15999).
The install-venv target has been deprecated.
When saving an ICO image, the file may contain versions of the image at different sizes. By default, Pillow will scale down the main image to create these copies.
With this release, a list of images can be provided to the append_images parameter when saving, to replace the scaled down versions. This is the same functionality that already exists for the ICNS format.
The co target has been removed.
Wheels have been added for PyPy 3.7.
Support has been added for PySide6. If it is installed, it will be used instead of PyQt5 or PySide2, since it is based on a newer Qt.
https://pillow.readthedocs.io/en/stable/releasenotes/8.0.1.html
https://pillow.readthedocs.io/en/stable/releasenotes/8.0.1.html
Update FreeType used in binary wheels to 2.10.4 to fix CVE-2020-15999. [radarhere]
Moved string_dimension image to pillow-depends #4993 [radarhere]
A heap buffer overflow has been found in the handling of embedded PNG bitmaps, introduced in FreeType version 2.6.
If you use option FT_CONFIG_OPTION_USE_PNG you should upgrade immediately.
We strongly recommend updating to Pillow 8.0.1 if you are using Pillow 8.0.0, which improved support for bitmap fonts.
In Pillow 7.2.0 and earlier bitmap fonts were disabled with FT_LOAD_NO_BITMAP, but it is not clear if this prevents the exploit and we recommend updating to Pillow 8.0.1.
Pillow 8.0.0 and earlier are potentially vulnerable releases, including the last release to support Python 2.7, namely Pillow 6.2.2.
https://pillow.readthedocs.io/en/stable/releasenotes/8.0.0.html
https://pillow.readthedocs.io/en/stable/releasenotes/8.0.0.html
Drop support for EOL Python 3.5 #4746, #4794 [hugovk, radarhere, nulano]
Drop support for PyPy3 < 7.2.0 #4964 [nulano]
Remove ImageCms.CmsProfile attributes deprecated since 3.2.0 #4768 [hugovk, radarhere]
Remove long-deprecated Image.py functions #4798 [hugovk, nulano, radarhere]
Add support for 16-bit precision JPEG quantization values #4918 [gofr]
Added reading of IFD tag type #4979 [radarhere]
Initialize offset memory for PyImagingPhotoPut #4806 [nqbit]
Fix TiffDecode comparison warnings #4756 [nulano]
Docs: Add dark mode #4968 [hugovk, nulano]
Added macOS SDK install path to library and include directories #4974 [radarhere, fxcoudert]
Imaging.h: prevent confusion with system #4923 [ax3l, ,radarhere]
Avoid using pkg_resources in PIL.features.pilinfo #4975 [nulano]
Add getlength and getbbox functions for TrueType fonts #4959 [nulano, radarhere, hugovk]
Allow tuples with one item to give single color value in getink #4927 [radarhere, nulano]
Add support for CBDT and COLR fonts #4955 [nulano, hugovk]
Removed OSError in favour of DecompressionBombError for BMP #4966 [radarhere]
Implemented another ellipse drawing algorithm #4523 [xtsm, radarhere]
Removed unused JpegImagePlugin._fixup_dict function #4957 [radarhere]
Added reading and writing of private PNG chunks #4292 [radarhere]
Implement anchor for TrueType fonts #4930 [nulano, hugovk]
Fixed bug in Exif __delitem__ #4942 [radarhere]
Fix crash in ImageTk.PhotoImage on MinGW 64-bit #4946 [nulano]
Moved CVE images to pillow-depends #4929 [radarhere]
Refactor font_getsize and font_render #4910 [nulano]
Fixed loading profile with non-ASCII path on Windows #4914 [radarhere]
Fixed effect_spread bug for zero distance #4908 [radarhere, hugovk]
Added formats parameter to Image.open #4837 [nulano, radarhere]
Added regular_polygon draw method #4846 [comhar]
Raise proper TypeError in putpixel #4882 [nulano, hugovk]
Added writing of subIFDs #4862 [radarhere]
Fix IFDRational __eq__ bug #4888 [luphord, radarhere]
Fixed duplicate variable name #4885 [liZe, radarhere]
Added homebrew zlib include directory #4842 [radarhere]
Corrected inverted PDF CMYK colors #4866 [radarhere]
Do not try to close file pointer if file pointer is empty #4823 [radarhere]
ImageOps.autocontrast: add mask parameter #4843 [navneeth, hugovk]
Read EXIF data tEXt chunk into info as bytes instead of string #4828 [radarhere]
Replaced distutils with setuptools #4797, #4809, #4814, #4817, #4829, #4890 [hugovk, radarhere]
Add MIME type to PsdImagePlugin #4788 [samamorgan]
Allow ImageOps.autocontrast to specify low and high cutoffs separately #4749 [millionhz, radarhere]
Pillow has dropped support for Python 3.5, which reached end-of-life on 2020-09-13.
Pillow has dropped support for PyPy3 7.1.1. PyPy3 7.2.0, released on 2019-10-14, is now the minimum compatible version.
im.offset() has been removed, call .ImageChops.offset() instead.
Image.fromstring() has been removed, call .Image.frombytes() instead.
im.fromstring() has been removed, call ~PIL.Image.Image.frombytes() instead.
im.tostring() has been removed, call ~PIL.Image.Image.tobytes() instead.
Some attributes in PIL.ImageCms.core.CmsProfile have been removed:
Removed |
Use instead |
|---|---|
color_space |
Padded ~.CmsProfile.xcolor_space |
pcs |
Padded ~.CmsProfile.connection_space |
product_copyright |
Unicode ~.CmsProfile.copyright |
product_desc |
Unicode ~.CmsProfile.profile_description |
product_description |
Unicode ~.CmsProfile.profile_description |
product_manufacturer |
Unicode ~.CmsProfile.manufacturer |
product_model |
Unicode ~.CmsProfile.model |
Fixed issue where passing stroke_width with a non-zero value to .ImageDraw.text would cause the text to be offset by that amount.
The anchor parameter of .ImageDraw.text has been implemented.
Use this parameter to change the position of text relative to the specified xy point. See text-anchors for details.
"image/vnd.adobe.photoshop" is now registered as the .PsdImagePlugin.PsdImageFile MIME type.
Added a new formats parameter to .Image.open:
A list or tuple of formats to attempt to load the file in. This can be used to restrict the set of formats checked. Pass None to try all supported formats. You can print the set of available formats by running python3 -m PIL or using the PIL.features.pilinfo function.
.ImageOps.autocontrast can now take a mask parameter:
Histogram used in contrast operation is computed using pixels within the mask. If no mask is given the entire image is used for histogram computation.
Previously, the cutoff parameter of .ImageOps.autocontrast could only be a single number, used as the percent to cut off from the histogram on the low and high ends.
Now, it can also be a tuple (low, high).
A new method .ImageDraw.regular_polygon, draws a regular polygon of n_sides, inscribed in a bounding_circle.
For example draw.regular_polygon(((100, 100), 50), 5) draws a pentagon centered at the point (100, 100) with a polygon radius of 50.
The methods .ImageDraw.text and .ImageDraw.multiline_text now support fonts with embedded color data.
To render text with embedded color data, use the parameter embedded_color=True.
Support for CBDT fonts requires FreeType 2.5 compiled with libpng. Support for SBIX fonts requires FreeType 2.5.1 compiled with libpng. Support for COLR fonts requires FreeType 2.10. SVG fonts are not yet supported.
Two new methods .ImageDraw.textlength and .FreeTypeFont.getlength were added, returning the exact advance length of text with 1/64 pixel precision.
These can be used for word-wrapping or rendering text in parts.
Three new methods .ImageDraw.textbbox, .ImageDraw.multiline_textbbox, and .FreeTypeFont.getbbox return the bounding box of rendered text.
These functions accept an anchor parameter, see text-anchors for details.
The ellipse-drawing algorithm has been changed from drawing a 360-sided polygon to one which resembles Bresenham's algorithm for circles. It should be faster and produce smoother curves, especially for smaller ellipses.
Fixed multiple issues in methods .ImageDraw.text and .ImageDraw.multiline_text sometimes causing unexpected text alignment issues.
The align parameter of .ImageDraw.multiline_text now gives better results in some cases.
TrueType fonts with embedded bitmaps are now supported.
When saving EXIF data, Pillow is now able to write subIFDs, such as the GPS IFD. This should happen automatically when saving an image using the EXIF data that it was opened with, such as in ~PIL.ImageOps.exif_transpose.
Previously, the code of the first tag of the subIFD was incorrectly written as the offset.
Previously, if a BMP file was too large, an OSError would be raised. Now, DecompressionBombError is used instead, as Pillow already uses for other formats.
The https://pillow.readthedocs.io documentation will use a dark theme if the user has requested the system use one. Uses the prefers-color-scheme CSS media query.
https://pillow.readthedocs.io/en/stable/releasenotes/7.2.0.html
https://pillow.readthedocs.io/en/stable/releasenotes/7.2.0.html
Do not convert I;16 images when showing PNGs #4744 [radarhere]
Fixed ICNS file pointer saving #4741 [radarhere]
Fixed loading non-RGBA mode APNGs with dispose background #4742 [radarhere]
Deprecated _showxv #4714 [radarhere]
Deprecate Image.show(command="...") #4646 [nulano, hugovk, radarhere]
Updated JPEG magic number #4707 [Cykooz, radarhere]
Change STRIPBYTECOUNTS to LONG if necessary when saving #4626 [radarhere, hugovk]
Write JFIF header when saving JPEG #4639 [radarhere]
Replaced tiff_jpeg with jpeg compression when saving TIFF images #4627 [radarhere]
Writing TIFF tags: improved BYTE, added UNDEFINED #4605 [radarhere]
Consider transparency when pasting text on an RGBA image #4566 [radarhere]
Added method argument to single frame WebP saving #4547 [radarhere]
Use ImageFileDirectory_v2 in Image.Exif #4637 [radarhere]
Corrected reading EXIF metadata without prefix #4677 [radarhere]
Fixed drawing a jointed line with a sequence of numeric values #4580 [radarhere]
Added support for 1-D NumPy arrays #4608 [radarhere]
Parse orientation from XMP tags #4560 [radarhere]
Speed up text layout by not rendering glyphs #4652 [nulano]
Fixed ZeroDivisionError in Image.thumbnail #4625 [radarhere]
Replaced TiffImagePlugin DEBUG with logging #4550 [radarhere]
Fix repeatedly loading .gbr #4620 [ElinksFr, radarhere]
JPEG: Truncate icclist instead of setting to None #4613 [homm]
Fixes default offset for Exif #4594 [rodrigob, radarhere]
Fixed bug when unpickling TIFF images #4565 [radarhere]
Fix pickling WebP #4561 [hugovk, radarhere]
Replace IOError and WindowsError aliases with OSError #4536 [hugovk, radarhere]
TiffImagePlugin.DEBUG = True has been a way to print various debugging information when interacting with TIFF images. This has now been removed in favour of Python's logging module, already used in other places in the Pillow source code.
Previously, the default offset argument for ~PIL.Image.Exif.tobytes was 0, which did not include the magic header. It is now 8.
Moved from the legacy PIL.TiffImagePlugin.ImageFileDirectory_v1 to PIL.TiffImagePlugin.ImageFileDirectory_v2 in PIL.Image.Exif. This means that Exif RATIONALs and SIGNED_RATIONALs are now read as PIL.TiffImagePlugin.IFDRational, instead of as a tuple with a numerator and a denominator.
TIFF BYTE tags were previously read as a tuple containing a bytestring. They are now read as just a single bytestring.
The command parameter was deprecated and will be removed in a future release. Use a subclass of PIL.ImageShow.Viewer instead.
Image._showxv has been deprecated. Use ~PIL.Image.Image.show instead. If custom behaviour is required, use ~PIL.ImageShow.register to add a custom ~PIL.ImageShow.Viewer class.
IOError was merged into OSError in Python 3.3. So, ImageFile.raise_ioerror is now deprecated and will be removed in a future release. Use ImageFile.raise_oserror instead.
https://pillow.readthedocs.io/en/stable/releasenotes/7.1.2.html
https://pillow.readthedocs.io/en/stable/releasenotes/7.1.2.html
Raise an EOFError when seeking too far in PNG #4528 [radarhere]
This fixes a regression introduced in 7.1.0 when adding support for APNG files.
When calling seek(n) on a regular PNG where n > 0, it failed to raise an EOFError as it should have done, resulting in:
AttributeError: 'NoneType' object has no attribute 'read'
Pillow 7.1.2 now raises the correct exception.
https://pillow.readthedocs.io/en/stable/releasenotes/7.1.1.html
https://pillow.readthedocs.io/en/stable/releasenotes/7.1.1.html
Fix regression seeking and telling PNGs #4512 #4514 [hugovk, radarhere]
This fixes a regression introduced in 7.1.0 when adding support for APNG files when calling seek and tell:
>>> from PIL import Image
>>> with Image.open("Tests/images/hopper.png") as im:
... im.seek(0)
...
Traceback (most recent call last):
File "<stdin>", line 2, in <module>
File "/Library/Frameworks/Python.framework/Versions/3.8/lib/python3.8/site-packages/PIL/PngImagePlugin.py", line 739, in seek
if not self._seek_check(frame):
File "/Library/Frameworks/Python.framework/Versions/3.8/lib/python3.8/site-packages/PIL/ImageFile.py", line 306, in _seek_check
return self.tell() != frame
File "/Library/Frameworks/Python.framework/Versions/3.8/lib/python3.8/site-packages/PIL/PngImagePlugin.py", line 827, in tell
return self.__frame
AttributeError: 'PngImageFile' object has no attribute '_PngImageFile__frame'
>>>
https://pillow.readthedocs.io/en/stable/releasenotes/7.1.0.html
https://pillow.readthedocs.io/en/stable/releasenotes/7.1.0.html
Fix multiple OOB reads in FLI decoding #4503 [wiredfool]
Fix buffer overflow in SGI-RLE decoding #4504 [wiredfool, hugovk]
Fix bounds overflow in JPEG 2000 decoding #4505 [wiredfool]
Fix bounds overflow in PCX decoding #4506 [wiredfool]
Fix 2 buffer overflows in TIFF decoding #4507 [wiredfool]
Add APNG support #4243 [pmrowla, radarhere, hugovk]
ImageGrab.grab() for Linux with XCB #4260 [nulano, radarhere]
Added three new channel operations #4230 [dwastberg, radarhere]
Prevent masking of Image reduce method in Jpeg2KImagePlugin #4474 [radarhere, homm]
Added reading of earlier ImageMagick PNG EXIF data #4471 [radarhere]
Fixed endian handling for I;16 getextrema #4457 [radarhere]
Release buffer if function returns prematurely #4381 [radarhere]
Add JPEG comment to info dictionary #4455 [radarhere]
Fix size calculation of Image.thumbnail() #4404 [orlnub123]
Fixed stroke on FreeType < 2.9 #4401 [radarhere]
If present, only use alpha channel for bounding box #4454 [radarhere]
Warn if an unknown feature is passed to features.check() #4438 [jdufresne]
Fix Name field length when saving IM images #4424 [hugovk, radarhere]
Allow saving of zero quality JPEG images #4440 [radarhere]
Allow explicit zero width to hide outline #4334 [radarhere]
Change ContainerIO return type to match file object mode #4297 [jdufresne, radarhere]
Only draw each polygon pixel once #4333 [radarhere]
Add support for shooting situation Exif IFD tags #4398 [alexagv]
Handle multiple and malformed JPEG APP13 markers #4370 [homm]
Depends: Update libwebp to 1.1.0 #4342, libjpeg to 9d #4352 [radarhere]
This release includes many security fixes.
Pillow before 7.1.0 has multiple out-of-bounds reads in libImaging/FliDecode.c.
In libImaging/PcxDecode.c in Pillow before 7.1.0, an out-of-bounds read can occur when reading PCX files where state->shuffle is instructed to read beyond state->buffer.
In Pillow before 7.1.0, there are two buffer overflows in libImaging/TiffDecode.c.
In libImaging/Jpeg2KDecode.c in Pillow before 7.1.0, there are multiple out-of-bounds reads via a crafted JP2 file.
In libImaging/SgiRleDecode.c in Pillow through 7.0.0, a number of out-of-bounds reads exist in the parsing of SGI image files, a different issue than 2020-5311.
If no quality was specified when saving a JPEG, Pillow internally used a value of zero to indicate that the default quality should be used. However, this removed the ability to actually save a JPEG with zero quality. This has now been resolved.
from PIL import Image
im = Image.open("hopper.jpg")
im.save("out.jpg", quality=0)
Three new channel operations have been added: ~PIL.ImageChops.soft_light, ~PIL.ImageChops.hard_light and ~PIL.ImageChops.overlay.
PILLOW_VERSION has been re-added but is deprecated and will be removed in a future release. Use __version__ instead.
It was initially removed in Pillow 7.0.0, but brought back in 7.1.0 to give projects more time to upgrade.
When opening a JPEG image, the comment may now be read into ~PIL.Image.Image.info.
Previously PcfFontFile output only bitmap PIL fonts with ISO 8859-1 encoding, even though the PCF format supports Unicode, making it hard to work with Pillow with bitmap fonts in languages which use different character sets.
Now it's possible to set a different charset encoding in PcfFontFile's class constructor. By default, it generates a PIL font file with ISO 8859-1 as before. The generated PIL font file still contains up to 256 characters, but the character set is different depending on the selected encoding.
To use such a font with ImageDraw.text, call it with a bytes object with the same encoding as the font file.
Support has been added for ImageGrab.grab() on Linux using the X server with the XCB library.
An optional xdisplay parameter has been added to select the X server, with the default value of None using the default X server.
Passing a different value on Windows or macOS will force taking a snapshot using the selected X server; pass an empty string to use the default X server. XCB support is not included in pre-compiled wheels for Windows and macOS.
When the ~PIL.Image.Image.getbbox method calculates the bounding box, for an RGB image it trims black pixels. Similarly, for an RGBA image it would trim black transparent pixels. This is now changed so that if an image has an alpha channel (RGBA, RGBa, PA, LA, La), any transparent pixels are trimmed.
Added support for reading and writing Animated Portable Network Graphics (APNG) images. The PNG plugin now supports using the ~PIL.Image.Image.seek method and the ~PIL.ImageSequence.Iterator class to read APNG frame sequences. The PNG plugin also now supports using the append_images argument to write APNG frame sequences. See apng-sequences for further details.
https://pillow.readthedocs.io/en/stable/releasenotes/7.0.0.html
https://pillow.readthedocs.io/en/stable/releasenotes/7.0.0.html
Drop support for EOL Python 2.7 #4109 [hugovk, radarhere, jdufresne]
Fix rounding error on RGB to L conversion #4320 [homm]
Exif writing fixes: Rational boundaries and signed/unsigned types #3980 [kkopachev, radarhere]
Allow loading of WMF images at a given DPI #4311 [radarhere]
Added reduce operation #4251 [homm]
Raise ValueError for io.StringIO in Image.open #4302 [radarhere, hugovk]
Fix thumbnail geometry when DCT scaling is used #4231 [homm, radarhere]
Use default DPI when exif provides invalid x_resolution #4147 [beipang2, radarhere]
Change default resize resampling filter from NEAREST to BICUBIC #4255 [homm]
Fixed black lines on upscaled images with the BOX filter #4278 [homm]
Better thumbnail aspect ratio preservation #4256 [homm]
Add La mode packing and unpacking #4248 [homm]
Include tests in coverage reports #4173 [hugovk]
Handle broken Photoshop data #4239 [radarhere]
Raise a specific exception if no data is found for an MPO frame #4240 [radarhere]
Fix Unicode support for PyPy #4145 [nulano]
Added UnidentifiedImageError #4182 [radarhere, hugovk]
Remove deprecated __version__ from plugins #4197 [hugovk, radarhere]
Fixed freeing unallocated pointer when resizing with height too large #4116 [radarhere]
Copy info in Image.transform #4128 [radarhere]
Corrected DdsImagePlugin setting info gamma #4171 [radarhere]
Depends: Update libtiff to 4.1.0 #4195, Tk Tcl to 8.6.10 #4229, libimagequant to 2.12.6 #4318 [radarhere]
Improve handling of file resources #3577 [jdufresne]
Removed CI testing of Fedora 29 #4165 [hugovk]
Added pypy3 to tox envlist #4137 [jdufresne]
Drop support for EOL PyQt4 and PySide #4108 [hugovk, radarhere]
Removed deprecated setting of TIFF image sizes #4114 [radarhere]
Removed deprecated PILLOW_VERSION #4107 [hugovk]
Changed default frombuffer raw decoder args #1730 [radarhere]
Pillow has dropped support for Python 2.7, which reached end-of-life on 2020-01-01.
PILLOW_VERSION has been removed. Use __version__ instead.
The version constants of individual plugins have been removed. Use PIL.__version__ instead.
Removed |
Removed |
Removed |
|---|---|---|
BmpImagePlugin.__version__ |
Jpeg2KImagePlugin.__version__ |
PngImagePlugin.__version__ |
CurImagePlugin.__version__ |
JpegImagePlugin.__version__ |
PpmImagePlugin.__version__ |
DcxImagePlugin.__version__ |
McIdasImagePlugin.__version__ |
PsdImagePlugin.__version__ |
EpsImagePlugin.__version__ |
MicImagePlugin.__version__ |
SgiImagePlugin.__version__ |
FliImagePlugin.__version__ |
MpegImagePlugin.__version__ |
SunImagePlugin.__version__ |
FpxImagePlugin.__version__ |
MpoImagePlugin.__version__ |
TgaImagePlugin.__version__ |
GdImageFile.__version__ |
MspImagePlugin.__version__ |
TiffImagePlugin.__version__ |
GifImagePlugin.__version__ |
PalmImagePlugin.__version__ |
WmfImagePlugin.__version__ |
IcoImagePlugin.__version__ |
PcdImagePlugin.__version__ |
XbmImagePlugin.__version__ |
ImImagePlugin.__version__ |
PcxImagePlugin.__version__ |
XpmImagePlugin.__version__ |
ImtImagePlugin.__version__ |
PdfImagePlugin.__version__ |
XVThumbImagePlugin.__version__ |
IptcImagePlugin.__version__ |
PixarImagePlugin.__version__ |
Qt 4 reached end-of-life on 2015-12-19. Its Python bindings are also EOL: PyQt4 since 2018-08-31 and PySide since 2015-10-14.
Support for PyQt4 and PySide has been removed from ImageQt. Please upgrade to PyQt5 or PySide2.
Setting the size of a TIFF image directly (eg. im.size = (256, 256)) throws an error. Use Image.resize instead.
The default resampling filter has been changed to the high-quality convolution Image.BICUBIC instead of Image.NEAREST, for the ~PIL.Image.Image.resize method and the ~PIL.ImageOps.pad, ~PIL.ImageOps.scale and ~PIL.ImageOps.fit functions. Image.NEAREST is still always used for images in "P" and "1" modes. See concept-filters to learn the difference. In short, Image.NEAREST is a very fast filter, but simple and low-quality.
If the ~PIL.Image.Image.draft method has no effect, it returns None. If it does have an effect, then it previously returned the image itself. However, unlike other chain methods, ~PIL.Image.Image.draft does not return a modified version of the image, but modifies it in-place. So instead, if ~PIL.Image.Image.draft has an effect, Pillow will now return a tuple of the image mode and a co-ordinate box. The box is the original coordinates in the bounds of resulting image. This may be useful in a subsequent ~PIL.Image.Image.resize call.
Pillow will now throw a custom UnidentifiedImageError when an image cannot be identified. For backwards compatibility, this will inherit from OSError.
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, the result is indistinguishable from fair resampling.
The default value for ~PIL.Image.Image.resize is None, which means that the optimization is turned off by default.
The default value for ~PIL.Image.Image.thumbnail is 2.0, which is very close to fair resampling while still being faster in many cases. In addition, the same gap is applied when ~PIL.Image.Image.thumbnail calls ~PIL.Image.Image.draft, which may greatly improve the quality of JPEG thumbnails. As a result, ~PIL.Image.Image.thumbnail in the new version provides equally high speed and high quality from any source (JPEG or arbitrary images).
~PIL.Image.Image.reduce is a highly efficient operation to reduce an image by integer times. Normally, it shouldn't be used directly. Used internally by ~PIL.Image.Image.resize and ~PIL.Image.Image.thumbnail methods to speed up resize when a new argument reducing_gap is set.
On Windows, Pillow can read WMF files, with a default DPI of 72. An image can now also be loaded at another resolution:
from PIL import Image
with Image.open("drawing.wmf") as im:
im.load(dpi=144)
Implicitly closing the image's underlying file in Image.__del__ has been removed. Use a context manager or call ~PIL.Image.Image.close instead to close the file in a deterministic way.
Previous method:
im = Image.open("hopper.png")
im.save("out.jpg")
Use instead:
with Image.open("hopper.png") as im:
im.save("out.jpg")
When calculating the new dimensions in ~PIL.Image.Image.thumbnail, round to the nearest integer, instead of always rounding down. This better preserves the original aspect ratio.
When the image width or height is not divisible by 8 the last row and column in the image get the correct weight after JPEG DCT scaling.
https://pillow.readthedocs.io/en/stable/releasenotes/6.2.2.html
https://pillow.readthedocs.io/en/stable/releasenotes/6.2.2.html
This is the last Pillow release to support Python 2.7 #3642
Overflow checks for realloc for tiff decoding. CVE-2020-5310 [wiredfool, radarhere]
Catch SGI buffer overrun. CVE-2020-5311 [radarhere]
Catch PCX P mode buffer overrun. CVE-2020-5312 [radarhere]
Catch FLI buffer overrun. CVE-2020-5313 [radarhere]
Raise an error for an invalid number of bands in FPX image. CVE-2019-19911 [wiredfool, radarhere]
This release fixes several buffer overflow issues and a DOS attack vulnerability.
Overflow checks have been added when calculating the size of a memory block to be reallocated in the processing of TIFF, SGI, PCX and FLI images.
If an FPX image reports that it has a large number of bands, a large amount of resources will be used when trying to process the image. This is fixed by limiting the number of bands to those usable by Pillow.
https://pillow.readthedocs.io/en/stable/releasenotes/6.2.1.html
https://pillow.readthedocs.io/en/stable/releasenotes/6.2.1.html
Python 2.7 reaches end-of-life on 2020-01-01.
Pillow 7.0.0 will be released on 2020-01-01 and will drop support for Python 2.7, making Pillow 6.2.x the last release series to support Python 2.
Pillow 6.2.1 supports Python 3.8.
https://pillow.readthedocs.io/en/stable/releasenotes/6.2.0.html
https://pillow.readthedocs.io/en/stable/releasenotes/6.2.0.html
Catch buffer overruns #4104 [radarhere]
Initialize rows_per_strip when RowsPerStrip tag is missing #4034 [cgohlke, radarhere]
Raise error if TIFF dimension is a string #4103 [radarhere]
Added decompression bomb checks #4102 [radarhere]
Fix ImageGrab.grab DPI scaling on Windows 10 version 1607+ #4000 [nulano, radarhere]
Corrected negative seeks #4101 [radarhere]
Added argument to capture all screens on Windows #3950 [nulano, radarhere]
Updated warning to specify when Image.frombuffer defaults will change #4086 [radarhere]
Changed WindowsViewer format to PNG #4080 [radarhere]
Use TIFF orientation #4063 [radarhere]
Raise the same error if a truncated image is loaded a second time #3965 [radarhere]
Lazily use ImageFileDirectory_v1 values from Exif #4031 [radarhere]
Improved HSV conversion #4004 [radarhere]
Added text stroking #3978 [radarhere, hugovk]
No more deprecated bdist_wininst .exe installers #4029 [hugovk]
Do not allow floodfill to extend into negative coordinates #4017 [radarhere]
Fixed arc drawing bug for a non-whole number of degrees #4014 [radarhere]
Fix bug when merging identical images to GIF with a list of durations #4003 [djy0, radarhere]
Fix bug in TIFF loading of BufferedReader #3998 [chadawagner]
Added fallback for finding ld on MinGW Cygwin #4019 [radarhere]
Remove indirect dependencies from requirements.txt #3976 [hugovk]
Depends: Update libwebp to 1.0.3 #3983, libimagequant to 2.12.5 #3993, freetype to 2.10.1 #3991 [radarhere]
Change overflow check to use PY_SSIZE_T_MAX #3964 [radarhere]
Report reason for pytest skips #3942 [hugovk]
This release catches several buffer overruns and fixes 2019-16865.
In RawDecode.c, an error is now thrown if skip is calculated to be less than zero. It is intended to skip padding between lines, not to go backwards.
In PsdImagePlugin, if the combined sizes of the individual parts is larger than the declared size of the extra data field, then it looked for the next layer by seeking backwards. This is now corrected by seeking to (the start of the layer + the size of the extra data field) instead of (the read parts of the layer + the rest of the layer).
Decompression bomb checks have been added to GIF and ICO formats.
An error is now raised if a TIFF dimension is a string, rather than trying to perform operations on it.
The CVE is regarding DOS problems, such as consuming large amounts of memory, or taking a large amount of time to process an image.
To allow for lazy loading of Exif data, Image.getexif() now returns a shared instance of Image.Exif.
There has been a longstanding warning that the defaults of Image.frombuffer may change in the future for the "raw" decoder. The change will now take place in Pillow 7.0.
stroke_width and stroke_fill arguments have been added to text drawing operations. They allow text to be outlined, setting the width of the stroke and and the color respectively. If not provided, stroke_fill will default to the fill parameter.
from PIL import Image, ImageDraw, ImageFont
font = ImageFont.truetype("Tests/fonts/FreeMono.ttf", 40)
font.getsize_multiline("A", stroke_width=2)
font.getsize("ABC\nAaaa", stroke_width=2)
im = Image.new("RGB", (100, 100))
draw = ImageDraw.Draw(im)
draw.textsize("A", font, stroke_width=2)
draw.multiline_textsize("ABC\nAaaa", font, stroke_width=2)
draw.text((10, 10), "A", "#f00", font, stroke_width=2, stroke_fill="#0f0")
draw.multiline_text((10, 10), "A\nB", "#f00", font,
stroke_width=2, stroke_fill="#0f0")
For example,
from PIL import Image, ImageDraw, ImageFont
im = Image.new("RGB", (120, 130))
draw = ImageDraw.Draw(im)
font = ImageFont.truetype("Tests/fonts/FreeMono.ttf", 120)
draw.text((10, 10), "A", "#f00", font, stroke_width=2, stroke_fill="#0f0")
creates the following image:
An all_screens argument has been added to ImageGrab.grab. If True, all monitors will be included in the created image.
.exe installers fell out of favour with 527, and will be deprecated in Python 3.8. Pillow will no longer be distributing them. Wheels should be used instead.
When building libwebp for inclusion in wheels, Pillow now adds the -O3 and -DNDEBUG CFLAGS. These flags would be used by default if building libwebp without debugging, and using them fixes a significant decrease in speed when a wheel-installed copy of Pillow performs libwebp operations.
https://pillow.readthedocs.io/en/stable/releasenotes/6.1.0.html
https://pillow.readthedocs.io/en/stable/releasenotes/6.1.0.html
Deprecate Image.__del__ #3929 [jdufresne]
Tiff: Add support for JPEG quality #3886 [olt]
Respect the PKG_CONFIG environment variable when building #3928 [chewi]
Use explicit memcpy() to avoid unaligned memory accesses #3225 [DerDakon]
Improve encoding of TIFF tags #3861 [olt]
Update Py_UNICODE to Py_UCS4 #3780 [nulano]
Consider I;16 pixel size when drawing #3899 [radarhere]
Add TIFFTAG_SAMPLEFORMAT to blocklist #3926 [cgohlke, radarhere]
Create GIF deltas from background colour of GIF frames if disposal mode is 2 #3708 [sircinnamon, radarhere]
Added ImageSequence all_frames #3778 [radarhere]
Use unsigned int to store TIFF IFD offsets #3923 [cgohlke]
Include CPPFLAGS when searching for libraries #3819 [jefferyto]
Updated TIFF tile descriptors to match current decoding functionality #3795 [dmnisson]
Added an image.entropy() method (second revision) #3608 [fish2000]
Pass the correct types to PyArg_ParseTuple #3880 [QuLogic]
Fixed crash when loading non-font bytes #3912 [radarhere]
Fix SPARC memory alignment issues in Pack/Unpack functions #3858 [kulikjak]
Added CMYK;16B and CMYK;16N unpackers #3913 [radarhere]
Fixed bugs in calculating text size #3864 [radarhere]
Add __main__.py to output basic format and support information #3870 [jdufresne]
Added variation font support #3802 [radarhere]
Do not down-convert if image is LA when showing with PNG format #3869 [radarhere]
Improve handling of PSD frames #3759 [radarhere]
Improved ICO and ICNS loading #3897 [radarhere]
Changed Preview application path so that it is no longer static #3896 [radarhere]
Corrected ttb text positioning #3856 [radarhere]
Handle unexpected ICO image sizes #3836 [radarhere]
Fixed bits value for RGB;16N unpackers #3837 [kkopachev]
Travis CI: Add Fedora 30, remove Fedora 28 #3821 [hugovk]
Added reading of CMYK;16L TIFF images #3817 [radarhere]
Fixed dimensions of 1-bit PDFs #3827 [radarhere]
Fixed opening mmap image through Path on Windows #3825 [radarhere]
Fixed ImageDraw arc gaps #3824 [radarhere]
Expand GIF to include frames with extents outside the image size #3822 [radarhere]
Fixed ImageTk getimage #3814 [radarhere]
Fixed bug in decoding large images #3791 [radarhere]
Fixed reading APP13 marker without Photoshop data #3771 [radarhere]
Added option to include layered windows in ImageGrab.grab on Windows #3808 [radarhere]
Detect libimagequant when installed by pacman on MingW #3812 [radarhere]
Fixed raqm layout bug #3787 [radarhere]
Fixed loading font with non-Unicode path on Windows #3785 [radarhere]
Travis CI: Upgrade PyPy from 6.0.0 to 7.1.1 #3783 [hugovk, johnthagen]
Depends: Updated openjpeg to 2.3.1 #3794, raqm to 0.7.0 #3877, libimagequant to 2.12.3 #3889 [radarhere]
Fix numpy bool bug #3790 [radarhere]
Implicitly closing the image's underlying file in Image.__del__ has been deprecated. Use a context manager or call Image.close() instead to close the file in a deterministic way.
Deprecated:
im = Image.open("hopper.png")
im.save("out.jpg")
Use instead:
with Image.open("hopper.png") as im:
im.save("out.jpg")
Calculates and returns the entropy for the image. A bilevel image (mode "1") is treated as a grayscale ("L") image by this method. If a mask is provided, the method employs the histogram for those parts of the image where the mask image is non-zero. The mask image must have the same size as the image, and be either a bi-level image (mode "1") or a grayscale image ("L").
An optional include_layered_windows parameter has been added to ImageGrab.grab, defaulting to False. If true, layered windows will be included in the resulting image on Windows.
A new method to facilitate applying a given function to all frames in an image, or to all frames in a list of images. The frames are returned as a list of separate images. For example, ImageSequence.all_frames(im, lambda im_frame: im_frame.rotate(90)) could be used to return all frames from an image, each rotated 90 degrees.
Variation fonts are now supported, allowing for different styles from the same font file. ImageFont.FreeTypeFont has four new methods, PIL.ImageFont.FreeTypeFont.get_variation_names and PIL.ImageFont.FreeTypeFont.set_variation_by_name for using named styles, and PIL.ImageFont.FreeTypeFont.get_variation_axes and PIL.ImageFont.FreeTypeFont.set_variation_by_axes for using font axes instead. An IOError will be raised if the font is not a variation font. FreeType 2.9.1 or greater is required.
This function is now supported. It returns the contents of an ImageTk.PhotoImage as an RGBA Image.Image instance.
The TIFF encoder accepts a quality parameter for jpeg compressed TIFF files. A value from 0 (worst) to 100 (best) controls the image quality, similar to the JPEG encoder. The default is 75. For example:
im.save("out.tif", compression="jpeg", quality=85)
The TIFF encoder supports more types, especially arrays. This is required for the GeoTIFF format which encodes geospatial information.
Pass tagtype from v2 directory to libtiff encoder, instead of autodetecting type.
Use explicit types eg. uint32_t for TIFF_LONG to fix issues on platforms with 64-bit longs.
Add support for multiple values (arrays). Requires type in v2 directory and values must be passed as a tuple.
Add support for signed types eg. TIFFTypes.TIFF_SIGNED_SHORT.
This variable is commonly used by other build systems and using it can help with cross-compiling. Falls back to pkg-config as before.
Drawing text in the 'ttb' direction with ImageFont has been significantly improved and requires Raqm 0.7 or greater.
Added warnings to deprecated CMSProfile attributes #3615 [hugovk]
Python 2.7 support will be removed in Pillow 7.0.0 #3682 [hugovk]
Add EXIF class #3625 [radarhere]
Add ImageOps exif_transpose method #3687 [radarhere]
Added warnings to deprecated CMSProfile attributes #3615 [hugovk]
Documented reading TIFF multiframe images #3720 [akuchling]
Improved speed of opening an MPO file #3658 [Glandos]
Update palette in quantize #3721 [radarhere]
Improvements to TIFF is_animated and n_frames #3714 [radarhere]
Fixed incompatible pointer type warnings #3754 [radarhere]
Improvements to PA and LA conversion and palette operations #3728 [radarhere]
Consistent DPI rounding #3709 [radarhere]
Change size of MPO image to match frame #3588 [radarhere]
Read Photoshop resolution data #3701 [radarhere]
Ensure image is mutable before saving #3724 [radarhere]
Correct remap_palette documentation #3740 [radarhere]
Promote P images to PA in putalpha #3726 [radarhere]
Allow RGB and RGBA values for new P images #3719 [radarhere]
Fixed TIFF bug when seeking backwards and then forwards #3713 [radarhere]
Cache EXIF information #3498 [Glandos]
Added transparency for all PNG grayscale modes #3744 [radarhere]
Fix deprecation warnings in Python 3.8 #3749 [radarhere]
Fixed GIF bug when rewinding to a non-zero frame #3716 [radarhere]
Only close original fp in __del__ and __exit__ if original fp is exclusive #3683 [radarhere]
Fix BytesWarning in Tests/test_numpy.py #3725 [jdufresne]
Add missing MIME types and extensions #3520 [pirate486743186]
Add I;16 PNG save #3566 [radarhere]
Add support for BMP RGBA bitfield compression #3705 [radarhere]
Added ability to set language for text rendering #3693 [iwsfutcmd]
Only close exclusive fp on Image __exit__ #3698 [radarhere]
Changed EPS subprocess stdout from devnull to None #3635 [radarhere]
Add reading old-JPEG compressed TIFFs #3489 [kkopachev]
Add EXIF support for PNG #3674 [radarhere]
Add option to set dither param on quantize #3699 [glasnt]
Add reading of DDS uncompressed RGB data #3673 [radarhere]
Correct length of Tiff BYTE tags #3672 [radarhere]
Add DIB saving and loading through Image open #3691 [radarhere]
Removed deprecated VERSION #3624 [hugovk]
Fix 'BytesWarning: Comparison between bytes and string' in PdfDict #3580 [jdufresne]
Do not resize in Image.thumbnail if already the destination size #3632 [radarhere]
Replace .seek() magic numbers with io.SEEK_* constants #3572 [jdufresne]
Make ContainerIO.isatty() return a bool, not int #3568 [jdufresne]
Add support to all transpose operations for I;16 modes #3563, #3741 [radarhere]
Deprecate support for PyQt4 and PySide #3655 [hugovk, radarhere]
Add TIFF compression codecs: LZMA, Zstd, WebP #3555 [cgohlke]
Fixed pickling of iTXt class with protocol > 1 #3537 [radarhere]
_util.isPath returns True for pathlib.Path objects #3616 [wbadart]
Remove unnecessary unittest.main() boilerplate from test files #3631 [jdufresne]
Exif: Seek to IFD offset #3584 [radarhere]
Deprecate PIL.*ImagePlugin.__version__ attributes #3628 [jdufresne]
Docs: Add note about ImageDraw operations that exceed image bounds #3620 [radarhere]
Allow for unknown PNG chunks after image data #3558 [radarhere]
Changed EPS subprocess stdin from devnull to None #3611 [radarhere]
Fix possible integer overflow #3609 [cgohlke]
Catch BaseException for resource cleanup handlers #3574 [jdufresne]
Improve pytest configuration to allow specific tests as CLI args #3579 [jdufresne]
Drop support for Python 3.4 #3596 [hugovk]
Remove deprecated PIL.OleFileIO #3598 [hugovk]
Remove deprecated ImageOps undocumented functions #3599 [hugovk]
Depends: Update libwebp to 1.0.2 #3602 [radarhere]
Detect MIME types #3525 [radarhere]
Python 3.4 is EOL since 2019-03-16 and no longer supported. We will not be creating binaries, testing, or retaining compatibility with this version. The final version of Pillow for Python 3.4 is 5.4.1.
PIL.OleFileIO was removed as a vendored file and in Pillow 4.0.0 (2017-01) in favour of the upstream olefile Python package, and replaced with an ImportError. The deprecated file has now been removed from Pillow. If needed, install from PyPI (eg. python3 -m pip install olefile).
Several undocumented functions in ImageOps were deprecated in Pillow 4.3.0 (2017-10) and have now been removed: gaussian_blur, gblur, unsharp_mask, usm and box_blur. Use the equivalent operations in ImageFilter instead.
VERSION (the old PIL version, always 1.1.7) has been removed. Use __version__ instead.
Python 2.7 reaches end-of-life on 2020-01-01.
Pillow 7.0.0 will be released on 2020-01-01 and will drop support for Python 2.7, making Pillow 6.x the last series to support Python 2.
Qt 4 reached end-of-life on 2015-12-19. Its Python bindings are also EOL: PyQt4 since 2018-08-31 and PySide since 2015-10-14.
Support for PyQt4 and PySide has been deprecated from ImageQt and will be removed in a future version. Please upgrade to PyQt5 or PySide2.
These version constants have been deprecated and will be removed in a future version.
BmpImagePlugin.__version__
CurImagePlugin.__version__
DcxImagePlugin.__version__
EpsImagePlugin.__version__
FliImagePlugin.__version__
FpxImagePlugin.__version__
GdImageFile.__version__
GifImagePlugin.__version__
IcoImagePlugin.__version__
ImImagePlugin.__version__
ImtImagePlugin.__version__
IptcImagePlugin.__version__
Jpeg2KImagePlugin.__version__
JpegImagePlugin.__version__
McIdasImagePlugin.__version__
MicImagePlugin.__version__
MpegImagePlugin.__version__
MpoImagePlugin.__version__
MspImagePlugin.__version__
PalmImagePlugin.__version__
PcdImagePlugin.__version__
PcxImagePlugin.__version__
PdfImagePlugin.__version__
PixarImagePlugin.__version__
PngImagePlugin.__version__
PpmImagePlugin.__version__
PsdImagePlugin.__version__
SgiImagePlugin.__version__
SunImagePlugin.__version__
TgaImagePlugin.__version__
TiffImagePlugin.__version__
WmfImagePlugin.__version__
XbmImagePlugin.__version__
XpmImagePlugin.__version__
XVThumbImagePlugin.__version__
Use PIL.__version__ instead.
Some attributes in ImageCms.CmsProfile have been deprecated since Pillow 3.2.0. From 6.0.0, they issue a DeprecationWarning:
Deprecated |
Use instead |
|---|---|
color_space |
Padded xcolor_space |
pcs |
Padded connection_space |
product_copyright |
Unicode copyright |
product_desc |
Unicode profile_description |
product_description |
Unicode profile_description |
product_manufacturer |
Unicode manufacturer |
product_model |
Unicode model |
Previously, all JPEG2000 images had the MIME type "image/jpx". This has now been corrected. After the file format drivers have been loaded, Image.MIME["JPEG2000"] will return "image/jp2". ImageFile.get_format_mimetype will return "image/jpx" if a JPX profile is present, or "image/jp2" otherwise.
Previously, all SGI images had the MIME type "image/rgb". This has now been corrected. After the file format drivers have been loaded, Image.MIME["SGI"] will return "image/sgi". ImageFile.get_format_mimetype will return "image/rgb" if RGB image data is present, or "image/sgi" otherwise.
MIME types have been added to the PPM format. After the file format drivers have been loaded, Image.MIME["PPM"] will now return the generic "image/x-portable-anymap". ImageFile.get_format_mimetype will return a MIME type specific to the color type.
The TGA, PCX and ICO formats also now have MIME types: "image/x-tga", "image/x-pcx" and "image/x-icon" respectively.
Pillow now supports reading and writing the Device Independent Bitmap file format.
The dither option is now a customisable parameter (was previously hardcoded to 1). This parameter takes the same values used in ~PIL.Image.Image.convert.
These text-rendering functions now accept a language parameter to request language-specific glyphs and ligatures from the font:
ImageDraw.ImageDraw.multiline_text()
ImageDraw.ImageDraw.multiline_textsize()
ImageDraw.ImageDraw.text()
ImageDraw.ImageDraw.textsize()
ImageFont.ImageFont.getmask()
ImageFont.ImageFont.getsize_multiline()
ImageFont.ImageFont.getsize()
~PIL.Image.Image.getexif has been added, which returns an ~PIL.Image.Exif instance. Values can be retrieved and set like a dictionary. When saving JPEG, PNG or WEBP, the instance can be passed as an exif argument to include any changes in the output image.
~PIL.ImageOps.exif_transpose returns a copy of an image, transposed according to its EXIF Orientation tag.
EXIF data can now be read from and saved to PNG images. However, unlike other image formats, EXIF data is not guaranteed to be present in ~PIL.Image.Image.info until ~PIL.Image.Image.load has been called.
Pillow can now read uncompressed RGB data from DDS images.
Added support reading TIFF files with old-style JPEG compression through LibTIFF. All YCbCr TIFF images are now always read as RGB.
Support has been added for the LZMA, Zstd and WebP TIFF compression codecs.
I;16, I;16L and I;16B are now supported image modes for all ~PIL.Image.Image.transpose operations.
File closing: Only close __fp if not fp #3540 [radarhere]
File closing: Only close __fp if not fp #3540 [radarhere]
Fix build for Termux #3529 [pslacerda]
PNG: Detect MIME types #3525 [radarhere]
PNG: Handle IDAT chunks after image end #3532 [radarhere]
This release fixes regressions in 5.4.0.
A change to the way Pillow detects libraries during installed prevented installation on Termux, which does not have /sbin/ldconfig. This is now fixed.
Some PNG images have multiple IDAT chunks. In some cases, Pillow will stop reading image data before the IDAT chunks finish. A regression caused an EOFError exception when previously there was none. This is now fixed, and file reading continues in case there are subsequent text chunks.
The addition of limited APNG support to the PNG plugin also overwrote the MIME type for PNG files, causing "image/apng" to be returned as the MIME type of both APNG and PNG files. This has been fixed so the MIME type of PNG files is "image/png".
A regression caused an unsupported image file to report a ValueError: seek of closed file exception instead of an OSError. This has been fixed by ensuring that image plugins only close their internal __fp if they are not the same as ImageFile's fp, allowing each to manage their own file pointers.
Docs: Add page of deprecations and removals #3486 [hugovk]
Docs: Improved ImageChops documentation #3522 [radarhere]
Allow RGB and RGBA values for P image putpixel #3519 [radarhere]
Add APNG extension to PNG plugin #3501 [pirate486743186, radarhere]
Lookup ld.so.cache instead of hardcoding search paths #3245 [pslacerda]
Added custom string TIFF tags #3513 [radarhere]
Improve setup.py configuration #3395 [diorcety]
Read textual chunks located after IDAT chunks for PNG #3506 [radarhere]
Performance: Don't try to hash value if enum is empty #3503 [Glandos]
Added custom int and float TIFF tags #3350 [radarhere]
Fixes for issues reported by static code analysis #3393 [frenzymadness]
GIF: Wait until mode is normalized to copy im.info into encoderinfo #3187 [radarhere]
Docs: Add page of deprecations and removals #3486 [hugovk]
Travis CI: Upgrade PyPy from 5.8.0 to 6.0 #3488 [hugovk]
Travis CI: Allow lint job to fail #3467 [hugovk]
Resolve __fp when closing and deleting #3261 [radarhere]
Close exclusive fp before discarding #3461 [radarhere]
Updated open files documentation #3490 [radarhere]
Added libjpeg_turbo to check_feature #3493 [radarhere]
Change color table index background to tuple when saving as WebP #3471 [radarhere]
Allow arbitrary number of comment extension subblocks #3479 [radarhere]
Ensure previous FLI frame is loaded before seeking to the next #3478 [radarhere]
ImageShow improvements #3450 [radarhere]
Depends: Update libimagequant to 2.12.2 #3442, libtiff to 4.0.10 #3458, libwebp to 1.0.1 #3468, Tk Tcl to 8.6.9 #3465 [radarhere]
Check quality_layers type #3464 [radarhere]
Add context manager, __del__ and close methods to TarIO #3455 [radarhere]
Test: Do not play sound when running screencapture command #3454 [radarhere]
Close exclusive fp on open exception #3456 [radarhere]
Only close existing fp in WebP if fp is exclusive #3418 [radarhere]
Docs: Re-add the downloads badge #3443 [hugovk]
Added negative index to PixelAccess #3406 [Nazime]
Change tuple background to global color table index when saving as GIF #3385 [radarhere]
Test: Improved ImageGrab tests #3424 [radarhere]
Flake8 fixes #3422, #3440 [radarhere, hugovk]
Only ask for YCbCr->RGB libtiff conversion for jpeg-compressed tiffs #3417 [kkopachev]
Optimise ImageOps.fit by combining resize and crop #3409 [homm]
Animated Portable Network Graphics (APNG) images are not fully supported but can be opened via the PNG plugin to get some basic info:
im = Image.open("image.apng")
print(im.mode) # "RGBA"
print(im.size) # (245, 245)
im.show() # Shows a single frame
You can check if Pillow has been built against the libjpeg-turbo version of the libjpeg library:
from PIL import features
features.check_feature("libjpeg_turbo") # True or False
When accessing individual image pixels, negative indexes are now also accepted. For example, to get or set the farthest pixel in the lower right of an image:
px = im.load() print(px[-1, -1]) px[-1, -1] = (0, 0, 0)
TIFF images can now be saved with custom integer, float and string TIFF tags:
im = Image.new("RGB", (200, 100))
custom = {
37000: 4,
37001: 4.2,
37002: "custom tag value",
37003: u"custom tag value",
37004: b"custom tag value",
}
im.save("output.tif", tiffinfo=custom)
im2 = Image.open("output.tif")
print(im2.tag_v2[37000]) # 4
print(im2.tag_v2[37002]) # "custom tag value"
print(im2.tag_v2[37004]) # b"custom tag value"
Now uses one resize operation with box parameter internally instead of a crop and scale operations sequence. This improves the performance and accuracy of cropping since the box parameter accepts float values.
Nothing published for this version
Avoid deprecated 'U' mode when opening files #2187 [jdufresne]
Changed Image size property to be read-only by default #3203 [radarhere]
Add warnings if image file identification fails due to lack of WebP support #3169 [radarhere, hugovk]
Hide the Ghostscript progress dialog popup on Windows #3378 [hugovk]
Adding support to reading tiled and YcbCr jpeg tiffs through libtiff #3227 [kkopachev]
Fixed None as TIFF compression argument #3310 [radarhere]
Changed GIF seek to remove previous info items #3324 [radarhere]
Improved PDF document info #3274 [radarhere]
Add line width parameter to rectangle and ellipse-based shapes #3094 [hugovk, radarhere]
Fixed decompression bomb check in _crop #3313 [dinkolubina, hugovk]
Added support to ImageDraw.floodfill for non-RGB colors #3377 [radarhere]
Tests: Avoid catching unexpected exceptions in tests #2203 [jdufresne]
Use TextIOWrapper.detach() instead of NoCloseStream #2214 [jdufresne]
Added transparency to matrix conversion #3205 [radarhere]
Added ImageOps pad method #3364 [radarhere]
Give correct extrema for I;16 format images #3359 [bz2]
Added PySide2 #3279 [radarhere]
Corrected TIFF tags #3369 [radarhere]
CI: Install CFFI and pycparser without any PYTHONOPTIMIZE #3374 [hugovk]
Read/Save RGB webp as RGB (instead of RGBX) #3298 [kkopachev]
ImageDraw: Add line joints #3250 [radarhere]
Improved performance of ImageDraw floodfill method #3294 [yo1995]
Fix builds with --parallel #3272 [hsoft]
Add more raw Tiff modes (RGBaX, RGBaXX, RGBAX, RGBAXX) #3335 [homm]
Close existing WebP fp before setting new fp #3341 [radarhere]
Add orientation, compression and id_section as TGA save keyword arguments #3327 [radarhere]
Convert int values of RATIONAL TIFF tags to floats #3338 [radarhere, wiredfool]
Fix code for PYTHONOPTIMIZE #3233 [hugovk]
Changed ImageFilter.Kernel to subclass ImageFilter.BuiltinFilter, instead of the other way around #3273 [radarhere]
Remove unused draw.draw_line, draw.draw_point and font.getabc methods #3232 [hugovk]
Tests: Added ImageFilter tests #3295 [radarhere]
Tests: Added ImageChops tests #3230 [hugovk, radarhere]
AppVeyor: Download lib if not present in pillow-depends #3316 [radarhere]
Travis CI: Add Python 3.7 and Xenial #3234 [hugovk]
Docs: Added documentation for NumPy conversion #3301 [radarhere]
Depends: Update libimagequant to 2.12.1 #3281 [radarhere]
Add three-color support to ImageOps.colorize #3242 [tsennott]
Tests: Add LA to TGA test modes #3222 [danpla]
Skip outline if the draw operation fills with the same colour #2922 [radarhere]
Flake8 fixes #3173, #3380 [radarhere]
Avoid deprecated 'U' mode when opening files #2187 [jdufresne]
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.
An optional line width parameter has been added to ImageDraw.Draw.arc, chord, ellipse, pieslice and rectangle.
ImageDraw.Draw.line draws a line, or lines, between points. Previously, when multiple points are given, for a larger width, the joints between these lines looked unsightly. There is now an additional optional argument, joint, defaulting to None. When it is set to curved, the joints between the lines will become rounded.
Previously ImageOps.colorize only supported two-color mapping with black and white arguments being mapped to 0 and 255 respectively. Now it supports three-color mapping with the optional mid parameter, and the positions for all three color arguments can each be optionally specified (blackpoint, whitepoint and midpoint). For example, with all optional arguments:
ImageOps.colorize(im, black=(32, 37, 79), white='white', mid=(59, 101, 175),
blackpoint=15, whitepoint=240, midpoint=100)
While ImageOps.fit allows users to crop images to a requested aspect ratio 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 image within the new area through a centering argument.
Added support for reading tiled TIFF images through LibTIFF. Compressed TIFF images are now read through LibTIFF.
RGB WebP images are now read as RGB mode, rather than RGBX.
Fix collections ABCs DeprecationWarning in Python 3.7 #3123 [hugovk]
Fixed saving a multiframe image as a single frame PDF #3137 [radarhere]
If a Qt version is already imported, attempt to use it first #3143 [radarhere]
Fix transform fill color for alpha images #3147 [fozcode]
TGA: Add support for writing RLE data #3186 [danpla]
TGA: Read and write LA data #3178 [danpla]
QuantOctree.c: Remove erroneous attempt to average over an empty range #3196 [tkoeppe]
Changed ICNS format tests to pass on OS X 10.11 #3202 [radarhere]
Fixed bug in ImageDraw.multiline_textsize() #3114 [tianyu139]
Added getsize_multiline support for PIL.ImageFont #3113 [tianyu139]
Added ImageFile get_format_mimetype method #3190 [radarhere]
Changed mmap file pointer to use context manager #3216 [radarhere]
Changed ellipse point calculations to be more evenly distributed #3142 [radarhere]
Only extract first Exif segment #2946 [hugovk]
Tests: Test ImageDraw2, WalImageFile #3135, #2989 [hugovk]
Remove unnecessary '#if 0' code #3075 [hugovk]
Tests: Added GD tests #1817 [radarhere]
Fix collections ABCs DeprecationWarning in Python 3.7 #3123 [hugovk]
unpack_from is faster than unpack of slice #3201 [landfillbaby]
Docs: Add coordinate system links and file handling links in documentation #3204, #3214 [radarhere]
Tests: TestFilePng: Fix test_save_l_transparency() #3182 [danpla]
Docs: Correct argument name #3171 [radarhere]
Docs: Update CMake download URL #3166 [radarhere]
Docs: Improve Image.transform documentation #3164 [radarhere]
Fix transform fillcolor argument when image mode is RGBA or LA #3163 [radarhere]
Tests: More specific Exception testing #3158 [radarhere]
Add getrgb HSB/HSV color strings #3148 [radarhere]
Allow float values in getrgb HSL color string #3146 [radarhere]
AppVeyor: Upgrade to Python 2.7.15 and 3.4.4 #3140 [radarhere]
AppVeyor: Upgrade to PyPy 6.0.0 #3133 [hugovk]
Deprecate PILLOW_VERSION and VERSION #3090 [hugovk]
Support Python 3.7 #3076 [hugovk]
Depends: Update freetype to 2.9.1, libjpeg to 9c, libwebp to 1.0.0 #3121, #3136, #3108 [radarhere]
Build macOS wheels with Xcode 6.4, supporting older macOS versions #3068 [wiredfool]
Fix _i2f compilation on some GCC versions #3067 [homm]
Changed encoderinfo to have priority over info when saving GIF images #3086 [radarhere]
Rename PIL.version to PIL._version and remove it from module #3083 [homm]
Enable background colour parameter on rotate #3057 [storesource]
Remove unnecessary #if 1 directive #3072 [jdufresne]
Remove unused Python class, Path #3070 [jdufresne]
Fix dereferencing type-punned pointer will break strict-aliasing #3069 [jdufresne]
These version constants have been deprecated. VERSION will be removed in Pillow 6.0.0, and PILLOW_VERSION will be removed after that.
PIL.VERSION (old PIL version 1.1.7)
PIL.PILLOW_VERSION
PIL.Image.VERSION
PIL.Image.PILLOW_VERSION
Use PIL.__version__ instead.
Support for 3D color lookup table transformations has been added.
Color3DLUT.generate transforms 3-channel pixels using the values of the channels as coordinates in the 3D lookup table and interpolating the nearest elements.
It allows you to apply almost any color transformation in constant time by using pre-calculated decimated tables.
Color3DLUT.transform() allows altering table values with a callback.
If NumPy is installed, the performance of argument conversion is dramatically improved when a source table supports buffer interface (NumPy && arrays in Python >= 3).
Previously Image.rotate only supported HSL color strings. Now HSB and HSV strings are also supported, as well as float values. For example, ImageColor.getrgb("hsv(180,100%,99.5%)").
ImageFile.get_format_mimetype has been added to return the MIME type of an image file, where available. For example, Image.open("hopper.jpg").get_format_mimetype() returns "image/jpeg".
A new method to return the size of multiline text, for example font.getsize_multiline("ABC\nAaaa")
A new named parameter, fillcolor, has been added to Image.rotate. This color specifies the background color to use in the area outside the rotated image. This parameter takes the same color specifications as used in Image.new.
Pillow can now read and write LA data (in addition to L, P, RGB and RGBA), and write RLE data (in addition to uncompressed).
Pillow 5.2 supports Python 3.7.
The macOS wheels for Pillow 5.1.0 were built with Xcode 9.2, meaning 10.12 Sierra was the lowest supported version.
Prior to Pillow 5.1.0, Xcode 8 was used, supporting El Capitan 10.11.
Instead, Pillow 5.2.0 is built with the oldest available Xcode 6.4 to support at least 10.10 Yosemite.
For example, this allows compilation with GCC 4.8 on NetBSD.
Re: "version constants deprecated" listed above, as user gnbl notes in #3082:
it's confusing that PIL.VERSION returns the version string of the former PIL instead of Pillow's
ReadTheDocs documentation is missing for some version branches (why is this, will it ever change, ...)
it's confusing that PIL.version is a module and does not return the version information directly or hints on how to get it
the package information header is essentially useless (placeholder, does not even mention Pillow, nor the version)
PIL._version module documentation comment could explain how to access the version information
We have attempted to resolve these issues in #3083, #3090 and #3218.
Close fp before return in ImagingSavePPM #3061 [kathryndavies]
Close fp before return in ImagingSavePPM #3061 [kathryndavies]
Added documentation for ICNS append_images #3051 [radarhere]
Docs: Move intro text below its header #3021 [hugovk]
CI: Rename appveyor.yml as .appveyor.yml #2978 [hugovk]
Fix TypeError for JPEG2000 parser feed #3042 [hugovk]
Certain corrupted jpegs can result in no data read #3023 [kkopachev]
Add support for BLP file format #3007 [jleclanche]
Simplify version checks #2998 [hugovk]
Fix "invalid escape sequence" warning on Python 3.6+ #2996 [timgraham]
Allow append_images to set .icns scaled images #3005 [radarhere]
Support appending to existing PDFs #2965 [vashek]
Fix and improve efficient saving of ICNS on macOS #3004 [radarhere]
Build: Enable pip cache in AppVeyor build #3009 [thijstriemstra]
Trim trailing whitespace #2985 [Metallicow]
Docs: Correct reference to Image.new method #3000 [radarhere]
Rearrange ImageFilter classes into alphabetical order #2990 [radarhere]
Test: Remove duplicate line #2983 [radarhere]
Build: Update AppVeyor PyPy version #3003 [radarhere]
Tiff: Open 8 bit Tiffs with 5 or 6 channels, discarding extra channels #2938 [homm]
Readme: Added Twitter badge #2930 [hugovk]
Removed __main__ code from ImageCms #2942 [radarhere]
Test: Changed assert statements to unittest calls #2961 [radarhere]
Depends: Update libimagequant to 2.11.10, raqm to 0.5.0, freetype to 2.9 #3036, #3017, #2957 [radarhere]
Remove _imaging.crc32 in favor of builtin Python crc32 implementation #2935 [wiredfool]
Move Tk directory to src directory #2928 [hugovk]
Enable pip cache in Travis CI #2933 [jdufresne]
Remove unused and duplicate imports #2927 [radarhere]
Docs: Changed documentation references to 2.x to 2.7 #2921 [radarhere]
Fix memory leak when opening webp files #2974 [wiredfool]
Setup: Fix "TypeError: 'NoneType' object is not iterable" for PPC and CRUX #2951 [hugovk]
Setup: Add libdirs for ppc64le and armv7l #2968 [nehaljwani]
Pillow can now open TIFF files with base modes of RGB, YCbCr, and CMYK with up to 6 8-bit channels, discarding any extra channels if the content is tagged as UNSPECIFIED. Pillow still does not store more than 4 8-bit channels of image data.
Images can now be appended to PDF files in place by passing in append=True when saving the image.
Pillow now supports reading the BLP "Blizzard Mipmap" file format used for tiles in Blizzard's engine.
A memory leak when opening WebP files has been fixed.
Setup: Replace deprecated platform.dist with file existence check #2869 [wiredfool]
Docs: Added docstrings from documentation #2914 [radarhere]
Test: Switch from nose to pytest #2815 [hugovk]
Rework Source directory layout, preventing accidental import of PIL. #2911 [wiredfool]
Dynamically link libraqm #2753 [wiredfool]
Removed scripts directory #2901 [wiredfool]
TIFF: Run all compressed tiffs through libtiff decoder #2899 [wiredfool]
GIF: Add disposal option when saving GIFs #2902 [linnil1, wiredfool]
EPS: Allow for an empty line in EPS header data #2903 [radarhere]
PNG: Add support for sRGB and cHRM chunks, permit sRGB when no iCCP chunk present #2898 [wiredfool]
Dependencies: Update Tk Tcl to 8.6.8 #2905 [radarhere]
Decompression bomb error now raised for images 2x larger than a decompression bomb warning #2583 [wiredfool]
Test: avoid random failure in test_effect_noise #2894 [hugovk]
Increased epsilon for test_file_eps.py:test_showpage due to Arch update. #2896 [wiredfool]
Removed check parameter from _save in BmpImagePlugin, PngImagePlugin, ImImagePlugin, PalmImagePlugin, and PcxImagePlugin. #2873 [radarhere]
Make PngImagePlugin.add_text() zip argument type bool #2890 [jdufresne]
Depends: Updated libwebp to 0.6.1 #2880 [radarhere]
Remove unnecessary bool() calls in Image.registered_extensions and skipKnownBadTests #2891 [jdufresne]
Fix count of BITSPERSAMPLE items in broken TIFF files #2883 [homm]
Fillcolor parameter for Image.Transform #2852 [wiredfool]
Test: Display differences for test failures #2862 [wiredfool]
Added executable flag to file with shebang line #2884 [radarhere]
Setup: Specify compatible Python versions for pip #2877 [hugovk]
Dependencies: Updated libimagequant to 2.11.4 #2878 [radarhere]
Setup: Warn if trying to install for Py3.7 on Windows #2855 [hugovk]
Doc: Fonts can be loaded from a file-like object, not just filename #2861 [robin-norwood]
Add eog support for Ubuntu Image Viewer #2864 [NafisFaysal]
Test: Test on 3.7-dev on Travis CI #2870 [hugovk]
Dependencies: Update libtiff to 4.0.9 #2871 [radarhere]
Setup: Replace deprecated platform.dist with file existence check #2869 [wiredfool]
Build: Fix setup.py on Debian #2853 [wiredfool]
Docs: Correct error in ImageDraw documentation #2858 [meribold]
Test: Drop Ubuntu Precise, Fedora 24, Fedora 25, add Fedora 27, Centos 7, Amazon v2 CI Support #2854, #2843, #2895, #2897 [wiredfool]
Dependencies: Updated libimagequant to 2.11.3 #2849 [radarhere]
Test: Fix test_image.py to use tempfile #2841 [radarhere]
Replace PIL.OleFileIO deprecation warning with descriptive ImportError #2833 [hugovk]
WebP: Add support for animated WebP files #2761 [jd20]
PDF: Set encoderinfo for images when saving multi-page PDF. Fixes #2804. #2805 [ixio]
Allow the olefile dependency to be optional #2789 [jdufresne]
GIF: Permit LZW code lengths up to 12 bits in GIF decode #2813 [wiredfool]
Fix unterminated string and unchecked exception in _font_text_asBytes. #2825 [wiredfool]
PPM: Use fixed list of whitespace, rather relying on locale, fixes #272. #2831 [markmiscavage]
Added support for generators when using append_images #2829, #2835 [radarhere]
Doc: Correct PixelAccess.rst #2824 [hasahmed]
Depends: Update raqm to 0.3.0 #2822 [radarhere]
Docs: Link to maintained version of aggdraw #2809 [hugovk]
Include license file in the generated wheel packages #2801 [jdufresne]
Depends: Update openjpeg to 2.3.0 #2791 [radarhere]
Add option to Makefile to build and install with C coverage #2781 [hugovk]
Add context manager support to ImageFile.Parser and PngImagePlugin.ChunkStream #2793 [radarhere]
ImageDraw.textsize: fix zero length error #2788 [wiredfool, hugovk]
Python 3.3 is EOL and no longer supported due to moving testing from nose, which is deprecated, to pytest, which doesn't support Python 3.3. We will not be creating binaries, testing, or retaining compatibility with this version. The final version of Pillow for Python 3.3 is 4.3.0.
Pillow has previously emitted warnings for images that are unexpectedly large and may be a denial of service. These warnings are now upgraded to DecompressionBombErrors for images that are twice the size of images that trigger the DecompressionBombWarning. The default threshold is 128Mpx, or 0.5GB for an RGB or RGBA image. This can be disabled or changed by setting Image.MAX_IMAGE_PIXELS = None.
The scripts formerly installed by Pillow have been split into a separate package, pillow-scripts, living at https://github.com/python-pillow/pillow-scripts.
The olefile module is no longer a required dependency when installing Pillow. Support for plugins requiring olefile will not be loaded if it is not installed. This allows library consumers to avoid installing this dependency if they choose. Some library consumers have little interest in the format support and would like to keep dependencies to a minimum.
Further, the vendored version was removed in Pillow 4.0.0 and replaced with a deprecation warning that PIL.OleFileIO would be removed in a future version. This warning has been upgraded to an import error pending future removal.
Several image plugins supported a named check parameter on their nominally private _save method to preflight if the image could be saved in that format. That parameter has been removed.
A new named parameter, fillcolor, has been added to Image.transform. This color specifies the background color to use in the area outside the transformed area in the output image. This parameter takes the same color specifications as used in Image.new.
Multiframe GIF images now take an optional disposal parameter to specify the disposal option for changed pixels.
Previously, there were some compression modes (JPEG, Packbits, and LZW) that were supported with Pillow's internal TIFF decoder. All compressed TIFFs are now read using the libtiff decoder, as it implements the compression schemes more correctly.
The libraqm dependency for complex text scripts is now linked dynamically at runtime rather than at packaging time. This allows us to release binaries with support for libraqm if it is installed on the user's machine.
The Pillow source is now stored within the src directory of the distribution. This prevents accidental imports of the PIL directory when running Python from the project directory.
Multiarch support on Linux should be more robust, especially on Debian derivatives on ARM platforms. Debian's multiarch platform configuration is run in preference to the sniffing of machine platform and architecture.
Deprecate ImageOps undocumented functions gaussian_blur, gblur, unsharp_mask, usm and box_blur in favor of ImageFilter implementations #2735 [homm]
Fix warning on pointer cast in isblock #2775, #2778 [cgohlke]
Doc: Added macOS High Sierra tested Pillow version #2777 [radarhere]
Use correct Windows handle type on 64 bit in imagingcms #2774 [cgohlke]
64 Bit Windows fix for block storage #2773 [cgohlke]
Fix "expression result unused" warning #2764 [radarhere]
Add 16bit Read/Write and RLE read support to SgiImageFile #2769 [jbltx, wiredfool]
Block & array hybrid storage #2738 [homm]
Common seek frame position check #1849 [radarhere]
Doc: Add note about aspect ratio to Image thumbnail script #2281 [wilsonge]
Fix ValueError: invalid version number '1.0.0rc1' in scipy release candidate #2771 [cgohlke]
Unfreeze requirements.txt #2766 [hugovk]
Test: ResourceWarning tests #2756 [hugovk]
Use n_frames to determine is_animated if possible #2315 [radarhere]
Doc: Corrected parameters in documentation #2768 [radarhere]
Avoid unnecessary Image operations #1891 [radarhere]
Added register_extensions method #1860 [radarhere]
Fix TIFF support for I;16S, I;16BS, and I;32BS rawmodes #2748 [wiredfool]
Fixed doc syntax in ImageDraw #2752 [radarhere]
Fixed support for building on Windows/msys2. Added Appveyor CI coverage for python3 on msys2 #2746 [wiredfool]
Fix ValueError in Exif/Tiff IFD #2719 [wiredfool]
Use pathlib2 for Path objects on Python < 3.4 #2291 [asergi]
Export only required properties in unsafe_ptrs #2740 [homm]
Alpha composite fixes #2709 [homm]
Faster Transpose operations, added 'Transverse' option #2730 [homm]
Deprecate ImageOps undocumented functions gaussian_blur, gblur, unsharp_mask, usm and box_blur in favor of ImageFilter implementations #2735 [homm]
Dependencies: Updated freetype to 2.8.1 #2741 [radarhere]
Bug: Player skipped first image #2742 [radarhere]
Faster filter operations for Kernel, Gaussian, and Unsharp Mask filters #2679 [homm]
EPS: Add showpage to force rendering of some EPS images #2636 [kaplun]
DOC: Fix type of palette parameter in Image.quantize. #2703 [kkopachev]
DOC: Fix Ico docs to match code #2712 [hugovk]
Added file pointer save to SpiderImagePlugin #2647 [radarhere]
Add targa version 2 footer #2713 [jhultgre]
Removed redundant lines #2714 [radarhere]
Travis CI: Use default pypy/pypy3 #2721 [hugovk]
Fix for SystemError when rendering an empty string, added in 4.2.0 #2706 [wiredfool]
Fix for memory leaks in font handling added in 4.2.0 #2634 [wiredfool]
Tests: cleanup, more tests. Fixed WMF save handler #2689 [radarhere]
Removed debugging interface for Image.core.grabclipboard #2708 [radarhere]
Doc syntax fix #2710 [radarhere]
Faster packing and unpacking for RGB, LA, and related storage modes #2693 [homm]
Use RGBX rawmode for RGB JPEG images where possible #1989 [homm]
Remove palettes from non-palette modes in _new #2704 [wiredfool]
Delete transparency info when convert'ing RGB/L to RGBA #2633 [olt]
Code tweaks to ease type annotations #2687 [neiljp]
Fixed incorrect use of 's#' to byteslike object #2691 [wiredfool]
Fix JPEG subsampling labels for subsampling=2 #2698 [homm]
Region of interest (box) for resampling #2254 [homm]
Basic support for Termux (android) in setup.py #2684 [wiredfool]
Bug: Fix Image.fromarray for numpy.bool type. #2683 [wiredfool]
CI: Add Fedora 24 and 26 to Docker tests [wiredfool]
JPEG: Fix ZeroDivisionError when EXIF contains invalid DPI (0/0). #2667 [vytisb]
Depends: Updated openjpeg to 2.2.0 #2669 [radarhere]
Depends: Updated Tk Tcl to 8.6.7 #2668 [radarhere]
Depends: Updated libimagequant to 2.10.2 #2660 [radarhere]
Test: Added test for ImImagePlugin tell() #2675 [radarhere]
Test: Additional tests for SGIImagePlugin #2659 [radarhere]
New Image.getchannel method #2661 [homm]
Remove unused im.copy2 and core.copy methods #2657 [homm]
Fast Image.merge() #2677 [homm]
Fast Image.split() #2676 [homm]
Fast image allocation #2655 [homm]
Storage cleanup #2654 [homm]
FLI: Use frame count from FLI header #2674 [radarhere]
Test: Test animated FLI file #2650 [hugovk]
Bug: Fixed uninitialized memory in bc5 decoding #2648 [ifeherva]
Moved SgiImagePlugin save error to before the start of write operations #2646 [radarhere]
Move createfontdatachunk.py so isn't installed globally #2645 [hugovk]
Bug: Fix unexpected keyword argument 'align' #2641 [hugovk]
Add newlines to error message for clarity #2640 [hugovk]
Docs: Updated redirected URL #2637 [radarhere]
Bug: Fix JPEG DPI when EXIF is invalid #2632 [wiredfool]
Bug: Fix for font getsize on empty string #2624 [radarhere]
Docs: Improved ImageDraw documentation #2626 [radarhere]
Docs: Corrected alpha_composite args documentation #2627 [radarhere]
Docs: added the description of the filename attribute to images.rst #2621 [dasdachs]
Dependencies: Updated libimagequant to 2.10.1 #2616 [radarhere]
PDF: Renamed parameter to not shadow built-in dict #2612 [kijeong]
Several undocumented functions in ImageOps have been deprecated: gaussian_blur, gblur, unsharp_mask, usm and box_blur. Use the equivalent operations in ImageFilter instead. These functions will be removed in a future release.
TIFF tags with unknown type/quantity now default to being bare values if they are 1 element, where previously they would be a single element tuple. This is only with the new api, not the legacy api. This normalizes the handling of fields, so that the metadata with inferred or image specified counts are handled the same as metadata with count specified in the TIFF spec.
The PhotoshopInfo, XMP, and JPEGTables tags now have a defined type (bytes) and a count of 1.
The ImageJMetaDataByteCounts tag now has an arbitrary number of items, as there can be multiple items, one for UTF-8, and one for UTF-16.
These are internal functions that should not have been used by user code, but they were accessible from the python layer.
Debugging code within Image.core.grabclipboard was removed. It had been marked as will be removed in future versions since PIL. When enabled, it identified the format of the clipboard data.
The PIL.Image.core.copy and PIL.Image.Image.im.copy2 methods have been removed.
The PIL.Image.core.getcount methods have been removed, use PIL.Image.core.get_stats()['new_count'] property instead.
A new method PIL.Image.Image.getchannel has been added to return a single channel by index or name. For example, image.getchannel("A") will return alpha channel as separate image. getchannel should work up to 6 times faster than image.split()[0] in previous Pillow versions.
A new filter, PIL.ImageFilter.BoxBlur, has been added. This is a filter with similar results to a Gaussian blur, but is much faster.
Added new argument box for PIL.Image.Image.resize. This argument defines a source rectangle from within the source image to be resized. This is very similar to the image.crop(box).resize(size) sequence except that box can be specified with subpixel accuracy.
The Image.TRANSVERSE operation has been added to PIL.Image.Image.transpose. This is equivalent to a transpose operation about the opposite diagonal.
There is a new PIL.ImageFilter.MultibandFilter base class for image filters that can run on all channels of an image in one operation. The original PIL.ImageFilter.Filter class remains for image filters that can process only single band images, or require splitting of channels prior to filtering.
Pillow now can read 16-bit multichannel TIFF files including files with alpha transparency. The image data is truncated to 8-bit precision.
Pillow now can read 16-bit signed integer single channel TIFF files. The image data is promoted to 32-bit for storage and processing.
Pillow can now read and write uncompressed 16-bit multichannel SGI images to and from RGB and RGBA formats. The image data is truncated to 8-bit precision.
Pillow can now read RLE encoded SGI images in both 8 and 16-bit precision.
This release contains several performance improvements:
Many memory bandwidth-bounded operations such as crop, image allocation, conversion, split into bands and merging from bands are up to 2x faster.
Upscaling of multichannel images (such as RGB) is accelerated by 5-10%
JPEG loading is accelerated up to 15% and JPEG saving up to 20% when using a recent version of libjpeg-turbo.
Image.transpose has been accelerated 15% or more by using a cache friendly algorithm.
ImageFilters based on Kernel convolution are significantly faster due to the new ~PIL.ImageFilter.MultibandFilter feature.
All memory allocation for images is now done in blocks, rather than falling back to an allocation for each scan line for images larger than the block size.
The basic CMYK->RGB conversion has been tweaked to match the formula from Google Chrome. This produces an image that is generally lighter than the previous formula, and more in line with what color managed applications produce.
CI: Fix version specification and test on CI for PyPy/Windows #2608 [wiredfool]
CI: Fix version specification and test on CI for PyPy/Windows #2608 [wiredfool]
There are no functional changes in this release.
A change in the 4.2.0 cycle broke the Windows PyPy build. This has been fixed, and PyPy is now part of the Windows CI matrix.
Remove deprecated code #2549 [hugovk]
Doc: Clarified Image.save:append_images documentation #2604 [radarhere]
CI: Amazon Linux and Centos6 docker images added to Travis CI #2585 [wiredfool]
Image.alpha_composite added #2595 [wiredfool]
Complex Text Support #2576 [ShamsaHamed, Fahad-Alsaidi, wiredfool]
Added threshold parameter to ImageDraw.floodfill #2599 [nediamond]
Added dBATCH parameter to ghostscript command #2588 [radarhere]
JPEG: Adjust buffer size when icc_profile > MAXBLOCK #2596 [Darou]
Specify Pillow Version in one place #2517 [wiredfool]
CI: Change the owner of the TRAVIS_BUILD_DIR, fixing broken docker runs #2587 [wiredfool]
Fix truncated PNG loading for some images, Fix memory leak on truncated PNG images. #2541, #2598 [homm]
Add decompression bomb check to Image.crop #2410 [wiredfool]
ImageFile: Ensure that the err_code variable is initialized in case of exception. #2363 [alexkiro]
Tiff: Support append_images for saving multipage TIFFs #2406 [blochl]
Doc: Clarify that draft is only implemented for JPEG and PCD #2409 [wiredfool]
Test: MicImagePlugin #2447 [hugovk]
Use round() instead of floor() to eliminate zero coefficients in resample #2558 [homm]
Remove deprecated code #2549 [hugovk]
Added append_images to PDF saving #2526 [radarhere]
Remove unused function core image function new_array #2548 [hugovk]
Remove unnecessary calls to dict.keys() #2551 [jdufresne]
Add more ImageDraw.py tests and remove unused Draw.c code #2533 [hugovk]
Test: More tests for ImageMorph #2554 [hugovk]
Test: McIDAS area file #2552 [radarhere]
Update Feature Detection #2520 [wiredfool]
CI: Update pypy on Travis CI #2573 [hugovk]
ImageMorph: Fix wrong expected size of MRLs read from disk #2561 [dov]
Docs: Update install docs for FreeBSD #2546 [wiredfool]
Build: Ignore OpenJpeg 1.5 on FreeBSD #2544 [melvyn-sopacua]
Remove 'not yet implemented' methods from PIL 1.1.4 #2538 [hugovk]
Dependencies: Update FreeType to 2.8, LibTIFF to 4.0.8 and libimagequant to 2.9.1 #2535 #2537 #2540 [radarhere]
Raise TypeError and not also UnboundLocalError in ImageFile.Parser() #2525 [joshblum]
Test: Use Codecov for coverage #2528 [hugovk]
Use PNG for Image.show() #2527 [HinTak, wiredfool]
Remove WITH_DEBUG compilation flag #2522 [wiredfool]
Fix return value on parameter parse error in _webp.c #2521 [adw1n]
Set executable flag on scripts with shebang line #2295 [radarhere]
Flake8 #2460 [radarhere]
Doc: Release Process Changes #2516 [wiredfool]
CI: Added region for s3 deployment on appveyor #2515 [wiredfool]
Doc: Updated references to point to existing files #2507 [radarhere]
Return copy on Image crop if crop dimensions match the image #2471 [radarhere]
Test: Optimize CI speed #2464, #2466 [hugovk]
The methods PIL.ImageWin.Dib.fromstring, PIL.ImageWin.Dib.tostring and PIL.TiffImagePlugin.ImageFileDirectory_v2.as_dict have been removed.
Before Pillow 4.2.0, attempting to save an RGBA image as JPEG would discard the alpha channel. From Pillow 3.4.0, a deprecation warning was shown. From Pillow 4.2.0, the deprecation warning is removed and an IOError is raised.
The unused function Image.core.new_array was removed. This is an internal function that should not have been used by user code, but it was accessible from the python layer.
Pillow now supports complex text rendering for scripts requiring glyph composition and bidirectional flow. This optional feature adds three dependencies: harfbuzz, fribidi, and raqm. See the install documentation for further details. This feature is tested and works on Unix and Mac, but has not yet been built on Windows platforms.
PIL.ImageDraw.floodfill has a new optional parameter: threshold. This specifies a tolerance for the color to replace with the flood fill.
The TIFF and PDF image writers now support the append_images optional parameter for specifying additional images to create multipage outputs.
PIL.Image.Image.crop now may raise a DecompressionBomb warning if the crop region enlarges the image over the threshold specified by PIL.Image.MAX_IMAGE_PIXELS.
Undef PySlice_GetIndicesEx, see https://bugs.python.org/issue29943 #2493 [cgohlke]
Undef PySlice_GetIndicesEx, see https://bugs.python.org/issue29943 #2493 [cgohlke]
Fix for file with DPI in EXIF but not metadata, and XResolution is an int rather than tuple #2484 [hugovk]
Docs: Removed broken download counter badge #2487 [hugovk]
Docs: Fixed rst syntax error #2477 [thebjorn]
Some JPEG images don't contain DPI information in the image metadata, but do contain it in the EXIF data. A patch was added in 4.1.0 to read from the EXIF data, but it did not accept all possible types that could be included there. This fix adds the ability to read ints as well as rational values.
CPython 3.6.1 added a new symbol, PySlice_GetIndicesEx, which was not present in 3.6.0. This had the effect of causing binaries compiled on CPython 3.6.1 to not work on installations of C-Python 3.6.0. This fix undefines PySlice_GetIndicesEx if it exists to restore compatibility with both 3.6.0 and 3.6.1. See https://bugs.python.org/issue29943 for more details.
Removed use of spaces in TIFF kwargs names, deprecated in 2.7 #1390 [radarhere]
Close files after loading if possible #2330 [homm, wiredfool]
Fix Image Access to be reloadable when embedding the Python interpreter #2296 [wiredfool, cgohlke]
Fetch DPI from EXIF if not specified in JPEG header #2449, #2472 [hugovk]
Removed winbuild checksum verification #2468 [radarhere]
Git: Set ContainerIO test file as binary #2469 [cgohlke]
Remove superfluous import of FixTk #2455 [cgohlke)
Fix import of tkinter/Tkinter #2456 [cgohlke)
Pure Python Decoders, including Python decoder to fix for MSP images #1938 [wiredfool, hugovk]
Reorganized GifImagePlugin, fixes #2314. #2374 [radarhere, wiredfool]
Doc: Reordered operating systems in Compatibility Matrix #2436 [radarhere]
Test: Additional tests for BufrStub, Eps, Container, GribStub, IPTC, Wmf, XVThumb, ImageDraw, ImageMorph, ImageShow #2425 [radarhere]
Health fixes #2437 [radarhere]
Test: Correctness tests ContainerIO, XVThumbImagePlugin, BufrStubImagePlugin, GribStubImagePlugin, FitsStubImagePlugin, Hdf5StubImagePlugin, PixarImageFile, PsdImageFile #2443, #2442, #2441, #2440, #2431, #2430, #2428, #2427 [hugovk]
Remove unused imports #1822 [radarhere]
Replaced KeyError catch with dictionary get method #2424 [radarhere]
Test: Removed unrunnable code in test_image_toqimage #2415 [hugovk]
Removed use of spaces in TIFF kwargs names, deprecated in 2.7 #1390 [radarhere]
Removed deprecated ImageDraw setink, setfill, setfont methods #2220 [jdufresne]
Send unwanted subprocess output to /dev/null #2253 [jdufresne]
Fix division by zero when creating 0x0 image from numpy array #2419 [hugovk]
Test: Added matrix convert tests #2381 [hugovk]
Replaced broken URL to partners.adobe.com #2413 [radarhere]
Removed unused private functions in setup.py and build_dep.py #2414 [radarhere]
Test: Fixed Qt tests for QT5 and saving 1 bit PNG #2394 [wiredfool]
Test: docker builds for Arch and Debian Stretch #2394 [wiredfool]
Updated libwebp to 0.6.0 on appveyor #2395 [radarhere]
More explicit error message when saving to a file with invalid extension #2399 [ces42]
Docs: Update some http urls to https #2403 [hugovk]
Preserve aux/alpha channels when performing Imagecms transforms #2355 [gunjambi]
Test linear and radial gradient effects #2382 [hugovk]
Test ImageDraw.Outline and and ImageDraw.Shape #2389 [hugovk]
Added PySide to ImageQt documentation #2392 [radarhere]
BUG: Empty image mode no longer causes a crash #2380 [evalapply]
Exclude .travis and contents from manifest #2386 [radarhere]
Remove 'MIT-like' from license #2145 [wiredfool]
Tests: Add tests for several Image operations #2379 [radarhere]
PNG: Moved iCCP chunk before PLTE chunk when saving as PNG, restricted chunks known value/ordering #2347 [radarhere]
Default to inch-interpretation for missing ResolutionUnit in TiffImagePlugin #2365 [lambdafu]
Bug: Fixed segfault when using ImagingTk on pypy Issue #2376, #2359. [wiredfool]
Bug: Fixed Integer overflow using ImagingTk on 32 bit platforms #2359 [wiredfool, QuLogic]
Tests: Added docker images for testing alternate platforms. See also https://github.com/python-pillow/docker-images. #2368 [wiredfool]
Removed PIL 1.0 era TK readme that concerns Windows 95/NT #2360 [wiredfool]
Prevent nose -v printing docstrings #2369 [hugovk]
Replaced absolute PIL imports with relative imports #2349 [radarhere]
Added context managers for file handling #2307 [radarhere]
Expose registered file extensions in Image #2343 [iggomez, radarhere]
Make mode descriptor cache initialization thread-safe. #2351 [gunjambi]
Updated Windows test dependencies: Freetype 2.7.1, zlib 1.2.11 #2331, #2332, #2357 [radarhere]
Followed upstream pngquant packaging reorg to libimagquant #2354 [radarhere]
Fix invalid string escapes #2352 [hugovk]
Add test for crop operation with no argument #2333 [radarhere]
Several deprecated items have been removed.
Support for spaces in tiff kwargs in the parameters for 'x resolution', 'y resolution', 'resolution unit', and 'date time' has been removed. Underscores should be used instead.
The methods PIL.ImageDraw.ImageDraw.setink, PIL.ImageDraw.ImageDraw.setfill, and PIL.ImageDraw.ImageDraw.setfont have been removed.
The file handling when opening images has been overhauled. Previously, Pillow would attempt to close some, but not all image formats after loading the image data. Now, the following behavior is specified:
For images where an open file is passed in, it is the responsibility of the calling code to close the file.
For images where Pillow opens the file and the file is known to have only one frame, the file is closed after loading.
If the file has more than one frame, or if it can't be determined, then the file is left open to permit seeking to subsequent frames. It will be closed, eventually, in the close or __del__ methods.
If the image is memory mapped, then we can't close the mapping to the underlying file until we are done with the image. The mapping will be closed in the close or __del__ method.
The PIL.GifImagePlugin code has been refactored to fix the flow when saving images. There are two external changes that arise from this:
An PIL.ImagePalette.ImagePalette object is now accepted as a specified palette argument in PIL.Image.Image.save().
The image to be saved is no longer modified in place by any of the operations of the save function. Previously it was modified when optimizing the image palette.
This refactor fixed some bugs with palette handling when saving multiple frame GIFs.
The method PIL.Image.Image.remap_palette() has been added. This method was hoisted from the GifImagePlugin code used to optimize the palette.
There is now a decoder registry similar to the image plugin registries. Image plugins can register a decoder, and it will be called when the decoding is requested. This allows for the creation of pure Python decoders. While the Python decoders will not be as fast as their C based counterparts, they may be easier and quicker to develop or safer to run.
Many tests have been added, including correctness tests for image formats that have been previously untested.
We are now running automated tests in Docker containers against more Linux versions than are provided on Travis CI, which is currently Ubuntu 14.04 x64. This Pillow release is tested on 64-bit Alpine, Arch, Ubuntu 12.04 and 16.04, and 32-bit Debian Stretch and Ubuntu 14.04. This also covers a wider range of dependency versions than are provided on Travis natively.
Removed deprecated internal "stretch" method #2276 [homm]
Refactor out postprocessing hack to load_end in PcdImageFile [wiredfool]
Add center and translate option to Image.rotate. #2328 [lambdafu]
Test: Relax WMF test condition, fixes #2323. #2327 [wiredfool]
Allow 0 size images, Fixes #2259, Reverts to pre-3.4 behavior. #2262 [wiredfool]
SGI: Save uncompressed SGI/BW/RGB/RGBA files #2325 [jbltx]
Depends: Updated pngquant to 2.8.2 #2319 [radarhere]
Test: Added correctness tests for opening SGI images #2324 [wiredfool]
Allow passing a list or tuple of individual frame durations when saving a GIF #2298 [Xdynix]
Unified different GIF optimize conditions #2196 [radarhere]
Build: Refactor dependency installation #2305 [hugovk]
Test: Add python 3.6 to travis, tox #2304 [hugovk]
Test: Fix coveralls coverage for Python+C #2300 [hugovk]
Remove executable bit and shebang from OleFileIO.py #2308 [jwilk, radarhere]
PyPy: Buffer interface workaround #2294 [wiredfool]
Test: Switch to Ubuntu Trusty 14.04 on Travis CI #2294
Remove vendored version of olefile Python package in favor of upstream #2199 [jdufresne]
Updated comments to use print as a function #2234 [radarhere]
Set executable flag on selftest.py, setup.py and added shebang line #2282, #2277 [radarhere, homm]
Test: Increase epsilon for FreeType 2.7 as rendering is slightly different. #2286 [hugovk]
Test: Faster assert_image_similar #2279 [homm]
Removed deprecated internal "stretch" method #2276 [homm]
Removed the handles_eof flag in decode.c #2223 [wiredfool]
Tiff: Fix for writing Tiff to BytesIO using libtiff #2263 [wiredfool]
Doc: Design docs #2269 [wiredfool]
Test: Move tests requiring libtiff to test_file_libtiff #2273 [wiredfool]
Update Maxblock heuristic #2275 [wiredfool]
Fix for 2-bit palette corruption #2274 [pdknsk, wiredfool]
Tiff: Update info.icc_profile when using libtiff reader. #2193 [lambdafu]
Test: Fix bug in test_ifd_rational_save when libtiff is not available #2270 [ChristopherHogan]
ICO: Only save relevant sizes #2267 [hugovk]
ICO: Allow saving .ico files of 256x256 instead of 255x255 #2265 [hugovk]
Fix TIFFImagePlugin ICC color profile saving. #2087 [cskau]
Doc: Improved description of ImageOps.deform resample parameter #2256 [radarhere]
EMF: support negative bounding box coordinates #2249 [glexey]
Close file if opened in WalImageFile #2216 [radarhere]
Use Image._new() instead of _makeself() #2248 [homm]
SunImagePlugin fixes #2241 [wiredfool]
Use minimal scale for jpeg drafts #2240 [homm]
Updated dependency scripts to use FreeType 2.7, OpenJpeg 2.1.2, WebP 0.5.2 and Tcl/Tk 8.6.6 #2235, #2236, #2237, #2290, #2302 [radarhere]
Fix "invalid escape sequence" bytestring warnings in Python 3.6 #2186 [timgraham]
Removed support for Python 2.6 and Python 3.2 #2192 [jdufresne]
Setup: Raise custom exceptions when required/requested dependencies are not found #2213 [wiredfool]
Use a context manager in FontFile.save() to ensure file is always closed #2226 [jdufresne]
Fixed bug in saving to fp-objects in Python >= 3.4 #2227 [radarhere]
Use a context manager in ImageFont._load_pilfont() to ensure file is always closed #2232 [jdufresne]
Use generator expressions instead of list comprehension #2225 [jdufresne]
Close file after reading in ImagePalette.load() #2215 [jdufresne]
Changed behaviour of default box argument for paste method to match docs #2211 [radarhere]
Add support for another BMP bitfield #2221 [jmerdich]
Added missing top-level test __main__ #2222 [radarhere]
Replaced range(len()) #2197 [radarhere]
Fix for ImageQt Segfault, fixes #1370 #2182 [wiredfool]
Setup: Close file in setup.py after finished reading #2208 [jdufresne]
Setup: optionally use pkg-config (when present) to detect dependencies #2074 [garbas]
Search for tkinter first in builtins #2210 [matthew-brett]
Tests: Replace try/except/fail pattern with TestCase.assertRaises() #2200 [jdufresne]
Tests: Remove unused, open files at top level of tests #2188 [jdufresne]
Replace type() equality checks with isinstance #2184 [jdufresne]
Doc: Move ICO out of the list of read-only file formats #2180 [alexwlchan]
Doc: Fix formatting, too-short title underlines and malformed table #2175 [hugovk]
Fix BytesWarnings #2172 [jdufresne]
Use Integer division to eliminate deprecation warning. #2168 [mastermatt]
Doc: Update compatibility matrix [daavve, wiredfool]
Pillow 4.0 no longer supports Python 2.6 and 3.2. We will not be creating binaries, testing, or retaining compatibility with these releases. This release removes some workarounds for those Python releases, so the final working version of Pillow on 2.6 or 3.2 is 3.4.2.
Pillow 4.0 supports Python 3.6.
OleFileIO.py has been removed as a vendored file and is now installed from the upstream olefile PyPI package. All internal dependencies are redirected to the olefile package. Direct accesses to PIL.OlefileIO raises a deprecation warning, then patches the upstream olefile into sys.modules in its place.
It is now possible to save images in modes L, RGB, and RGBA to the uncompressed SGI image format.
Pillow 3.4.0 removed support for creating images with (0,0) size. This has been reenabled, restoring pre 3.4 behavior.
The handles_eof flag for decoding images has been removed, as there were no internal users of the flag. Anyone maintaining image decoders outside of the Pillow source tree should consider using the cleanup function pointers instead.
The stretch function on the core image object has been removed. This used to be for enlarging the image, but has been aliased to resize recently.
Fix Resample coefficient calculation #2162 [homm]
Fix Resample coefficient calculation #2162 [homm]
Allow lists as arguments for Image.new() #2149 [homm]
Allow lists as arguments for Image.new() #2149 [homm]
Fix fix for map.c overflow #2151 (also in 3.3.3) [wiredfool]
Use modern base64 interface over deprecated #2121 [hugovk]
Removed Image.core.open_ppm, added negative image size checks in Image.py. #2146 [wiredfool]
Windows build: fetch dependencies from pillow-depends #2095 [hugovk]
Add TIFF save_all writer. #2140 [lambdafu, vashek]
Move libtiff fd duplication to _load_libtiff #2141 [sekrause]
Speed up GIF save optimization step, fixes #2093. #2133 [wiredfool]
Fix for ImageCms Segfault, Issue #2037. #2131 [wiredfool]
Make Image.crop an immediate operation, not lazy. #2138 [wiredfool]
Skip empty values in ImageFileDirectory #2024 [homm]
Force reloading palette when using mmap in ImageFile. #2139 [lambdafu]
Fix "invalid escape sequence" warning in Python 3.6 #2136 [timgraham]
Update documentation about drafts #2137 [radarhere]
Converted documentation parameter format, comments to docstrings #2021 [radarhere]
Fixed typos #2128 #2142 [radarhere]
Renamed references to OS X to macOS #2125 2130 [radarhere]
Use truth value when checking for progressive and optimize option on save #2115, #2129 [radarhere]
Convert DPI to ints when saving as JPEG #2102 [radarhere]
Added append_images parameter to GIF saving #2103 [radarhere]
Speedup paste with masks up to 80% #2015 [homm]
Rewrite DDS decoders in C, add DXT3 and BC7 decoders #2068 [Mischanix]
Fix PyArg_ParseTuple format in getink() #2070 [arjennienhuis]
Fix saving originally missing TIFF tags. #2111 [anntzer]
Allow pathlib.Path in Image.open on Python 2.7 #2110 [patricksnape]
Use modern base64 interface over deprecated #2121 [hugovk]
ImageColor.getrgb hexadecimal RGBA #2114 [homm]
Test fix for bigendian machines #2092 [wiredfool]
Resampling lookups, trailing empty coefficients, precision #2008 [homm]
Add (un)packing between RGBA and BGRa #2057 [arjennienhuis]
Added return for J2k (and fpx) Load to return a pixel access object #2061 [wiredfool]
Skip failing numpy tests on Pypy <= 5.3.1 #2090 [arjennienhuis]
Show warning when trying to save RGBA image as JPEG #2010 [homm]
Respect pixel centers during transform #2022 [homm]
TOC for supported file formats #2056 [polarize]
Fix conversion of bit images to numpy arrays Fixes #350, #2058 [matthew-brett]
Add ImageOps.scale to expand or contract a PIL image by a factor #2011 [vlmath]
Flake8 fixes #2050 [hugovk]
Updated freetype to 2.6.5 on Appveyor builds #2035 [radarhere]
PCX encoder fixes #2023, pr #2041 [homm]
Docs: Windows console prompts are > #2031 [techtonik]
Expose Pillow package version as PIL.__version__ #2027 [techtonik]
Add Box and Hamming filters for resampling #1959 [homm]
Retain a reference to core image object in PyAccess #2009 [homm]
The nominally private/debugging function Image.core.open_ppm has been removed. If you were using this function, please use Image.open instead.
JPEG images cannot contain an alpha channel. Pillow prior to 3.4.0 silently drops the alpha channel. With this release Pillow will now issue a DeprecationWarning when attempting to save a RGBA mode image as a JPEG. This will become an error in Pillow 4.2.
Two new filters available for Image.resize() and Image.thumbnail() functions: BOX and HAMMING. BOX is the high-performance filter with two times shorter window than BILINEAR. It can be used for image reduction 3 and more times and produces a sharper result than BILINEAR.
HAMMING filter has the same performance as BILINEAR filter while providing the image downscaling quality comparable to BICUBIC. Both new filters don't show good quality for the image upscaling.
Pillow can now decode DXT3 images, as well as the previously supported DXT1 and DXT5 formats. All three formats are now decoded in C code for better performance.
Additional frames can now be appended when saving a GIF file, through the append_images argument. The new frames are passed in as a list of images, which may be have multiple frames themselves.
Note that the append_images argument is only used if save_all is also in effect, e.g.:
im.save(out, save_all=True, append_images=[im1, im2, ...])
Multiple frames can now be saved in a TIFF file by using the save_all option. e.g.:
im.save("filename.tiff", format="TIFF", save_all=True)
Fix fix for map.c overflow #2151 [wiredfool]
Fix fix for map.c overflow #2151 [wiredfool]
Fix negative image sizes in Storage.c #2146 [wiredfool]
Fix negative image sizes in Storage.c #2146 [wiredfool]
Fix integer overflow in map.c #2146 [wiredfool]
Pillow prior to 3.3.2 may experience integer overflow errors in map.c when reading specially crafted image files. This may lead to memory disclosure or corruption.
Specifically, when parameters from the image are passed into Image.core.map_buffer, the size of the image was calculated with xsize * ysize * bytes_per_pixel. This will overflow if the result is larger than SIZE_MAX. This is possible on a 32-bit system.
Furthermore this size value was added to a potentially attacker provided offset value and compared to the size of the buffer without checking for overflow or negative values.
These values were then used for creating pointers, at which point Pillow could read the memory and include it in other images. The image was marked readonly, so Pillow would not ordinarily write to that memory without duplicating the image first.
This issue was found by Cris Neckar at Divergent Security.
Pillow prior to 3.3.2 and PIL 1.1.7 (at least) do not check for negative image sizes in ImagingNew in Storage.c. A negative image size can lead to a smaller allocation than expected, leading to arbitrary writes.
This issue was found by Cris Neckar at Divergent Security.
Fix C90 compilation error for Tcl / Tk rewrite #2033 [matthew-brett]
Fix C90 compilation error for Tcl / Tk rewrite #2033 [matthew-brett]
Fix image loading when rotating by 0 deg #2052 [homm]
Make deprecated functions raise NotImplementedError instead of Exception. #1862, #1890 [daniel-leicht, radarhere]
Fixed enums for Resolution Unit and Predictor in TiffTags.py #1998 [wiredfool]
Fix issue converting P mode to LA #1986 [didrix]
Moved test_j2k_overflow to check_j2k_overflow, prevent DOS of our 32bit testing machines #1995 [wiredfool]
Skip CRC checks in PNG files when LOAD_TRUNCATED_IMAGES is enabled #1991 [kkopachev]
Added CMYK mode for opening EPS files #1826 [radarhere]
Docs: OSX build instruction clarification #1994 [wiredfool]
Docs: Filter comparison table #1993 [homm]
Removal of pthread based Incremental.c, new interface for file decoders/encoders to access the python file. Fixes assorted J2k Hangs. #1934 [wiredfool]
Skip unnecessary passes when resizing #1954 [homm]
Removed duplicate code in ImagePalette #1832 [radarhere]
test_imagecms: Reduce precision of extended info due to 32 bit machine precision #1990 [AbdealiJK]
Binary Tiff Metadata/ICC profile. #1988 [wiredfool]
Ignore large text blocks in PNG if LOAD_TRUNCATED_IMAGES is enabled #1970 [homm]
Replace index = index+1 in docs with +=1 [cclauss]
Skip extra 0xff00 in jpeg #1977 [kkopachev]
Use bytearray for palette mutable storage #1985 [radarhere, wiredfool]
Added additional uint modes for Image.fromarray, more extensive tests of fromarray #1984 [mairsbw, wiredfool]
Fix for program importing PyQt4 when PyQt5 also installed #1942 [hugovk]
Changed depends/install_*.sh urls to point to github pillow-depends repo #1983 [wiredfool]
Allow ICC profile from encoderinfo while saving PNGs #1909 [homm]
Fix integer overflow on ILP32 systems (32-bit Linux). #1975 [lambdafu]
Change function declaration to match Tcl_CmdProc type #1966 [homm]
Integer overflow checks on all calls to *alloc #1781 [wiredfool]
Change equals method on Image so it short circuits #1967 [mattBoros]
Runtime loading of TCL/TK libraries, eliminating build time dependency. #1932 [matthew-brett]
Cleanup of transform methods #1941 [homm]
Fix "Fatal Python error: UNREF invalid object" in debug builds #1936 [wiredfool]
Setup fixes for Alpine linux #1937 [wiredfool]
Split resample into horizontal + vertical passes #1933 [homm]
Box blur with premultiplied alpha #1914 [homm]
Add libimagequant support in quantize() #1889 [rr-]
Added internal Premultiplied luminosity (La) mode #1912 [homm]
Fixed point integer resample #1881 [homm]
Removed docs/BUILDME script #1924 [radarhere]
Moved comments to docstrings #1926 [hugovk]
Include Python.h before wchar.h so _GNU_SOURCE is set consistently #1906 [hugovk]
Updated example decoder in documentation #1899 [radarhere]
Added support for GIF comment extension #1896 [radarhere]
Removed support for pre- 1.5.2 list form of Image info in Image.new #1897 [radarhere]
Fix typos in TIFF tags #1918 [radarhere]
Skip tests that require libtiff if it is not installed #1893 (fixes #1866) [wiredfool]
Skip test when icc profile is not available, fixes #1887. #1892 [doko42]
Make deprecated functions raise NotImplementedError instead of Exception. #1862, #1890 [daniel-leicht, radarhere]
Replaced os.system with subprocess.call in setup.py #1879 [radarhere]
Corrected Image show documentation #1886 [radarhere]
Added check for executable permissions to ImageShow #1880 [radarhere]
Fixed tutorial code and added explanation #1877 [radarhere]
Added OS X support for ImageGrab grabclipboard #1837 [radarhere]
Combined duplicate code in ImageTk #1856 [radarhere]
Added --disable-platform-guessing option to setup.py build extension #1861 [angeloc]
Fixed loading Transparent PNGs with a transparent black color #1840 [olt]
Add support for LA mode in Image.fromarray #1865 [pierriko]
Make ImageFile load images in read-only mode #1864 [hdante]
Added _accept hook for XVThumbImagePlugin #1853 [radarhere]
Test TIFF with LZW compression #1855, TGA RLE file #1854 [hugovk]
Improved SpiderImagePlugin help text #1863 [radarhere]
Updated Sphinx project description #1870 [radarhere]
Remove support for Python 3.0 from _imaging.c #1851 [radarhere]
Jpeg qtables are unsigned chars #1814, #1921 [thebostik]
Added additional EXIF tags #1841, TIFF Tags #1821 [radarhere]
Changed documentation to refer to ImageSequence Iterator #1833 [radarhere]
Fix Fedora prerequisites in installation docs, depends script #1842 [living180]
Added _accept hook for PixarImagePlugin #1843 [radarhere]
Removed outdated scanner classifier #1823 [radarhere]
Combined identical error messages in _imaging #1825 [radarhere]
Added debug option for setup.py to trace header and library finding #1790 [wiredfool]
Fix doc building on travis #1820, #1844 [wiredfool]
Fix for DIB/BMP images #1813, #1847 [wiredfool]
Add PixarImagePlugin file extension #1809 [radarhere]
Catch struct.errors when verifying png files #1805 [wiredfool]
SpiderImagePlugin: raise an error when seeking in a non-stack file #1794 [radarhere, jmichalon]
Added support for 2/4 bpp Tiff grayscale images #1789 [zwhfly]
Removed unused variable from selftest #1788 [radarhere]
Added warning for as_dict method (deprecated in 3.0.0) #1799 [radarhere]
Removed powf support for older Python versions #1784 [radarhere]
Health fixes #1625 #1903 [radarhere]
There is now support for using libimagequant as a higher quality quantization option in Image.quantize() on Unix-like platforms. This support requires building Pillow from source against libimagequant. We cannot distribute binaries due to licensing differences.
There are two new options to control the build_ext task in setup.py:
--debug dumps all of the directories and files that are checked when searching for libraries or headers when building the extensions.
--disable-platform-guessing removes many of the directories that are checked for libraries and headers for build systems or cross compilers that specify that information in via environment variables.
Image resampling for 8-bit per channel images was rewritten using only integer computings. This is faster on most platforms and doesn't introduce precision errors on the wide range of scales. With other performance improvements, this makes resampling 60% faster on average.
Color calculation for images in the LA mode on semitransparent pixels was fixed.
Rotation for angles divisible by 90 degrees now always uses transposition. This greatly improves both quality and performance in this case. Also, the bug with wrong image size calculation when rotating by 90 degrees was fixed.
The return type for binary data in version 2 Exif and Tiff metadata has been changed from a tuple of integers to bytes. This is a change from the behavior since 3.0.0.
Added install docs for Fedora 23 and FreeBSD #1729, #1739, #1792 [koobs, zandermartin, wiredfool]
Added install docs for Fedora 23 and FreeBSD #1729, #1739, #1792 [koobs, zandermartin, wiredfool]
Fixed TIFF multiframe load when the frames have different compression types #1782 [radarhere, geka000]
Added __copy__ method to Image #1772 [radarhere]
Updated dates in PIL license in OleFileIO README #1787 [radarhere]
Corrected Tiff tag names #1786 [radarhere]
Fixed documented name of JPEG property #1783 [radarhere]
Fixed UnboundLocalError when loading a corrupt jpeg2k file #1780 [wiredfool]
Fixed integer overflow in path.c #1773 [wiredfool, nedwill]
Added debug to command line help text for pilprint #1766 [radarhere]
Expose many more fields in ICC Profiles #1756 [lambdafu]
Documentation changes, URL update, transpose, release checklist [radarhere]
Fixed saving to nonexistent files specified by pathlib.Path objects #1748 (fixes #1747) [radarhere]
Round Image.crop arguments to the nearest integer #1745 (fixes #1744) [hugovk]
Fix uninitialized variable warning in _imaging.c:getink #1663 (fixes #486) [wiredfool]
Disable multiprocessing install on cygwin #1700 (fixes #1690) [wiredfool]
Fix the error reported when libz is not found #1764 [wiredfool]
More general error check to avoid Symbol not found: _PyUnicodeUCS2_AsLatin1String on OS X #1761 [wiredfool]
Added py35 to tox envlist #1724 [radarhere]
Fix EXIF tag name typos #1736 [zarlant, radarhere]
Updated freetype to 2.6.3, Tk/Tcl to 8.6.5 and 8.5.19 #1725, #1752 [radarhere]
Add a loader for the FTEX format from Independence War 2: Edge of Chaos #1688 [jleclanche]
Improved alpha_composite documentation #1698 [radarhere]
Extend ImageDraw.text method to pass on multiline_text method specific arguments #1647 [radarhere]
Allow ImageSequence to seek to zero #1686 [radarhere]
ImageSequence Iterator is now an iterator #1649 [radarhere]
Updated windows test builds to jpeg9b #1673 [radarhere]
Fixed support for .gbr version 1 images, added support for version 2 in GbrImagePlugin #1653 [wiredfool]
Clarified which YCbCr format is used #1677 [radarhere]
Added TiffTags documentation, Moved windows build documentation to winbuild/ #1667 [wiredfool]
Add tests for OLE file based formats #1678 [radarhere]
Add TIFF IFD test #1671 [radarhere]
Add a basic DDS image plugin with more tests #1654 [jleclanche, hugovk, wiredfool]
Fix incorrect conditional in encode.c #1638 [manisandro]
The DdsImagePlugin reading DXT1 and DXT5 encoded .dds images was added. DXT3 images are not currently supported.
The FtexImagePlugin reads textures used for 3D objects in Independence War 2: Edge Of Chaos. The plugin reads a single texture per file, in the .ftc (compressed) and .ftu (uncompressed) formats.
The GbrImagePlugin (GIMP brush format) has been updated to fix support for version 1 files and add support for version 2 files.
ImageDraw.multiline_text and ImageDraw.multiline_size take extra spacing parameters above what are used in ImageDraw.text and ImageDraw.size. These parameters can now be passed into ImageDraw.text and ImageDraw.size and they will be passed through to the corresponding multiline functions.
ImageSequence.Iterator is now an actual iterator implementing the Iterator protocol. It is also now possible to seek to the first image of the file when using direct indexing.
Fixed an integer overflow in Jpeg2KEncode.c causing a buffer overflow. CVE-2016-3076 [wiredfool]
Fixed an integer overflow in Jpeg2KEncode.c causing a buffer overflow. CVE-2016-3076 [wiredfool]
Pillow between 2.5.0 and 3.1.1 may overflow a buffer when writing large Jpeg2000 files, allowing for code execution or other memory corruption.
This occurs specifically in the function j2k_encode_entry, at the line:
state->buffer = malloc (tile_width * tile_height * components * prec / 8);
This vulnerability requires a particular value for height * width such that height * width * components * precision overflows, at which point the malloc will be for a smaller value than expected. The buffer that is allocated will be ((height * width * components * precision) mod (2^31) / 8), where components is 1-4 and precision is either 8 or 16. Common values would be 4 components at precision 8 for a standard RGBA image.
The unpackers then split an image that is laid out:
RGBARGBARGBA....
into:
RRR. GGG. BBB. AAA.
If this buffer is smaller than expected, the jpeg2k unpacker functions will write outside the allocation and onto the heap, corrupting memory.
This issue was found by Alyssa Besseling at Atlassian.
Fixed a buffer overflow in PcdDecode.c causing a segfault when opening PhotoCD files. CVE-2016-2533 [wiredfool]
Fixed an integer overflow in Resample.c causing writes in the Python heap. [nedwill]
Fixed a buffer overflow in PcdDecode.c causing a segfault when opening PhotoCD files. CVE-2016-2533 [wiredfool]
Fixed a buffer overflow in FliDecode.c causing a segfault when opening FLI files. CVE-2016-0775 [wiredfool]
Fixed a buffer overflow in TiffDecode.c causing an arbitrary amount of memory to be overwritten when opening a specially crafted invalid TIFF file. CVE-2016-0740 [wiredfool]
Pillow 3.1.0 and earlier when linked against libtiff >= 4.0.0 on x64 may overflow a buffer when reading a specially crafted tiff file.
Specifically, libtiff >= 4.0.0 changed the return type of TIFFScanlineSize from int32 to machine dependent int32|64. If the scanline is sized so that it overflows an int32, it may be interpreted as a negative number, which will then pass the size check in TiffDecode.c line 236. To do this, the logical scanline size has to be > 2gb, and for the test file, the allocated buffer size is 64k against a roughly 4gb scan line size. Any image data over 64k is written over the heap, causing a segfault.
This issue was found by security researcher FourOne.
In all versions of Pillow, dating back at least to the last PIL 1.1.7 release, FliDecode.c has a buffer overflow error (2016-0775).
Around line 192:
case 16:
/* COPY chunk */
for (y = 0; y < state->ysize; y++) {
UINT8* buf = (UINT8*) im->image[y];
memcpy(buf+x, data, state->xsize);
data += state->xsize;
}
break;
The memcpy has error where x is added to the target buffer address. X is used in several internal temporary variable roles, but can take a value up to the width of the image. Im->image[y] is a set of row pointers to segments of memory that are the size of the row. At the max y, this will write the contents of the line off the end of the memory buffer, causing a segfault.
This issue was found by Alyssa Besseling at Atlassian.
In all versions of Pillow, dating back at least to the last PIL 1.1.7 release, PcdDecode.c has a buffer overflow error (2016-2533).
The state.buffer for PcdDecode.c is allocated based on a 3 bytes per pixel sizing, where PcdDecode.c wrote into the buffer assuming 4 bytes per pixel. This writes 768 bytes beyond the end of the buffer into other Python object storage. In some cases, this causes a segfault, in others an internal Python malloc error.
If a large value was passed into the new size for an image, it is possible to overflow an int32 value passed into malloc.
kk = malloc(xsize * kmax * sizeof(float));
...
xbounds = malloc(xsize * 2 * sizeof(int));
xsize is trusted user input. These multiplications can overflow, leading the malloc'd buffer to be undersized. These allocations are followed by a loop that writes out of bounds. This can lead to corruption on the heap of the Python process with attacker controlled float data.
This issue was found by Ned Williamson.
Fixing test failures on Python 2.6/Windows #1633 [wiredfool]
Fixing test failures on Python 2.6/Windows #1633 [wiredfool]
Limit metadata tags when writing using libtiff #1620 [wiredfool]
Rolling back exif support to pre-3.0 format #1627 [wiredfool]
Fix Divide by zero in Exif, add IFDRational class #1531 [wiredfool]
Catch the IFD error near the source #1622 [wiredfool]
Added release notes for 3.1.0 #1623 [radarhere]
Updated spacing to be consistent between multiline methods #1624 [radarhere]
Let EditorConfig take care of some basic formatting #1489 [hugovk]
Restore gpsexif data to the v1 form #1619 [wiredfool]
Add /usr/local include and library directories for freebsd #1613 [leforestier]
Updated installation docs for new versions of dependencies #1611 [radarhere]
Removed unrunnable test file #1610 [radarhere]
Changed register calls to use format property #1608 [radarhere]
Added field type constants to TiffTags #1596 [radarhere]
Allow saving RowsPerStrip with libtiff #1594 [wiredfool]
Enabled conversion to numpy array for HSV images #1578 [cartisan]
Changed some urls in the docs to use https #1580 [hugovk]
Removed logger.exception from ImageFile.py #1590 [radarhere]
Removed warnings module check #1587 [radarhere]
Changed arcs, chords and pie slices to use floats #1577 [radarhere]
Update unit test asserts #1584, #1598 [radarhere]
Fix command to invoke ghostscript for eps files #1478 [baumatron, radarhere]
Consistent multiline text spacing #1574 [wiredfool, hugovk]
Removed unused lines in BDFFontFile #1530 [radarhere]
Changed ImageQt import of Image #1560 [radarhere, ericfrederich]
Throw TypeError if no cursors were found in .cur file #1556 [radarhere]
Fix crash in ImageTk.PhotoImage on win-amd64 #1553 [cgohlke]
ExtraSamples tag should be a SHORT, not a BYTE #1555 [Nexuapex]
Docs and code health fixes #1565 #1566 #1581 #1586 #1591 #1621 [radarhere]
Updated freetype to 2.6.2 #1564 [radarhere]
Updated WebP to 0.5.0 for Travis #1515 #1609 [radarhere]
Fix missing 'version' key value in __array_interface__ #1519 [mattip]
Replaced os.popen with subprocess.Popen to pilprint script #1523 [radarhere]
Catch OverflowError in SpiderImagePlugin #1545 [radarhere, MrShark]
Fix the definition of icc_profile in TiffTags #1539 [wiredfool]
Remove old _imagingtiff.c and pilplus stuff #1499 [hugovk]
Fix Exception when requiring jpeg #1501 [hansmosh]
Dependency scripts for Debian and Ubuntu #1486 [wiredfool]
Added Usage message to painter script #1482 [radarhere]
Add tag info for iccprofile, fixes #1462. #1465 [wiredfool]
Added some requirements for make release-test #1451 [wiredfool]
Flatten tiff metadata value SAMPLEFORMAT to initial value #1467 (fixes #1466) [wiredfool]
Fix handling of pathlib in Image.save #1464 (fixes #1460) [wiredfool]
Make tests more robust #1469 [hugovk]
Use correctly sized pointers for windows handle types #1458 [nu744]
There is no longer a need to ensure that the start and end arguments for arc, chord and pieslice are integers.
Note that these numbers are not simply rounded internally, but are actually utilised in the drawing process.
When using the ImageDraw multiline methods, the spacing between lines was inconsistent, based on the combination on ascenders and descenders.
This has now been fixed, so that lines are offset by their baselines, not the absolute height of each line.
There is also now a default spacing of 4px between lines.
There were major changes in the TIFF ImageFileDirectory support in Pillow 3.0 that led to a number of regressions. Some of them have been fixed in Pillow 3.1, and some of them have been extended to have different behavior.
Pillow 3.0 changed rational metadata to use a float. In Pillow 3.1, this has changed to allow the expression of 0/0 as a valid piece of rational metadata to reflect usage in the wild.
Rational metadata is now encapsulated in an IFDRational instance. This class extends the Rational class to allow a denominator of 0. It compares as a float or a number, but does allow access to the raw numerator and denominator values through attributes.
When used in a ImageFileDirectory_v1, a 2 item tuple is returned of the numerator and denominator, as was done previously.
This class should be used when adding a rational value to an ImageFileDirectory for saving to image metadata.
In Pillow 3.0, the dictionary returned from the private, experimental, but generally widely used _getexif function changed to reflect the ImageFileDirectory_v2 format, without a fallback to the previous format.
In Pillow 3.1, _getexif now returns a dictionary compatible with Pillow 2.9 and earlier, built with ImageFileDirectory_v1 instances. Additionally, any single item tuples have been unwrapped and return a bare element.
The format returned by Pillow 3.0 has been abandoned. A more fully featured interface for EXIF is anticipated in a future release.
In Pillow 3.0 and 3.1, images that contain metadata that is internally consistent, but not in agreement with the TIFF spec, may cause an exception when reading the metadata. This can happen when a tag that is specified to have a single value is stored with an array of values.
It is anticipated that this behavior will change in future releases.
Nothing published for this version
Nothing published for this version
Removed deprecated code, Image.tostring, Image.fromstring, Image.offset, ImageDraw.setink, ImageDraw.setfill, ImageFileIO, ImageFont.FreeTypeFont and…
Check flush method existence for file-like object #1398 [mrTable, radarhere]
Added PDF multipage saving #1445 [radarhere]
Removed deprecated code, Image.tostring, Image.fromstring, Image.offset, ImageDraw.setink, ImageDraw.setfill, ImageFileIO, ImageFont.FreeTypeFont and ImageFont.truetype file kwarg, ImagePalette private _make functions, ImageWin.fromstring and ImageWin.tostring #1343 [radarhere]
Load more broken images #1428 [homm]
Require zlib and libjpeg #1439 [wiredfool]
Preserve alpha when converting from a QImage to a Pillow Image by using png instead of ppm #1429 [ericfrederich]
Qt needs 32 bit aligned image data #1430 [ericfrederich]
Tiff ImageFileDirectory rewrite #1419 [anntzer, wiredfool, homm]
Removed spammy debug logging #1423 [wiredfool]
Save as GiF89a with support for animation parameters #1384 [radarhere]
Correct convert matrix docs #1426 [wiredfool]
Catch TypeError in _getexif #1414 [radarhere, wiredfool]
Fix for UnicodeDecodeError in TiffImagePlugin #1416 [bogdan199, wiredfool]
Dedup code in image.open #1415 [wiredfool]
Skip any number extraneous chars at the end of JPEG chunks #1337 [homm]
Single threaded build for pypy3, refactor #1413 [wiredfool]
Fix loading of truncated images with LOAD_TRUNCATED_IMAGES enabled #1366 [homm]
Documentation update for concepts: bands #1406 [merriam]
Add Solaris/SmartOS include and library directories #1356 [njones11]
Improved handling of getink color #1387 [radarhere]
Disable compiler optimizations for topalette and tobilevel functions for all msvc versions #1402 (fixes #1357) [cgohlke]
Skip ImageFont_bitmap test if _imagingft C module is not installed #1409 [homm]
Add param documentation to ImagePalette #1381 [bwrsandman]
Corrected scripts path #1407 [radarhere]
Updated libtiff to 4.0.6 #1405, #1421 [radarhere]
Updated Platform Support for Yosemite #1403 [radarhere]
Fixed infinite loop on truncated file #1401 [radarhere]
Check that images are L mode in ImageMorph methods #1400 [radarhere]
In tutorial of pasting images, add to mask text #1389 [merriam]
Style/health fixes #1391, #1397, #1417, #1418 [radarhere]
Test on Python 3.5 dev and 3.6 nightly #1361 [hugovk]
Fix fast rotate operations #1373 [radarhere]
Added support for pathlib Path objects to open and save #1372 [radarhere]
Changed register calls to use format property #1333 [radarhere]
Added support for ImageGrab.grab to OS X #1367, #1443 [radarhere, hugovk]
Fixed PSDraw stdout Python 3 compatibility #1365 [radarhere]
Added Python 3.3 to AppVeyor #1363 [radarhere]
Treat MPO with unknown header as base JPEG file #1350 [hugovk, radarhere]
Added various tests #1330, #1344 [radarhere]
More ImageFont tests #1327 [hugovk]
Use logging instead of print #1207 [anntzer]
Several methods that have been marked as deprecated for many releases have been removed in this release:
Image.tostring()
Image.fromstring()
Image.offset()
ImageDraw.setink()
ImageDraw.setfill()
The ImageFileIO module
The ImageFont.FreeTypeFont and ImageFont.truetype file keyword arg
The ImagePalette private _make functions
ImageWin.fromstring()
ImageWin.tostring()
There is now support for saving multipage images in the GIF and PDF formats. To enable this functionality, pass in save_all=True as a keyword argument to the save:
im.save('test.pdf', save_all=True)
The TIFF ImageFileDirectory metadata code has been rewritten. Where previously it returned a somewhat arbitrary set of values and tuples, it now returns bare values where appropriate and tuples when the metadata item is a sequence or collection.
The original metadata is still available in the TiffImage.tags, the new values are available in the TiffImage.tags_v2 member. The old structures will be deprecated at some point in the future. When saving TIFF metadata, new code should use the TiffImagePlugin.ImageFileDirectory_v2 class.
The external dependencies on libjpeg and zlib are now required by default. If the headers or libraries are not found, then installation will abort with an error. This behaviour can be disabled with the --disable-libjpeg and --disable-zlib flags.
Added test for GimpPaletteFile #1324 [radarhere]
Added test for GimpPaletteFile #1324 [radarhere]
Merged gifmaker script to allow saving of multi-frame GIF images #1320 [radarhere]
Added is_animated property to multi-frame formats #1319 [radarhere]
Fixed ValueError in Python 2.6 #1315 #1316 [cgohlke, radarhere]
Fixed tox test script path #1308 [radarhere]
Added width and height properties #1304 [radarhere]
Update tiff and tk tcl 8.5 versions #1303 [radarhere, wiredfool]
Add functions to convert: Image <-> QImage; Image <-> QPixmap #1217 [radarhere, rominf]
Remove duplicate code in gifmaker script #1294 [radarhere]
Multiline text in ImageDraw #1177 [allo-, radarhere]
Automated Windows CI/build support #1278 [wiredfool]
Removed support for Tk versions earlier than 8.4 #1288 [radarhere]
Fixed polygon edge drawing #1255 (fixes #1252) [radarhere]
Check prefix length in _accept methods #1267 [radarhere]
Register MIME type for BMP #1277 [coldmind]
Adjusted ImageQt use of unicode() for 2/3 compatibility #1218 [radarhere]
Identify XBM file created with filename including underscore #1230 (fixes #1229) [hugovk]
Copy image when saving in GifImagePlugin #1231 (fixes #718) [radarhere]
Removed support for FreeType 2.0 #1247 [radarhere]
Added background saving to GifImagePlugin #1273 [radarhere]
Provide n_frames attribute to multi-frame formats #1261 [anntzer, radarhere]
Add duration and loop set to GifImagePlugin #1172, #1269 [radarhere]
Ico files are little endian #1232 [wiredfool]
Upgrade olefile from 0.30 to 0.42b #1226 [radarhere, decalage2]
Setting transparency value to 0 when the tRNS contains only null byte(s) #1239 [juztin]
Separated out feature checking from selftest #1233 [radarhere]
Style/health fixes [radarhere]
Update WebP from 0.4.1 to 0.4.3 #1235 [radarhere]
Release GIL during image load (decode) #1224 [lkesteloot]
Added icns save #1185 [radarhere]
Fix putdata memory leak #1196 [benoit-pierre]
Keep user-specified ordering of icon sizes #1193 [karimbahgat]
Tiff: allow writing floating point tag values #1113 [bpedersen2]
Bug fix: Fixed Tiff handling of bad EXIF data [radarhere]
Bug fix: Fixed Tiff handling of bad EXIF data [radarhere]
Bug fix: Catch struct.error on invalid JPEG, fixes #1163. #1165 [wiredfool, hugovk]
Bug fix: Catch struct.error on invalid JPEG, fixes #1163. #1165 [wiredfool, hugovk]
Fix 32-bit BMP loading (RGBA or RGBX) #1125 [artscoop]
Fix 32-bit BMP loading (RGBA or RGBX) #1125 [artscoop]
Fix UnboundLocalError in ImageFile #1131 [davarisg]
Re-enable test image caching #982 [hugovk, homm]
Fix: Cannot identify EPS images #1152 (fixes #1104) [hugovk]
Configure setuptools to run nosetests, fixes #729 [aclark4life]
Style/health fixes [radarhere, hugovk]
Add support for HTTP response objects to Image.open() #1151 [mfitzp]
Improve reference docs for PIL.ImageDraw.Draw.pieslice() #1145 [audreyr]
Added copy method font_variant() and accessible properties to truetype() #1123 [radarhere]
Fix ImagingEffectNoise #1128 [hugovk]
Remove unreachable code #1126 [hugovk]
Let Python do the endian stuff + tests #1121 [amoibos, radarhere]
Fix webp decode memory leak #1114 [benoit-pierre]
Fast path for opaque pixels in RGBa unpacker #1088 [bgilbert]
Enable basic support for 'RGBa' raw encoding/decoding #1096 [immerrr]
Fix pickling L mode images with no palette, #1095 [hugovk]
iPython display hook #1091 [wiredfool]
Adjust buffer size when quality=keep #1079 (fixes #148 again) [wiredfool]
Fix for corrupted bitmaps embedded in truetype fonts #1072 [jackyyf, wiredfool]
HTTP response objects returned from urllib2.urlopen(url) or requests.get(url, stream=True).raw are 'file-like' but do not support .seek() operations. As a result PIL was unable to open them as images, requiring a wrap in cStringIO or BytesIO.
Now new functionality has been added to Image.open() by way of an .seek(0) check and catch on exception AttributeError or io.UnsupportedOperation. If this is caught we attempt to wrap the object using io.BytesIO (which will only work on buffer-file-like objects).
This allows opening of files using both urllib2 and requests, e.g.:
Image.open(urllib2.urlopen(url)) Image.open(requests.get(url, stream=True).raw)
If the response uses content-encoding (compression, either gzip or deflate) then this will fail as both the urllib2 and requests raw file object will produce compressed data in that case. Using Content-Encoding on images is rather non-sensical as most images are already compressed, but it can still happen.
For requests the work-around is to set the decode_content attribute on the raw object to True:
response = requests.get(url, stream=True) response.raw.decode_content = True image = Image.open(response.raw)
Fix CVE-2014-9601, potential PNG decompression DOS #1060 [wiredfool]
Split Sane into a separate repo: https://github.com/python-pillow/Sane [hugovk]
Look for OS X and Linux fonts in common places #1054 [charleslaw]
Fix CVE-2014-9601, potential PNG decompression DOS #1060 [wiredfool]
Use underscores, not spaces, in TIFF tag kwargs #1044, #1058 [anntzer, hugovk]
Update PSDraw for Python3, add tests #1055 [hugovk]
Use Bicubic filtering by default for thumbnails. Don't use Jpeg Draft mode for thumbnails #1029 [homm]
Fix MSVC compiler error: Use Py_ssize_t instead of ssize_t #1051 [cgohlke]
Fix compiler error: MSVC needs variables defined at the start of the block #1048 [cgohlke]
The GIF Palette optimization algorithm is only applicable to mode='P' or 'L' #993 [moriyoshi]
Use PySide as an alternative to PyQt4/5 #1024 [holg]
Replace affine-based im.resize implementation with convolution-based im.stretch #997 [homm]
Replace Gaussian Blur implementation with iterated fast box blur. #961 Note: Radius parameter is interpreted differently than before. [homm]
Better docs explaining import _imaging failure #1016, build #1017, mode #1018, PyAccess, PixelAccess objects #1019 Image.quantize #1020 and Image.save #1021 [wiredfool]
Fix for saving TIFF image into an io.BytesIO buffer #1011 [mfergie]
Fix antialias compilation on debug versions of Python #1010 [wiredfool]
Fix for Image.putdata segfault #1009 [wiredfool]
Ico save, additional tests #1007 [exherb]
Use PyQt4 if it has already been imported, otherwise prefer PyQt5 #1003 [AurelienBallier]
Speedup resample implementation up to 2.5 times #977 [homm]
Speed up rotation by using cache aware loops, added transpose to rotations #994 [homm]
Fix Bicubic interpolation #970 [homm]
Support for 4-bit grayscale TIFF images #980 [hugovk]
Updated manifest #957 [wiredfool]
Fix PyPy 2.4 regression #958 [wiredfool]
Webp Metadata Skip Test comments #954 [wiredfool]
Fixes for things rpmlint complains about #942 [manisandro]
The Sane plugin has now been split into its own repo: https://github.com/python-pillow/Sane .
To prevent potential denial of service attacks using compressed text chunks, there are now limits to the decompressed size of text chunks decoded from PNG images. If the limits are exceeded when opening a PNG image a ValueError will be raised.
Individual text chunks are limited to PIL.PngImagePlugin.MAX_TEXT_CHUNK, set to 1MB by default. The total decompressed size of all text chunks is limited to PIL.PngImagePlugin.MAX_TEXT_MEMORY, which defaults to 64MB. These values can be changed prior to opening PNG images if you know that there are large text blocks that are desired.
Image resizing methods ~PIL.Image.Image.resize and ~PIL.Image.Image.thumbnail take a resample argument, which tells which filter should be used for resampling. Possible values are: NEAREST, BILINEAR, BICUBIC and ANTIALIAS. Almost all of them were changed in this version.
From the beginning BILINEAR and BICUBIC filters were based on affine transformations and used a fixed number of pixels from the source image for every destination pixel (2x2 pixels for BILINEAR and 4x4 for BICUBIC). This gave an unsatisfactory result for downscaling. At the same time, a high quality convolutions-based algorithm with flexible kernel was used for ANTIALIAS filter.
Starting from Pillow 2.7.0, a high quality convolutions-based algorithm is used for all of these three filters.
If you have previously used any tricks to maintain quality when downscaling with BILINEAR and BICUBIC filters (for example, reducing within several steps), they are unnecessary now.
A new LANCZOS constant was added instead of ANTIALIAS.
When ANTIALIAS was initially added, it was the only high-quality filter based on convolutions. It's name was supposed to reflect this. Starting from Pillow 2.7.0 all resize method are based on convolutions. All of them are antialias from now on. And the real name of the ANTIALIAS filter is Lanczos filter.
The ANTIALIAS constant is left for backward compatibility and is an alias for LANCZOS.
The image upscaling quality with LANCZOS filter was almost the same as BILINEAR due to a bug. This has been fixed.
The BICUBIC filter for affine transformations produced sharp, slightly pixelated image for upscaling. Bicubic for convolutions is more soft.
In most cases, convolution is more a expensive algorithm for downscaling because it takes into account all the pixels of source image. Therefore BILINEAR and BICUBIC filters' performance can be lower than before. On the other hand the quality of BILINEAR and BICUBIC was close to NEAREST. So if such quality is suitable for your tasks you can switch to NEAREST filter for downscaling, which will give a huge improvement in performance.
At the same time performance of convolution resampling for downscaling has been improved by around a factor of two compared to the previous version. The upscaling performance of the LANCZOS filter has remained the same. For BILINEAR filter it has improved by 1.5 times and for BICUBIC by four times.
In Pillow 2.5 the default filter for ~PIL.Image.Image.thumbnail was changed from NEAREST to ANTIALIAS. Antialias was chosen because all the other filters gave poor quality for reduction. Starting from Pillow 2.7.0, ANTIALIAS has been replaced with BICUBIC, because it's faster and ANTIALIAS doesn't give any advantages after downscaling with libjpeg, which uses supersampling internally, not convolutions.
A new method TRANSPOSE has been added for the ~PIL.Image.Image.transpose operation in addition to FLIP_LEFT_RIGHT, FLIP_TOP_BOTTOM, ROTATE_90, ROTATE_180, ROTATE_270. TRANSPOSE is an algebra transpose, with an image reflected across its main diagonal.
The speed of ROTATE_90, ROTATE_270 and TRANSPOSE has been significantly improved for large images which don't fit in the processor cache.
The ~PIL.ImageFilter.GaussianBlur implementation has been replaced with a sequential application of box filters. The new implementation is based on "Theoretical foundations of Gaussian convolution by extended box filtering" from the Mathematical Image Analysis Group. As ~PIL.ImageFilter.UnsharpMask implementations use Gaussian blur internally, all changes from this chapter are also applicable to it.
There was an error in the previous version of Pillow, where blur radius (the standard deviation of Gaussian) actually meant blur diameter. For example, to blur an image with actual radius 5 you were forced to use value 10. This has been fixed. Now the meaning of the radius is the same as in other software.
If you used a Gaussian blur with some radius value, you need to divide this value by two.
Box filter computation time is constant relative to the radius and depends on source image size only. Because the new Gaussian blur implementation is based on box filter, its computation time also doesn't depend on the blur radius.
For example, previously, if the execution time for a given test image was 1 second for radius 1, 3.6 seconds for radius 10 and 17 seconds for 50, now blur with any radius on same image is executed for 0.2 seconds.
The previous implementation takes into account only source pixels within 2 * standard deviation radius for every destination pixel. This was not enough, so the quality was worse compared to other Gaussian blur software.
The new implementation does not have this drawback.
Several kwarg parameters for saving TIFF images were previously specified as strings with included spaces (e.g. 'x resolution'). This was difficult to use as kwargs without constructing and passing a dictionary. These parameters now use the underscore character instead of space. (e.g. 'x_resolution')
Fix CVE-2014-9601, potential PNG decompression DOS #1060 [wiredfool]
Fix CVE-2014-9601, potential PNG decompression DOS #1060 [wiredfool]
Fix Regression in PyPy 2.4 in streamio #958 [wiredfool]
One column per quarter.