mirror of
https://github.com/python-pillow/Pillow.git
synced 2025-10-25 05:01:26 +03:00
64 lines
3.5 KiB
ReStructuredText
64 lines
3.5 KiB
ReStructuredText
.. 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
|
||
|
||
.. _relative-resize:
|
||
|
||
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 | .. image:: ../example/image_thumbnail.webp | .. image:: ../example/imageops_contain.webp | .. image:: ../example/imageops_cover.webp | .. image:: ../example/imageops_fit.webp | .. image:: ../example/imageops_pad.webp |
|
||
+----------------+--------------------------------------------+---------------------------------------------+-------------------------------------------+-----------------------------------------+-----------------------------------------+
|
||
|Resulting size | ``100×100`` | ``100×100`` | ``150×150`` | ``100×150`` | ``100×150`` |
|
||
+----------------+--------------------------------------------+---------------------------------------------+-------------------------------------------+-----------------------------------------+-----------------------------------------+
|
||
|
||
.. autofunction:: contain
|
||
.. autofunction:: cover
|
||
.. autofunction:: fit
|
||
.. autofunction:: pad
|