mirror of
https://github.com/kennethreitz/python-guide.git
synced 2026-06-05 23:00:18 +00:00
Gergely Imreh
75 lines
1.6 KiB
ReStructuredText
75 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.
|
|
|
|
It works with Python 1.5.2 and above, including 2.5, 2.6 and 2.7. Unfortunately,
|
|
it doesn't work with 3.0+ yet.
|
|
|
|
Installation
|
|
~~~~~~~~~~~~
|
|
|
|
PIL has a reputation of not being very straightforward to install. Listed below
|
|
are installation notes on various systems.
|
|
|
|
Also, there's a fork named `Pillow <http://pypi.python.org/pypi/Pillow>`_ which is easier
|
|
to install. It has good setup instructions for all platforms.
|
|
|
|
Installing on Linux
|
|
~~~~~~~~~~~~~~~~~~~
|
|
|
|
Arch Linux
|
|
``````````
|
|
|
|
PIL is maintained in the official community repository, and installed with the system installer as:
|
|
|
|
.. code-block:: bash
|
|
|
|
$ sudo pacman -S python2-imaging
|
|
|
|
Ubuntu 12.10
|
|
````````````
|
|
|
|
Can be installed on the command line as:
|
|
|
|
.. code-block:: bash
|
|
|
|
$ sudo apt-get install python-imaging
|
|
|
|
|
|
Installing on Mac OS X
|
|
~~~~~~~~~~~~~~~~~~~~~~
|
|
|
|
PIP doesn't know about the Mac OS X Freetype paths. To rectify that:
|
|
|
|
.. code-block:: bash
|
|
|
|
$ ln -s /usr/X11/include/freetype2 /usr/local/include/
|
|
$ ln -s /usr/X11/include/ft2build.h /usr/local/include/
|
|
$ ln -s /usr/X11/lib/libfreetype.6.dylib /usr/local/lib/
|
|
$ ln -s /usr/X11/lib/libfreetype.6.dylib /usr/local/lib/libfreetype.dylib
|
|
|
|
then:
|
|
|
|
.. code-block:: bash
|
|
|
|
$ brew install libjpeg
|
|
$ pip install PIL
|
|
|
|
|
|
Installing on Windows
|
|
~~~~~~~~~~~~~~~~~~~~~
|
|
|
|
.. todo::
|
|
Notes on installing on Windows machines
|
|
|
|
|