警告
Pillow 和 PIL 不能在同一环境中共存。在安装 Pillow 之前,请卸载PIL。
警告
Pillow >=1.0 不再支持 import Image
。请改为使用 from PIL import Image
。
警告
Pillow >=2.1.0不再支持 import _imaging
。请使用 from PIL.Image import core as _imaging
。
注解
下面的python版本支持Pillow
Python | 2.4 | 2.5 | 2.6 | 2.7 | 3.2 | 3.3 | 3.4 | 3.5 | 3.6 | 3.7 |
Pillow <2.0.0 | 是的 | 是的 | 是的 | 是的 | ||||||
Pillow 2.x-3.x | 是的 | 是的 | 是的 | 是的 | 是的 | 是的 | ||||
Pillow 4 | 是的 | 是的 | 是的 | 是的 | 是的 | |||||
Pillow 5.0.x-5.1.x | 是的 | 是的 | 是的 | 是的 | ||||||
Pillow5.2.x-5.4.x | 是的 | 是的 | 是的 | 是的 | 是的 | |||||
Pillow6 | 是的 | 是的 | 是的 | 是的 | ||||||
Pillow>7.0.0 | 是的 | 是的 | 是的 |
注解
以下说明将安装支持最常见图像格式的枕头。见 外部库 获取支持的外部库的完整列表。
安装枕头 pip ::
$ pip install Pillow
我们为Windows提供Pillow二进制文件,这些文件是为32位和64位版本的wheel、egg和可执行安装程序中支持的pythons矩阵编译的。除了raqm和libimagequant,这些二进制文件包含所有可选库:
> pip install Pillow
我们为每个受支持的Python版本提供MacOS二进制文件,格式为wheel。其中包括对除libImageQuant之外的所有可选库的支持。RAQM支持要求分别安装libraqm、fribidi和harfbuzz:
$ pip install Pillow
我们以manylinux车轮格式为每个受支持的python版本提供Linux二进制文件。其中包括对除libImageQuant之外的所有可选库的支持。RAQM支持要求分别安装libraqm、fribidi和harfbuzz:
$ pip install Pillow
大多数主要的Linux发行版,包括Fedora、Debian/Ubuntu和ArchLinux,也包括以前包含pil的包中的枕头。 python-imaging
.
Pillow可通过官方端口或包装系统安装在Freebsd上:
Ports:
$ cd /usr/ports/graphics/py-pillow && make install clean
Packages:
$ pkg install py27-pillow
注解
这个 Pillow FreeBSD port 端口团队使用所有支持的freebsd版本和python 2.7和3.x对包进行测试。
下载并提取 compressed archive from PyPI .
注解
你 do not need to install all supported external libraries 使用枕头的基本功能。 Zlib 和 libjpeg 默认情况下是必需的。
注解
其中包含一些操作系统的依赖项安装脚本。 depends
目录。还可以在我们的 docker images repo .
Pillow的许多功能都需要外部库:
--disable-jpeg
旗帜。--disable-zlib
旗帜。安装完前提条件后,运行:
$ pip install Pillow
如果先决条件安装在计算机的标准库位置(例如 /usr
或 /usr/local
)不需要其他配置。如果安装在非标准位置,则可能需要通过编辑配置安装工具来使用这些位置。 setup.py
或 setup.cfg
或者通过在命令行中添加环境变量:
$ CFLAGS="-I/usr/pkg/include" pip install pillow
如果枕头以前是在没有必要的前提条件下构建的,则可能需要手动清除PIP缓存或使用 --no-cache-dir
使用新安装的外部库强制生成的选项。
MAX_CONCURRENCY=n
. 默认情况下,枕头将使用多处理在所有可用的CPU上构建扩展,但不超过4个。设置 MAX_CONCURRENCY
到1将禁用并行构建。--disable-zlib
, --disable-jpeg
, --disable-tiff
, --disable-freetype
, --disable-lcms
, --disable-webp
, --disable-webpmux
, --disable-jpeg2000
, --disable-imagequant
. 禁用生成相应的功能,即使生成计算机上存在开发库。--enable-zlib
, --enable-jpeg
, --enable-tiff
, --enable-freetype
, --enable-lcms
, --enable-webp
, --enable-webpmux
, --enable-jpeg2000
, --enable-imagequant
. 要求生成相应的功能。如果未找到库,则生成将引发异常。webpmux(webp元数据)依赖于webp支持。tcl和tk也必须一起使用。--disable-platform-guessing
. 跳过所有与平台相关的对自动构建系统的include和library目录的猜测,这些系统在环境变量(例如buildRoot)中配置正确的路径。--debug
. 将调试标志添加到include和library搜索进程,以转储搜索到的所有路径并找到stdout。样品使用情况:
$ MAX_CONCURRENCY=1 python setup.py build_ext --enable-[feature] install
或使用PIP:
$ pip install pillow --global-option="build_ext" --global-option="--enable-[feature]"
Xcode命令行工具是编译枕头部分所必需的。通过运行安装工具 xcode-select --install
从命令行。即使安装了完整的Xcode包,也需要使用命令行工具。可能需要跑步 sudo xcodebuild -license
在使用工具之前接受许可证。
安装外部库的最简单方法是通过 Homebrew . 安装自制啤酒后,运行:
$ brew install libtiff libjpeg webp little-cms2
要在MacOS上安装libraqm,请使用homebrew安装其依赖项:
$ brew install freetype harfbuzz fribidi
然后看到 depends/install_raqm_cmake.sh
安装libraqm。
现在安装Pillow:
$ pip install Pillow
或者从未压缩的源目录中:
$ python setup.py install
我们不建议尝试在Windows上构建。这是一个曲折的通道迷宫,大部分是死胡同。中有Windows内部版本的生成脚本和注释 winbuild
目录。
注解
仅对FreeBSD 10和11进行测试
确保安装了Python的开发库。::
$ sudo pkg install python2
或者对于python 3::
$ sudo pkg install python3
系统必备安装在 FreeBSD 10 or 11 用:
$ sudo pkg install jpeg-turbo tiff webp lcms2 freetype2 openjpeg harfbuzz fribidi
然后看到 depends/install_raqm_cmake.sh
安装libraqm。
如果您没有从源代码构建python,请确保安装了python的开发库。
在Debian或Ubuntu中:
$ sudo apt-get install python-dev python-setuptools
或者对于python 3::
$ sudo apt-get install python3-dev python3-setuptools
在费多拉,命令是:
$ sudo dnf install python-devel redhat-rpm-config
或者对于python 3::
$ sudo dnf install python3-devel redhat-rpm-config
注解
redhat-rpm-config
is required on Fedora 23, but not earlier versions.
系统必备安装在 Ubuntu 14.04 LTS 用:
$ sudo apt-get install libtiff5-dev libjpeg8-dev zlib1g-dev \
libfreetype6-dev liblcms2-dev libwebp-dev libharfbuzz-dev libfribidi-dev \
tcl8.6-dev tk8.6-dev python-tk
然后看到 depends/install_raqm.sh
安装libraqm。
系统必备安装在最近 RedHat CENTOS**或 **Fedora 用:
$ sudo dnf install libtiff-devel libjpeg-devel zlib-devel freetype-devel \
lcms2-devel libwebp-devel tcl-devel tk-devel libraqm-devel \
libimagequant-devel
请注意,包管理器可能是yum或dnf,这取决于确切的分布。
也见 Dockerfile
在测试基础结构repo(https://github.com/python-bellow/docker-images)中,为其他测试的发行版提供已知的工作安装过程。
添加了基本的Android支持,以便在TermUX环境中进行编译。依赖项可以通过以下方式安装:
$ pkg -y install python python-dev ndk-sysroot clang make \
libjpeg-turbo-dev
这已经在Chromeos的termux应用程序中进行了测试。
当前平台支撑Pillow。二进制发行版是在自愿的基础上为每个版本提供的,但是源代码应该编译并在列出平台支持的任何地方运行。一般来说,我们的目标是支持Linux、MacOS和Windows的所有当前版本。
这些平台是为每一个变化而构建和测试的。
操作系统 | 测试过的python版本 | 经过测试的体系结构 |
阿尔卑斯山的 | 2.7 | X86—64 |
拱门 | 2.7 | X86—64 |
亚马逊 | 2.7 | X86—64 |
CITOS 6 | 2.7 | X86—64 |
CITOS 7 | 2.7 | X86—64 |
德比拉伸 | 2.7 | x86 |
费多拉28 | 2.7 | X86—64 |
费多拉29 | 2.7 | X86—64 |
Mac OS X 10.10约塞米蒂* | 2.7、3.5、3.6、3.7条 | X86—64 |
Ubuntu Linux 16.04 LTS版 | 2.7、3.5、3.6、3.7、Pypy、Pypy3 | X86—64 |
Ubuntu Linux 14.04 LTS版 | 2.7、3.5、3.6 | X86—64 |
2.7 | x86 | |
Windows Server 2012 R2 | 2.7、3.5、3.6、3.7条 | X86、X86—64 |
PyPy,3.7/MIW | x86 |
*mac os x ci不是针对每个提交运行的,而是针对每个发布运行的。
据报道,这些平台可以在上述版本上工作。
注解
参与者请在您的平台上测试Pillow,然后更新此文档并发送请求。
操作系统 | 测试过的python版本 | 最新测试Pillow版本 | 已测试的处理器 |
Macos 10.14莫哈韦 | 2.7、3.4、3.5、3.6、3.7 | 5.4.1 | X86—64 |
Macos 10.13 Sierra高地 | 2.7、3.4、3.5、3.6 | 4.2.1 | X86—64 |
马科斯10.12塞拉 | 2.7、3.4、3.5、3.6 | 4.1.1工程 | X86—64 |
Mac OS X 10.11 El Capitan | 2.7、3.4、3.5、3.6、3.7 | 5.4.1 | X86—64 |
3.3 | 4.1.0节 | ||
Mac OS X 10.9 Mavericks | 2.7、3.2、3.3、3.4 | 3.0.0 | X86—64 |
Mac OS X 10.8山地狮 | 2.6、2.7、3.2、3.3 | X86—64 | |
红帽Linux 6 | 2.6 | x86 | |
CITOS 6.3 | 2.7,3.3 | x86 | |
费多拉23 | 2.7,3.4 | 3.1.0 | X86—64 |
Ubuntu Linux 12.04 LTS版 | 2.6、3.2、3.3、3.4、3.5 PYPY5.3.1、PYPY3 v2.4.0 | 3.4.1 | X86、X86—64 |
2.7 | 4.3.0 | X86—64 | |
2.7,3.2 | 3.4.1 | 聚合氯化铝 | |
Ubuntu Linux 10.04 LTS版 | 2.6 | 2.3.0 | X86、X86—64 |
Debian 8.2杰西 | 2.7,3.4 | 3.1.0 | X86—64 |
拉斯比杰西 | 2.7,3.4 | 3.1.0 | 臂 |
拉氏伸展 | 2.7,3.5 | 4.0.0 | 臂 |
GUTOU-Linux | 2.7,3.2 | 2.1.0 | X86—64 |
FreeBSD 11.1 | 2.7、3.4、3.5、3.6 | 4.3.0 | X86—64 |
FreeBSD 10.3 | 2.7、3.4、3.5 | 4.2.0 | X86—64 |
FreeBSD 10.2 | 2.7,3.4 | 3.1.0 | X86—64 |
Windows 8.1专业版 | 2.6、2.7、3.2、3.3、3.4 | 2.4.0 | X86、X86—64 |
Windows 8专业版 | 2.6、2.7、3.2、3.3、3.4A3 | 2.2.0 | X86、X86—64 |
Windows 7专业版 | 2.7、3.2、3.3 | 3.4.1 | X86—64 |
Windows Server 2008 R2企业版 | 3.3 | X86—64 |
您可以从 release history at PyPI 通过直接的URL访问,例如https://pypi.org/project/bellow/1.0/。