Python Imaging Library (PIL) v.1.1.7 全平台安装指南
PIL使你的Python解释器具有强大的图像处理功能，同时本库支持多种文件格式。
-
极简安装：
$ tar xvfz Imaging-1.1.7.tar.gz
$ cd Imaging-1.1.7
$ Python setup.py install
指令的解释见下文
-
安装要求
如果需要实现以下功能，请确保在安装PIL库以前搭建好相关的库
| 功能 | 需要的库 |
|---|---|
| jpeg支持 | libjpeg (6a or 6b) http://www.ijg.org http://www.ijg.org/files/jpegsrc.v6b.tar.gz ftp://ftp.uu.net/graphics/jpeg |
| PNG支持 | zlib (推荐v1.2.3及以后的版本) http://www.gzip.org/zlib/ |
| OpenType/TrueType支持 | freetype2 (推荐v2.3.9及以后的版本) http://www.freetype.org http://freetype.sourceforge.net |
| CMS support支持 | littleCMS (推荐v1.1.5及以后的版本)http://www.littlecms.com/ |
如果你使用的是较新的Linux版本，系统提供的库则满足上述功能的要求。
如果缺少库，安装devel版本会更简便。
比如在Ubuntu 9.10(karmic)下，可以安装下面的库：
$ sudo apt-get install libjpeg62-dev
$ sudo apt-get install zlib1g-dev
$ sudo apt-get install libfreetype6-dev
$ sudo apt-get install liblcms1-dev
如果使用Mac OS X系统，可以使用fink工具来安装缺少的库（参见下方Mac OS X部分）
许多其他平台也有类似的工具。
-
在Python 1.5.2版本下搭建PIL需要另外安装distutils库
distuils库：
http://www.Python.org/sigs/distutils-sig/download.html
distutils 1.0.2 可以从Python资源存放处中获取：
svn export http://svn.Python.org/projects/Python/tags/Distutils-1_0_2/Lib/distutils/
在更新版本的Python内，distuitils库已经包含在了Python标准库中
注： PIL 1.1.7版本和Python 1.5.2版本
不完全兼容。部分PIL库最新的增加内容也许无法正常工作，但是核心功能是正常的。
-
如果Python不从源下载的
确保计算机内有Python的搭建支持文件。如果你已下载了预建包（比如Linux RPM），你也许会需要额外的开发者包——”Python-dev”,”Python-devel”或其他类似的包。在Ubuntu 9.10(karmic)下，可以使用以下指令：确保计算机内有Python的搭建支持文件。如果你已下载了预建包（比如Linux RPM），你也许会需要额外的开发者包——”Python-dev”,”Python-devel”或其他类似的包。在Ubuntu 9.10(karmic)下，可以使用以下指令：
sudo apt-get install Python-dev
-
解压文件 Imaging-1.1.7.tar.gz至合适路径
$ cd MyExtensions #example
$ gunzip Imaging-1.1.7.tar.gz
$ tar xvf Imaging-1.1.7.tar
-
搭建库
我们推荐在Python目录内搭建，并且在安装前进行自我检测。我们推荐在Python目录内搭建，并且在安装前进行自我检测。
$ cd Imaging-1.1.7
$ Python setup.py build-ext -i
$ Python selftest.py
在搭建期间，setup.py会显示含有所有检测到的外部内容的报告。selftest.py则会显示检测到的在实际搭建文件中外部内容的报告。
————————————————————————————————
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
————————————————————————————————
确保选装的部分已经包含在其中。
如果在搭建脚本的时候找不到选中的部分，可以编辑setup.py文件，设置一个适当的root变量。更多细节见“指令”部分。
如果搭建脚本找到了这部分，但是检测的时候没有识别出来，可以尝试重建all模块：
$ Python setup.py clean
$ Python setup.py build_ext -i
- 搭建PIL库
若setup.py和selftest.py指令可以正常运行，接下来可以搭建PIL库了：若setup.py和selftest.py指令可以正常运行，接下来可以搭建PIL库了：
$ Python setup.py install
Python的安装环境不同，安装的方式也不同，有的可能需要先登录为超权限账户然后进行安装指令，有的需要用sudo指令运行安装。
另注：
- Mac OS X： 用户通常需要通过fink工具安装额外的软件，比如libjpeg或者是freetype，其后缀为”./sw”。如果用户已经在别处安装过本库，在搭建本库以前也许需要对setup.py进行调整。
- Windows：为了让setup.py文件检测到第三方库，需要调整setup.py里的ROOT设置。更多详情请见该文件内的注释。请确保将与Python解释器相同的运行连接设置用于搭建PIL库和其他第三方库。（/MD, 在Visual Studio内）
大部分Windows的Python发行版本都包括了为微软Visual Studio编译的库。
免费特快版本的VS获取链接：
http://www.microsoft.com/Express/
使用其他的工具搭建拓展，请见distuitils手册“在Windows上使用非微软编译器”部分：http://www.Python.org/doc/current/inst/non-ms-comPILers.html
更多有关如何使用MinGW编译器搭建拓展的信息，请见：
http://mingw.org (comPILer)
http://sebsauvage.net/Python/mingw.html (build instructions)
http://sourceforge.net/projects/gnuwin32 (prebuilt libraries)