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.
Remove deprecations for Pillow 13.0.0 #9751 [ @radarhere ]
https://pillow.readthedocs.io/en/stable/releasenotes/13.0.0.html
GifImagePlugin._save_netpbm #9901 [@akx]pathlib.Path to find test images and fonts #10079 [@akx]ubuntu-slim for lightweight jobs #9846 [@hugovk]pytest.approx, pytest.raises and pytest.skip #9844 [@hugovk]TYPE_CHECKING block #9827 [@hugovk]Note truncated.
Your coding agent can read these notes before it upgrades. Set up the MCP server →
CVE identifiers will be added to these entries as they are assigned.
2026-96639, v9pv-5gc8-w2m6: Stale native image storage reused after mode transitions
2026-112398, 2026-112403, 5x8w-8jj5-q52h, 8g5g-8vmr-9782: JPEG decoder buffer overflow from scanlines wider than tile extents
2026-96644, 9v9v-9qvf-h2hj: WMF/EMF heap out-of-bounds read from dimension truncation
2026-96637, g842-9rc4-69pw: SPIDER decompression bomb bypass via seek()
2026-96643, g4qv-2jxx-769h: Unbounded Exif header replacement loop
2026-96778, g7cr-3p24-7wf7: JPEG comment write after ICC profile fills encoder buffer
2026-112395, 2026-112404, 462x-pgg6-55fp, c6hw-5grf-ff96: TIFF tile and YCbCr decoding out-of-bounds read from undersized libtiff buffers
2026-112895, p4wg-p73j-c528: PDF parsing stack exhaustion from long trailer chains and deep or cyclic page trees
2026-96640, mrfp-p49p-3hf2: PDF append resource exhaustion from repeated page tree references
2026-112896, pchr-8j38-3x4p: TIFF encoder accepted an incorrectly sized Colormap for non-8-bit images
2026-112393, 332p-7hrc-92wf: TIFF encoder heap buffer overflow when saving to a file object
2026-128067, xcvg-w56q-r89m: TIFF encoder heap buffer overflow when tags override the image size
2026-112902, xvh5-g6gv-559v: TIFF encoder memory disclosure and crash from mismatched tag values
2026-112897, q45j-58j2-45rg: TIFF decoding returned uninitialized memory for short JPEG strips
78g4-xqwv-q3g8: Bundled OpenJPEG heap buffer overflow when reading tile-part data
2026-112396, 4rr5-89j8-mwwm: TIFF encoder use-after-free write
2026-96636, p8hx-v2p6-rp84: MPO, DCX and MIC decompression bomb bypass via seek()
2026-112406, f2g6-542v-9j58: PDF page tree stack exhaustion via cyclic /Kids reference
2026-112399, 5xm2-6676-qcp9: APNG decompression bomb bypass via delayed disposal-frame sizing
2026-96642, 3j72-p6qg-6xp7: TarIO negative size field causes infinite CPU-spin loop
2026-96638, 24rc-8hj2-v98c: BMP RLE decoder memory-amplification denial of service
2026-112892, gg2r-wvfm-q9rx: MSP RLE decoder expands a tiny file into unbounded memory
2026-128066, wqgw-9xfh-qf2g: TIFF and Exif IFD parsing memory and CPU amplification from shared tag data
2026-112894, jg86-v3jv-hrpm: Quadratic time when writing many objects to a PDF
2026-112391, 254f-3936-288h: PdfParser unbounded recursion via deeply nested objects
2026-112898, rfgq-q3w2-pmv2: Image.quantize() crash from an empty target palette
2026-112901, xgh8-jp6q-p5x8: XBM header parsing regular expression denial of service
2026-112390, 2026-112401, 2026-112891, 22hg-r758-rrw9, 74r2-7ff9-mjj2, fc9g-5qg7-mf45: GIF comment handling quadratic-time blowup from repeated concatenation
2026-112392, 27h8-gf7j-v5hc: Out-of-bounds read in rank-based filters for zero-dimension images
2026-96641, 4rm8-3hmm-39fg: Integer underflow in PILfont text width calculation
2026-112405, cp9v-662q-vvx9: Image.merge() buffer overflow when merging 32-bit images as narrower bands
2026-112893, j4m9-6w36-pw47: Uninitialized glyph pointer freed on font rendering error path
2026-112402, 7mwm-ghpf-9vrm: Double free in Image.transform() after an allocation failure
2026-112394, 4558-3h8r-v8xp: P;2L and P;4L raw mode decoders read past the end of their input
2026-112900, w889-685w-c8fh: EPS filename argument injection into Ghostscript
2026-114501, 654x-cwwv-5j9c: Arrow export leaks stale heap memory when PILLOW_ALIGNMENT > 1
2026-112400, 65qm-jvmh-6pqg: GIF decompression bomb check used a size discarded on failure
2026-112899, vx6w-vv9f-6gvg: EPS decompression bomb bypass via Ghostscript rendering
2026-112397, 58r4-6rv3-gfh8: ImageMorph.MorphOp.apply() out-of-bounds write on zero-width images
Pillow has dropped support for Python 3.10, which reached end-of-life in October 2026.
In order to fit the 32 bits of I mode images into PNG, when PNG images can only contain at most 16 bits for a channel, Pillow has been clipping the values. Rather than quietly changing the data, this is now removed. Instead, the image can be converted to another mode before saving:
from PIL import Image
im = Image.new("I", (1, 1))
im.convert("I;16").save("out.png")
Using the mode parameter in ~PIL.Image.fromarray() was deprecated in Pillow 11.3.0. In Pillow 12.0.0, this was partially reverted, and now the only functionality removed is when the mode changes data types. Since pixel values do not contain information about palettes or color spaces, the parameter can still be used to place grayscale L mode data within a P mode image, or read RGB data as YCbCr for example. If omitted, the mode will be automatically determined from the object's shape and type.
Image.Image.get_child_images() has been moved to ImageFile.ImageFile.get_child_images(). The method uses an image's file pointer, and so child images could only be retrieved from an PIL.ImageFile.ImageFile instance.
Image._show has been removed. Use ~PIL.ImageShow.show instead.
ImageCms.ImageCmsProfile.product_name and the corresponding .product_info attributes have been removed. They were set to None since Pillow 2.3.0.
ExifTags.IFD.Makernote has been removed. Instead, use ExifTags.IFD.MakerNote.
The IM image format has been deprecated and removal is planned in Pillow 15.0.0 (2028-10-15). If you are using this format and would like to continue doing so, open an issue about what other software uses it.
JpegImageFile.load_djpeg has been deprecated, and will be removed in Pillow 14 (2027-10-15).
Use the built-in JPEG decoder instead, or call djpeg directly and decode the resulting image with Pillow.
ImageQt.align8to32() has been deprecated. This was an undocumented helper function intended for internal use, so there is no replacement.
When mode is RGBa or La, ~PIL.ImageColor.getcolor now returns color values premultiplied by the alpha channel, matching how pixels are stored in those modes. Previously, the unmultiplied values were returned.
If a TIFF IFD contains the same tag more than once, the first value is now kept. Previously, the last value overwrote the earlier ones.
When saving an image smaller than 16x16 pixels as an ICO without a sizes argument, the image's own size is now used. Previously, none of the default sizes matched, and an ICO containing no images was written. If no size in sizes fits within the image, a ValueError is now raised.
Two new filters are available for ~PIL.Image.Image.resize and ~PIL.Image.Image.thumbnail: Image.Resampling.MKS2013 and Image.Resampling.MKS2021. These are versions of the Magic Kernel Sharp filter.
~PIL.Image.Image.getxmp now accepts an optional keyword argument of strip_namespaces. It is set to True by default, stripping each tag's XML namespace URI prefix as before. If set to False, each tag's full {namespace-uri}local-name form is kept instead, avoiding collisions between tags that share a local name across different namespaces.
~PIL.PSDraw.PSDraw.text now accepts a keyword-only boolean argument, escape. Set it to True to escape backslashes, for example in Windows paths. The default, False, preserves the existing handling of backslashes and PostScript escape sequences.
~PIL.ImageOps.invert, ~PIL.ImageOps.posterize and ~PIL.ImageOps.solarize now support P mode images. The operation is applied to the palette colors, leaving any alpha values in the palette unchanged. Previously, these functions raised NotImplementedError for P mode.
~PIL.ImageFont.load, ~PIL.ImageFont.load_path and ~PIL.FontFile.FontFile.save now accept os.PathLike objects, such as pathlib.Path, in addition to strings.
Pillow 12.3.0 had wheels built against Python 3.15 beta, available as a preview to help projects prepare for 3.15, and to ensure Pillow could be used immediately at the release of 3.15.0 final (2026-10-01, 790).
Pillow 13.0.0 now officially supports Python 3.15.
Importing Pillow takes around half the time it did in Pillow 12.3.0. PIL.Image no longer imports logging, modules that are only needed for some operations, such as tempfile, are now imported on first use, and on Python 3.15 Pillow also declares __lazy_modules__ to defer its remaining standard library imports (810). On an Apple Silicon Mac, from PIL import Image took 24 ms on Python 3.14 and 23 ms on Python 3.15 with Pillow 12.3.0, and now takes 12 ms and 10 ms.
Wheels are now also built for PyPy 3.12, in addition to PyPy 3.11.
Several of the libraries bundled in the macOS and Linux wheels were built without compiler optimisation. The Windows wheels were not affected.
These libraries are now compiled with -O2. Compared to Pillow 12.3.0, the wheels
decode JPEG 2000 images 2 to 3 times faster and encode them about twice as fast,
read and write LZW-compressed TIFF images about twice as fast,
render text with ~PIL.ImageFont up to 3 times faster, and
apply ~PIL.ImageCms transforms up to 3 times faster.
PNG, JPEG, WebP and AVIF are unaffected, as those libraries were already built with optimisation.
Building on the optimizations in Pillow 12.3.0, more of the C code has been restructured so that compilers can vectorize it. Compared to Pillow 12.3.0, ~PIL.ImageChops.offset is up to 46 times faster, ~PIL.Image.Image.getbbox up to 24 times faster, flipping and rotating by 180 degrees with ~PIL.Image.Image.transpose up to 10 times faster, ~PIL.Image.Image.filter up to 3.5 times faster, ~PIL.ImageChops.difference up to 3 times faster, and converting P and PA images to RGB and RGBA up to 2.5 times faster. Saving an optimized GIF with a shared palette is around 6 times faster and uses less memory.
FreeType can use HarfBuzz to work out which glyphs a script covers, so that its auto-hinter can derive hinting "Blue Zones" for scripts such as Arabic.
Only the Windows wheels were actually built with this support. The macOS wheels disabled HarfBuzz interoperability outright, and the Linux wheels left it up to FreeType's configure, which in turn fell back to loading HarfBuzz by its unversioned name at runtime.
Since the bundled copy of HarfBuzz is renamed when the wheel is audited and repaired for distribution, that lookup only succeeded if a separate copy happened to be installed on the system with the expected name (e.g. libharfbuzz.so.0).
All wheels are now linked against the HarfBuzz that Pillow ships, which may slightly change how text is rendered in scripts that rely on the auto-hinter.
Critical sections now protect most operations on core image objects, such as conversion, pasting, filtering and pixel access, improving thread safety in the free-threaded build of Python. AVIF decoding also no longer blocks other threads.
The reducing_gap argument to ~PIL.Image.Image.resize is now applied to RGBA and LA images. Previously, these modes ignored the argument, including when called by ~PIL.Image.Image.thumbnail, which uses reducing_gap=2.0 by default.
When the height of an image is being reduced significantly more than the width, ~PIL.Image.Image.resize now resamples vertically before horizontally, to improve performance. Because intermediate values are rounded between the two passes, pixels may be altered slightly with this change.
~PIL.ImageOps.pad and ~PIL.ImageOps.expand now preserve the transparency value from the source image's info dictionary. Transparent pixels in L, P and RGB images previously became opaque when a border was added. New palette colors are allocated without using reserved transparency entries.
FITS data is big-endian, but Pillow was reading 16-bit and 32-bit integer data, and 32-bit and 64-bit floating point data, in the native byte order. These images now load with the correct pixel values.
Applying a kernel filter to an I;16 image gave incorrect results for pixel values above 255, and converting an I;16N image to I or F clipped values to 255. Both now preserve the full 16-bit range.
An APNG file can only contain a single palette. When saving P mode frames with different palettes, the image is now saved as RGB, or RGBA if any palette contains alpha, instead of writing the later frames with the wrong colors.
Fixed a floating-point rounding error that may have produced a negative variance in ~PIL.ImageStat.Stat.var.
~PIL.ImageChops.offset now works correctly for 16-bit-per-channel images.
When drawing on an I;16B image, some drawing methods wrote in the wrong byte order. All drawing operations now use the byte order of the image mode.
When ~PIL.Image.Image.histogram was given a mask for a two-band image (LA, La or PA), the second band was incorrectly derived from the first band of the input image, rather than the alpha band.
Exporting an image as an Arrow array assumed that its rows were contiguous. However, this was not the case for
images whose rows were padded to an alignment returned incorrect data,
empty images,
images created by ~PIL.Image.frombuffer, and
images memory-mapped from uncompressed files.
These images crashed instead.
Images with rows that are not contiguous now raise a ValueError, and the others are exported correctly.
Saving identical consecutive GIF frames no longer raises a KeyError when an earlier frame has no duration and a later frame does.
When saving a P mode image as a PNG with the bits argument, Pillow used to pad the PLTE chunk with zeroes up to 2 ** bits entries. The PLTE chunk now only contains as many entries as the image's palette actually has, matching the behavior already used when bits is not specified.
If processing a frame in ~PIL.ImageSequence.all_frames raises an exception, the given image will now seek back to its original frame.
TIFF saving now explicitly cleans up the libtiff encoder, including when saving raises an exception. Previously, delayed encoder destruction could access a closed file descriptor after it had been reused for another file, disturbing that file's position or contents.
~PIL.Image.Image.tobytes also now explicitly cleans up its encoder on both success and failure, rather than relying on object destruction.
When seeking to a layer of a PSD image, the pixel data was read from the wrong position in the file, so ~PIL.Image.Image.seek returned unrelated bytes reinterpreted as image data instead of that layer's actual content.
XBM images with C-style /* ... */ comments in the header could not be identified. Comments on separate lines before the bits declaration are now skipped.
The SBOM published with Pillow 12.3.0 listed the vendored FriBiDi shim (src/thirdparty/fribidi-shim/) as LGPL-2.1-or-later. The shim was written for Pillow and is covered by Pillow's MIT-CMU license. Its header declares the parts of FriBiDi's public API needed to load FriBiDi at runtime, and contains no FriBiDi code. FriBiDi itself is not included in Pillow's wheels.
The shim's source files now include SPDX license identifiers, and the SBOM has been corrected.
~PIL.ImagePath.Path.compact is documented to return the number of points removed. On a path with no points, it instead added a point whose y coordinate was read from uninitialized memory, and returned -1. compact() now leaves an empty path unchanged and returns 0.
Add security release notes #9741 [ @radarhere ]
https://pillow.readthedocs.io/en/stable/releasenotes/12.3.0.html
tox -e lint instead of pytest #9670 [@hugovk]Image.filter() #9736 [@akx]Image.getchannel(), Image.merge(), Image.putalpha() and Image.split() #9675 [@akx]Image.fill(), Image.linear_gradient() and Image.radial_gradient(). #9737 [@akx]Image.resample() #9739 [@akx]alpha_composite, matrix, negative, quantize #9740 [@akx]Image.blend() #9649 [@akx]IFDRational.__float__() return value #9676 [@nyxst4ck]Note truncated.
When parsing a PDF, PdfStream.decode() attempts to decompress data without any limit. A default maximum of ImageFile.SAFEBLOCK has been added. PdfParser was added in Pillow 5.1.0. Reported by redyank.
If an attacker has control over the path passed to ImageShow.WindowsViewer.get_command(), and the result is executed by the user, the attacker may be able to execute arbitrary shell commands. Reported by Bin Luo, University of Electronic Science and Technology of China (luob87709@gmail.com).
If a negative byte count is specified for the BeginBinary byte count, an infinite loop is possible as Pillow seeks repeatedly backwards. This value will now be validated. BeginBinary parsing was only added in Pillow 12.0.0. Reported by jiagongzheng-stack.
The total component width was incorrectly accumulated across tiles within a JPEG2000 image, potentially leading to excessive memory use. This was introduced as part of an earlier security fix in Pillow 8.2.0, but has now been fixed. Reported by Fr3v1.
McIdas images can specify the stride, and if incorrectly set, may cause an OOB read. This has been fixed. Reported by Devansh Shah, RUDRA Cybersecurity Pvt. Ltd.
Saving 1 mode images as TGA with run-length encoding can trigger an OOB read. This was added in Pillow 5.2.0, but the functionality is not possible under the TGA specification, so it has been removed. Reported by Seratov.
~PIL.ImageFilter.RankFilter, and its subclasses, can potentially write out-of-bounds if given a large size. This has been fixed. Reported by Seratov.
Large paste box dimensions can cause an OOB write in Image.crop(), Image.paste() and Image.alpha_composite(). This has been fixed. Reported by Seratov.
Apply a transform mode to a different image mode can trigger an OOB write in ImageCmsTransform. Errors are now raised if the mode does not match. Reported by Seratov.
Decompression bomb checks have now been added to ~PIL.FontFile.FontFile, and its subclasses, checking the width and height of characters. Reported by Rahul Singh and Dinesh.
A decompression bomb check has been added to ~PIL.GdImageFile.GdImageFile. This is format must be explicitly called though, rather than being accessible from Image.open(). Reported by Rahul Singh.
~PIL.ImageGrab.grab now accepts an optional keyword argument of scale_down. This affects macOS screenshots with a bbox on a Retina screen. By default, images will be captured at 2x. If scale_down is True, they will be at 1x.
Previously, macOS screenshots with a bbox were captured at 1x by default.
When calling PdfStream.decode(), the maximum length of data to decode can now be specified. This will default to ImageFile.SAFEBLOCK.
To help other projects prepare for Python 3.15, wheels are now built for the 3.15 beta as a preview. This is not official support for Python 3.15, but rather an opportunity for you to test how Pillow works with the beta and report any problems.
Following 770, the Software Bill-of-Materials (SBOM) has now been embedded into Pillow's wheels.
Python 3.13 added an experimental free-threaded mode, and Pillow 11.0.0 added corresponding wheels. Now that Python 3.14 includes official support for it, Pillow has removed wheels for Python 3.13 free-threaded mode.
A number of changes have been made to optimize the use of C when manipulating images. This improves performance by up to 5.6 times of Image's alpha_composite, fill, filter, getchannel, linear_gradient, matrix, merge, negative, putalpha, quantize, radial_gradient, resample, split, and ImageChops operations.
https://pillow.readthedocs.io/en/stable/releasenotes/12.2.0.html
https://pillow.readthedocs.io/en/stable/releasenotes/12.2.0.html
macos-15-intel to macos-26-intel #9454 [@hugovk]_getxy refcount leaks #9487 [@hugovk]setimage() by always passing extents #9395 [@radarhere]self.decode typo #9445 [@bysiber]When decompressing GZIP data from a FITS image, Pillow did not limit the amount of data being read, meaning that it was vulnerable to GZIP decompression bombs. This was introduced in Pillow 10.3.0.
The data being read is now limited to only the necessary amount.
Pillow 12.1.1 addressed 2026-25990 by improving checks for tile extents to prevent an OOB write from specially crafted PSD images in Pillow >= 10.3.0. However, these checks did not consider integer overflow. This has been corrected.
When parsing a PDF, if a trailer refers to itself, or a more complex cyclic loop exists, then an infinite loop occurs. Pillow now keeps a record of which trailers it has already processed. PdfParser was added in Pillow 5.1.0.
If a font advances for each glyph by an exceedingly large amount, when Pillow keeps track of the current position, it may lead to an integer overflow. This has been fixed.
Passing nested lists as coordinates to APIs that accept coordinates such as ImagePath.Path, ~PIL.ImageDraw.ImageDraw.polygon and ~PIL.ImageDraw.ImageDraw.line could cause a heap buffer overflow, as nested lists were recursively unpacked beyond the allocated buffer. Coordinate lists are now validated to contain exactly two numeric coordinates. This was introduced in Pillow 11.2.1.
Attempting to encode an image with zero width or height would previously raise a SystemError. That has now been changed to a ValueError.
This does not add any new errors. SGI, ICNS and ICO formats are still able to save (0, 0) images.
~PIL.FontFile.FontFile instances can now be directly converted to ~PIL.ImageFont.ImageFont instances:
>>> from PIL import PcfFontFile
>>> with open("Tests/fonts/10x20-ISO8859-1.pcf", "rb") as fp:
... pcffont = PcfFontFile.PcfFontFile(fp)
... pcffont.to_imagefont()
...
<PIL.ImageFont.ImageFont object at 0x10457bb80>
.ImageText.Text.wrap has been added, to wrap text to fit within a given width:
from PIL import ImageText
text = ImageText.Text("Hello World!")
text.wrap(50)
print(text.text) # "Hello\nWorld!"
or within a certain width and height, returning a new .ImageText.Text instance if the text does not fit:
text = ImageText.Text("Text does not fit within height")
print(text.wrap(50, 25).text == " within height")
print(text.text) # "Text does\nnot fit"
or scaling, optionally with a font size limit:
text.wrap(50, 15, "shrink")
text.wrap(50, 15, ("shrink", 7))
text.wrap(58, 10, "grow")
text.wrap(50, 50, ("grow", 12))
The EXIF tag FrameRate has been added.
JPEG2000 images with CMYK palettes can now be read. This is the first integration of CMYK palettes into Pillow.
When opening or saving an image, Pillow now lazily loads only the required plugin based on the file extension, instead of importing all plugins upfront. This makes open 2.3-15.6x faster and save 2.2-9x faster for common formats.
Critical sections are now used to protect FreeType font objects, improving thread safety when using fonts in the free-threaded build of Python.
https://pillow.readthedocs.io/en/stable/releasenotes/12.1.1.html
https://pillow.readthedocs.io/en/stable/releasenotes/12.1.1.html
Check that tile extents do not use negative x or y offsets when decoding or encoding, and raise an error if they do, rather than allowing an OOB write.
An out-of-bounds write may be triggered when opening a specially crafted PSD image. This only affects Pillow >= 10.3.0. Reported by Yarden Porat.
A patch has been added to depends/install_libavif.sh, to allow libavif 1.3.0 to be compatible with the recently released svt-av1 4.0.0.
Deprecate getdata(), in favour of new get_flattened_data() #9292 [ @radarhere ]
https://pillow.readthedocs.io/en/stable/releasenotes/12.1.0.html
ResourceWarnings in selftest.py #9332 [@hugovk]~PIL.Image.Image.getdata has been deprecated. ~PIL.Image.Image.get_flattened_data can be used instead. This new method is identical, except that it returns a tuple of pixel values, instead of an internal Pillow data type.
To match the behaviour of ~PIL.ImageMorph.LutBuilder.build_lut, ~PIL.ImageMorph.LutBuilder.build_default_lut() now returns the new LUT.
~PIL.Image.Image.get_flattened_data is identical to the deprecated ~PIL.Image.Image.getdata, except that the new method returns a tuple of pixel values, instead of an internal Pillow data type.
When using ~PIL.ImageGrab.grab, a specific window can now be selected on macOS in addition to Windows. On macOS, this is a CGWindowID:
from PIL import ImageGrab ImageGrab.grab(window=cgwindowid)
~PIL.ImageMorph.MorphOp now supports both 1 mode and L mode images.
Remove deprecations for Pillow 12.0.0 #9053 [ @radarhere ]
https://pillow.readthedocs.io/en/stable/releasenotes/12.0.0.html
Note truncated.
Pillow has dropped support for Python 3.9, which reached end-of-life in October 2025.
ImageFile.raise_oserror() has been removed. The function was undocumented and was only useful for translating error codes returned by a codec's decode() method, which ImageFile already did automatically.
The functions IptcImageFile.dump and IptcImageFile.i, and the constant IptcImageFile.PAD have been removed. These were undocumented helper functions intended for internal use, so there is no replacement. They can each be replaced by a single line of code using builtin functions in Python.
A number of constants and a function in .ImageCms have been removed. This includes a table of flags based on LittleCMS version 1 which has been replaced with a new class .ImageCms.Flags based on LittleCMS 2 flags.
Deprecated |
Use instead |
|---|---|
ImageCms.DESCRIPTION |
No replacement |
ImageCms.VERSION |
PIL.__version__ |
ImageCms.FLAGS["MATRIXINPUT"] |
.ImageCms.Flags.CLUT_POST_LINEARIZATION |
ImageCms.FLAGS["MATRIXOUTPUT"] |
.ImageCms.Flags.FORCE_CLUT |
ImageCms.FLAGS["MATRIXONLY"] |
No replacement |
ImageCms.FLAGS["NOWHITEONWHITEFIXUP"] |
.ImageCms.Flags.NOWHITEONWHITEFIXUP |
ImageCms.FLAGS["NOPRELINEARIZATION"] |
.ImageCms.Flags.CLUT_PRE_LINEARIZATION |
ImageCms.FLAGS["GUESSDEVICECLASS"] |
.ImageCms.Flags.GUESSDEVICECLASS |
ImageCms.FLAGS["NOTCACHE"] |
.ImageCms.Flags.NOCACHE |
ImageCms.FLAGS["NOTPRECALC"] |
.ImageCms.Flags.NOOPTIMIZE |
ImageCms.FLAGS["NULLTRANSFORM"] |
.ImageCms.Flags.NULLTRANSFORM |
ImageCms.FLAGS["HIGHRESPRECALC"] |
.ImageCms.Flags.HIGHRESPRECALC |
ImageCms.FLAGS["LOWRESPRECALC"] |
.ImageCms.Flags.LOWRESPRECALC |
ImageCms.FLAGS["GAMUTCHECK"] |
.ImageCms.Flags.GAMUTCHECK |
ImageCms.FLAGS["WHITEBLACKCOMPENSATION"] |
.ImageCms.Flags.BLACKPOINTCOMPENSATION |
ImageCms.FLAGS["BLACKPOINTCOMPENSATION"] |
.ImageCms.Flags.BLACKPOINTCOMPENSATION |
ImageCms.FLAGS["SOFTPROOFING"] |
.ImageCms.Flags.SOFTPROOFING |
ImageCms.FLAGS["PRESERVEBLACK"] |
.ImageCms.Flags.NONEGATIVES |
ImageCms.FLAGS["NODEFAULTRESOURCEDEF"] |
.ImageCms.Flags.NODEFAULTRESOURCEDEF |
ImageCms.FLAGS["GRIDPOINTS"] |
.ImageCms.Flags.GRIDPOINTS() |
ImageCms.versions() |
PIL.features.version_module with feature="littlecms2", sys.version or sys.version_info, and PIL.__version__ |
ImageMath.eval() has been removed. Use ~PIL.ImageMath.lambda_eval or ~PIL.ImageMath.unsafe_eval instead.
The experimental BGR;15, BGR;16 and BGR;24 modes have been removed.
The use in .ImageCms of input modes and output modes that are not Pillow image modes has been removed. Defaulting to "L" or "1" if the mode cannot be mapped has also been removed.
Support for LibTIFF earlier than version 4 has been removed. Upgrade to a newer version of LibTIFF instead.
The hints parameter in ~PIL.ImageDraw.getdraw() has been removed.
Support for FreeType 2.9.0 has been removed. FreeType 2.9.1 is the minimum version supported.
We recommend upgrading to at least FreeType 2.10.4, which fixed a severe vulnerability introduced in FreeType 2.6 (2020-15999).
Image._show has been deprecated, and will be removed in Pillow 13 (2026-10-15). Use ~PIL.ImageShow.show instead.
ImageCms.ImageCmsProfile.product_name and the corresponding .product_info attributes have been deprecated, and will be removed in Pillow 13 (2026-10-15). They have been set to None since Pillow 2.3.0.
~PIL.Image.alpha_composite can now use LA images as well as RGBA.
PIL.ImageText.Text has been added, as a simpler way to use fonts with text strings or bytes.
Without ImageText.Text:
from PIL import Image, ImageDraw im = Image.new(mode, size) d = ImageDraw.Draw(im) d.textlength(text, font, direction, features, language, embedded_color) d.multiline_textbbox(xy, text, font, anchor, spacing, align, direction, features, language, stroke_width, embedded_color) d.text(xy, text, fill, font, anchor, spacing, align, direction, features, language, stroke_width, stroke_fill, embedded_color)
With ImageText.Text:
from PIL import ImageText text = ImageText.Text(text, font, mode, spacing, direction, features, language) text.embed_color() text.stroke(stroke_width, stroke_fill) text.get_length() text.get_bbox(xy, anchor, align) im = Image.new(mode, size) d = ImageDraw.Draw(im) d.text(xy, text, fill, anchor=anchor, align=align)
Pillow 11.3.0 had wheels built against Python 3.14 beta, available as a preview to help others prepare for 3.14, and to ensure Pillow could be used immediately at the release of 3.14.0 final (2025-10-07, 745).
Pillow 12.0.0 now officially supports Python 3.14.
In Pillow 11.3.0, the mode parameter in ~PIL.Image.fromarray() was deprecated. Part of this functionality has been restored in Pillow 12.0.0. Since pixel values do not contain information about palettes or color spaces, the parameter can be used to place grayscale L mode data within a P mode image, or read RGB data as YCbCr for example.
Valid ImageMorph operations are 4, N, 1 and M. By limiting the length to 1 character within Pillow, long execution times can be avoided if a user provided long pattern strings. Reported by Jang Choi.
One column per quarter.