mirror of
https://github.com/kennethreitz/python-guide.git
synced 2026-06-05 23:00:18 +00:00
Gordon Senesac Jr
60 lines
1.6 KiB
ReStructuredText
60 lines
1.6 KiB
ReStructuredText
==================
|
|
Image Manipulation
|
|
==================
|
|
|
|
.. todo::
|
|
Add introduction about image manipulation and its Python libraries.
|
|
|
|
Python Imaging Library
|
|
----------------------
|
|
|
|
The `Python Imaging Library <http://www.pythonware.com/products/pil/>`_, or PIL
|
|
for short, is *the* library for image manipulation in Python. Unfortunately,
|
|
its development has stagnated, with its last release in 2009.
|
|
|
|
Luckily for you, there's an actively-developed fork of PIL called
|
|
`Pillow <http://python-pillow.github.io/>`_ - it's easier to install, runs on
|
|
all operating systems, and supports Python 3.
|
|
|
|
Installation
|
|
~~~~~~~~~~~~
|
|
|
|
Before installing Pillow, you'll have to install Pillow's prerequisites. Find
|
|
the instructions for your platform
|
|
`here <https://pillow.readthedocs.org/en/3.0.0/installation.html>`_.
|
|
|
|
After that, it's straightforward:
|
|
|
|
.. code-block:: console
|
|
|
|
$ pip install Pillow
|
|
|
|
Example
|
|
~~~~~~~
|
|
|
|
.. code-block:: python
|
|
|
|
from PIL import Image, ImageFilter
|
|
#Read image
|
|
im = Image.open( 'image.jpg' )
|
|
#Display image
|
|
im.show()
|
|
|
|
#Applying a filter to the image
|
|
im_sharp = im.filter( ImageFilter.SHARPEN )
|
|
#Saving the filtered image to a new file
|
|
im_sharp.save( 'image_sharpened.jpg', 'JPEG' )
|
|
|
|
#Splitting the image into its respective bands, i.e. Red, Green,
|
|
#and Blue for RGB
|
|
r,g,b = im_sharp.split()
|
|
|
|
#Viewing EXIF data embedded in image
|
|
exif_data = im._getexif()
|
|
exif_data
|
|
|
|
There are more examples of the Pillow library
|
|
`here <http://pillow.readthedocs.org/en/3.0.x/handbook/tutorial.html>`_.
|
|
|
|
|