The ImageOps Module

(New in 1.1.3) The ImageOps module contains a number of ‘ready-made’ image processing operations. This module is somewhat experimental, and most operators only work on L and RGB images.

Functions

ImageOps.autocontrast(image, cutoff=0)

Maximize (normalize) image contrast. This function calculates a histogram of the input image, removes cutoff percent of the lightest and darkest pixels from the histogram, and remaps the image so that the darkest remaining pixel becomes black (0), and the lightest becomes white (255).

ImageOps.colorize(image, black, white)

Colorize grayscale image. The black and white arguments should be RGB tuples or color names; this function calculates a colour wedge mapping all black pixels in the source image to the first colour, and all white pixels to the second colour.

ImageOps.crop(image, border=0)

Remove border pixels from all four edges. This function works on all image modes.

ImageOps.deform(image, deformer, filter=Image.BILINEAR)

Deform the image using the given deformer object. The deformer should provide a getmesh method, which returns a MESH list suitable for the Image transform method. See the transform method for details.

ImageOps.equalize(image)

Equalize the image histogram. This function applies a non-linear mapping to the input image, in order to create a uniform distribution of grayscale values in the output image.

ImageOps.expand(image, border=0, fill=0)

Add border pixels of border to the image, at all four edges.

ImageOps.fit()

Returns a sized and cropped version of the image, cropped to the requested aspect ratio and size. The size argument is the requested output size in pixels, given as a (width, height) tuple.

The method argument is what resampling method to use. The default is Image.NEAREST (nearest neighbour).

The bleed argument allows you to remove a border around the outside the image (from all four edges). The value is a decimal percentage (use 0.01 for one percent). The default value is 0 (no border).

The centering argument is used to control the cropping position. (0.5, 0.5) is center cropping (i.e. if cropping the width, take 50% off of the left side (and therefore 50% off the right side), and same with top/bottom).

(0.0, 0.0) will crop from the top left corner (i.e. if cropping the width, take all of the crop off of the right side, and if cropping the height, take all of it off the bottom).

(1.0, 0.0) will crop from the bottom left corner, etc. (i.e. if cropping the width, take all of the crop off the left side, and if cropping the height take none from the top (and therefore all off the bottom)).

The fit function was contributed by Kevin Cazabon.

ImageOps.flip(image)

Flip the image vertically (top to bottom).

ImageOps.grayscale(image)

Convert the image to grayscale.

ImageOps.invert(image)

Invert (negate) the image.

ImageOps.mirror(image)

Flip image horizontally (left to right).

ImageOps.posterize(image, bits)

Reduce the number of bits for each colour channel.

ImageOps.solarize(image, threshold=128)

Invert all pixel values above the given threshold.