ImageOps.rst

.. py:module:: PIL.ImageOps

.. py:currentmodule:: PIL.ImageOps

:py:mod:`~PIL.ImageOps` Module

The :py:mod:`~PIL.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.

.. versionadded:: 1.1.3

.. autofunction:: autocontrast

.. autofunction:: colorize

.. autofunction:: crop

.. autofunction:: scale

.. autoclass:: SupportsGetMesh
    :show-inheritance:

.. autofunction:: deform

.. autofunction:: equalize

.. autofunction:: expand

.. autofunction:: flip

.. autofunction:: grayscale

.. autofunction:: invert

.. autofunction:: mirror

.. autofunction:: posterize

.. autofunction:: solarize

.. autofunction:: exif_transpose

Resize relative to a given size

from PIL import Image, ImageOps
size = (100, 150)
with Image.open("Tests/images/hopper.webp") as im:
    ImageOps.contain(im, size).save("imageops_contain.webp")
    ImageOps.cover(im, size).save("imageops_cover.webp")
    ImageOps.fit(im, size).save("imageops_fit.webp")
    ImageOps.pad(im, size, color="#f00").save("imageops_pad.webp")

    # thumbnail() can also be used,
    # but will modify the image object in place
    im.thumbnail(size)
    im.save("image_thumbnail.webp")

	:py:meth:`~PIL.Image.Image.thumbnail`	:py:meth:`~PIL.ImageOps.contain`	:py:meth:`~PIL.ImageOps.cover`	:py:meth:`~PIL.ImageOps.fit`	:py:meth:`~PIL.ImageOps.pad`
Given size	(100, 150)	(100, 150)	(100, 150)	(100, 150)	(100, 150)
Resulting image
Resulting size	100×100	100×100	150×150	100×150	100×150

.. autofunction:: contain

.. autofunction:: cover

.. autofunction:: fit

.. autofunction:: pad