Pillow 2.0.0

Pillow is a fork of the Python Imaging Library (PIL). The goal is to see if any improvement can be made to the packaging situation(*) by opening up development to the "public" and exploring the problem within the fork.

(*) PIL aims to support the 'import Image' statement which will fail whenever there is another 'Image' module in the top level namespace.

For PIL's README, check out PIL.txt

Build instructions (all platforms)

For a list of changes in this release, see the CHANGES document.

If you're in a hurry, try this:

 tar xvfz Imaging-1.1.7.tar.gz
 cd Imaging-1.1.7
 python setup.py install

If you prefer to know what you're doing, read on.

Prerequisites

If you need any of the features described below, make sure you have the necessary libraries before building PIL:

JPEG support libjpeg (6a or 6b)

 http://www.ijg.org
 http://www.ijg.org/files/jpegsrc.v6b.tar.gz
 ftp://ftp.uu.net/graphics/jpeg/

PNG support zlib (1.2.3 or later is recommended)

 http://www.gzip.org/zlib/

OpenType/TrueType freetype2 (2.3.9 or later is recommended)
support
 http://www.freetype.org
 http://freetype.sourceforge.net

CMS support littleCMS (1.1.5 or later is recommended) support

 http://www.littlecms.com/

If you have a recent Linux version, the libraries provided with the operating system usually work just fine. If some library is missing, installing a prebuilt version (jpeg-devel, zlib-devel, etc) is usually easier than building from source. For example, for Ubuntu 9.10 (karmic), you can install the following libraries:

sudo apt-get install libjpeg62-dev
sudo apt-get install zlib1g-dev
sudo apt-get install libfreetype6-dev
sudo apt-get install liblcms1-dev

If you're using Mac OS X, you can use the 'fink' tool to install missing libraries (also see the Mac OS X section below).

Similar tools are available for many other platforms.

To build under Python 1.5.2, you need to install the stand-alone version of the distutils library:

 http://www.python.org/sigs/distutils-sig/download.html

You can fetch distutils 1.0.2 from the Python source repository:

 svn export http://svn.python.org/projects/python/tags/Distutils-1_0_2/Lib/distutils/

For newer releases, the distutils library is included in the Python standard library.

NOTE: Version 1.1.7 is not fully compatible with 1.5.2. Some more recent additions to the library may not work, but the core functionality is available.

If you didn't build Python from sources, make sure you have Python's build support files on your machine. If you've down- loaded a prebuilt package (e.g. a Linux RPM), you probably need additional developer packages. Look for packages named "python-dev", "python-devel", or similar. For example, for Ubuntu 9.10 (karmic), use the following command:

 sudo apt-get install python-dev

When you have everything you need, unpack the PIL distribution (the file Imaging-1.1.7.tar.gz) in a suitable work directory:

 cd MyExtensions # example
 gunzip Imaging-1.1.7.tar.gz
tar xvf Imaging-1.1.7.tar

Build the library. We recommend that you do an in-place build, and run the self test before installing.:

 cd Imaging-1.1.7
 python setup.py build_ext -i
 python selftest.py

During the build process, the setup.py will display a summary report that lists what external components it found. The self- test will display a similar report, with what external components the tests found in the actual build files:

----------------------------------------------------------------
PIL 1.1.7 SETUP SUMMARY
----------------------------------------------------------------
*** TKINTER support not available (Tcl/Tk 8.5 libraries needed)
--- JPEG support available
--- ZLIB (PNG/ZIP) support available
--- FREETYPE support available
----------------------------------------------------------------

Make sure that the optional components you need are included.

If the build script won't find a given component, you can edit the setup.py file and set the appropriate ROOT variable. For details, see instructions in the file.

If the build script finds the component, but the tests cannot identify it, try rebuilding all modules:

 python setup.py clean $ python setup.py build_ext -i

If the setup.py and selftest.py commands finish without any errors, you're ready to install the library:

python setup.py install

(depending on how Python has been installed on your machine, you might have to log in as a superuser to run the 'install' command, or use the 'sudo' command to run 'install'.)


Product's homepage

Requirements:

· Python

What's New in This Release: [ read full changelog ]

· Add Python 3 support. (Pillow >= 2.0.0 supports Python 2.6, 2.7, 3.2, 3.3. Pillow < 2.0.0 supports Python 2.4, 2.5, 2.6, 2.7.) [fluggo]
· Add PyPy support (experimental, please see: https://github.com/python-imaging/Pillow/issues/67)
· Add WebP support. [lqs]
· Add Tiff G3/G4 support (experimental) [wiredfool]
· Backport PIL's PNG/Zip improvements. [olt]
· Various 64 bit and Windows fixes. [cgohlke]
· Add testing suite. [cgohlke, fluggo]
· Added support for PNG images with transparency palette. [d-schmidt]
· Many other bug fixes and enhancements by many other people (see commit log and/or docs/CONTRIBUTORS.txt).
· Special thanks to Christoph Gohlke and Eric Soroos for rallying around the effort to get a release out for PyCon 2013.