6.1.0

Deprecations

Image.del

Deprecated since version 6.1.0.

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 adeterministic way.

Deprecated:

  1. im = Image.open("hopper.png")
  2. im.save("out.jpg")

Use instead:

  1. with Image.open("hopper.png") as im:
  2.     im.save("out.jpg")

API Additions

Image.entropy

Calculates and returns the entropy for the image. A bilevel image (mode “1”) is treatedas a greyscale (“L”) image by this method. If a mask is provided, the method employsthe histogram for those parts of the image where the mask image is non-zero. The maskimage must have the same size as the image, and be either a bi-level image (mode “1”) ora greyscale image (“L”).

ImageGrab.grab

An optional include_layered_windows parameter has been added to ImageGrab.grab,defaulting to False. If true, layered windows will be included in the resultingimage on Windows.

ImageSequence.all_frames

A new method to facilitate applying a given function to all frames in an image, or toall 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

Variation fonts are now supported, allowing for different styles from the same fontfile. ImageFont.FreeTypeFont has four new methods,PIL.ImageFont.FreeTypeFont.get_variation_names() andPIL.ImageFont.FreeTypeFont.set_variation_by_name() for using named styles, andPIL.ImageFont.FreeTypeFont.get_variation_axes() andPIL.ImageFont.FreeTypeFont.set_variation_by_axes() for using font axesinstead. An IOError will be raised if the font is not a variation font. FreeType2.9.1 or greater is required.

Other Changes

ImageTk.getimage

This function is now supported. It returns the contents of an ImageTk.PhotoImage asan RGBA Image.Image instance.

Image quality for JPEG compressed TIFF

The TIFF encoder accepts a quality parameter for jpeg compressed TIFF files. Avalue from 0 (worst) to 100 (best) controls the image quality, similar to the JPEGencoder. The default is 75. For example:

  1. im.save("out.tif", compression="jpeg", quality=85)

Improve encoding of TIFF tags

The TIFF encoder supports more types, especially arrays. This is required for theGeoTIFF 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 with64-bit longs.
  • Add support for multiple values (arrays). Requires type in v2 directory and valuesmust be passed as a tuple.
  • Add support for signed types eg. TIFFTypes.TIFF_SIGNED_SHORT.

Respect PKG_CONFIG environment variable when building

This variable is commonly used by other build systems and using it can help withcross-compiling. Falls back to pkg-config as before.

Top-to-bottom complex text rendering

Drawing text in the ‘ttb’ direction with ImageFont has been significantly improvedand requires Raqm 0.7 or greater.