kennethreitz/python-guide
1
0
Fork 0
mirror of https://github.com/kennethreitz/python-guide.git synced 2026-06-05 23:00:18 +00:00
Code Issues Packages Projects Releases Wiki Activity

Completely recommend Pillow over PIL.

Browse Source
This commit is contained in:
kuyan
2013-07-30 00:06:29 -07:00
parent 2fbb7ddf3f
commit 63fecf8808
1 changed files with 8 additions and 55 deletions
Download Patch File Download Diff File Expand all files Collapse all files
docs/scenarios/imaging.rst
+8 -55
View File
@@ -9,67 +9,20 @@ Python Imaging Library
---------------------- ----------------------
The `Python Imaging Library <http://www.pythonware.com/products/pil/>`_, or PIL The `Python Imaging Library <http://www.pythonware.com/products/pil/>`_, or PIL
for short, is *the* library for image manipulation in Python. for short, is *the* library for image manipulation in Python. Unfortunately, its
development has stagnated, with its last release in 2009.
It works with Python 1.5.2 and above, including 2.5, 2.6 and 2.7. Unfortunately, Lucky for you, there's an actively-developed fork of PIL called `Pillow <http://python-imaging.github.io/>`_ -
it doesn't work with 3.0+ yet. it's easier to install, runs on all operating systems, and supports Python 3.
Installation Installation
~~~~~~~~~~~~ ~~~~~~~~~~~~
PIL has a reputation of not being very straightforward to install. Listed below Before installing Pillow, you'll have to install Pillow's prerequisites. Find
are installation notes on various systems. the instructions for your platform `here <https://pypi.python.org/pypi/Pillow/2.1.0#platform-specific-instructions>`_.
Also, there's a fork named `Pillow <http://pypi.python.org/pypi/Pillow>`_ which After that, it's straightforward:
is easier to install. It has good setup instructions for all platforms and
supports Python 3 (PIL currently does not).
Installing on Linux
~~~~~~~~~~~~~~~~~~~
Arch Linux
``````````
PIL is maintained in the official community repository, and installed with the system installer as:
.. code-block:: bash .. code-block:: bash
$ sudo pacman -S python2-imaging $ pip install Pillow
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