==================
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.

Installing on Linux
~~~~~~~~~~~~~~~~~~~

Ubuntu 11.04
````````````

.. todo::
    Notes on installing on Ubuntu 11.04

Installing on Mac OS X
~~~~~~~~~~~~~~~~~~~~~~

.. todo::
    Notes on installing on Mac OS X

Installing on Windows
~~~~~~~~~~~~~~~~~~~~~

.. todo::
    Notes on installing on Windows machines