mirror of
https://github.com/python-pillow/Pillow.git
synced 2025-07-10 16:22:22 +03:00
Don't duplicate info
This commit is contained in:
Alex Clark
parent
238c5b99fb
commit
4ea4abe57d
170
README.rst
170
README.rst
|
|
@ -16,172 +16,4 @@ Pillow is the "friendly" PIL fork by Alex Clark and Contributors. PIL is the Pyt
|
||||||
:target: https://pypi.python.org/pypi/Pillow/
|
:target: https://pypi.python.org/pypi/Pillow/
|
||||||
:alt: Number of PyPI downloads
|
:alt: Number of PyPI downloads
|
||||||
|
|
||||||
The full documentation is hosted at http://pillow.readthedocs.org/. It
|
The full documentation is hosted at http://pillow.readthedocs.org/. It contains installation instructions, tutorials, reference, compatibility details, and more.
|
||||||
contains everything in this file plus tutorials, reference, compatibility
|
|
||||||
details, and more.
|
|
||||||
|
|
||||||
Introduction
|
|
||||||
------------
|
|
||||||
|
|
||||||
The fork author's goal is to foster active development of PIL through:
|
|
||||||
|
|
||||||
- Continuous integration testing via `Travis CI <https://travis-ci.org/python-imaging/Pillow>`_
|
|
||||||
- Publicized development activity on `GitHub <https://github.com/python-imaging/Pillow>`_
|
|
||||||
- Regular releases to the `Python Package Index <https://pypi.python.org/pypi/Pillow>`_
|
|
||||||
- Solicitation for community contributions and involvement on `Image-SIG <http://mail.python.org/mailman/listinfo/image-sig>`_
|
|
||||||
|
|
||||||
For information about why this fork exists and how it differs from PIL, see
|
|
||||||
`the About page in the documentation`_.
|
|
||||||
|
|
||||||
.. _the About page in the documentation: http://pillow.readthedocs.org/en/latest/about.html
|
|
||||||
|
|
||||||
Installation
|
|
||||||
------------
|
|
||||||
|
|
||||||
You can install Pillow with ``pip``::
|
|
||||||
|
|
||||||
$ pip install Pillow
|
|
||||||
|
|
||||||
Or ``easy_install`` (for installing `Python Eggs <http://peak.telecommunity.com/DevCenter/PythonEggs>`_, as pip does not support them)::
|
|
||||||
|
|
||||||
$ easy_install Pillow
|
|
||||||
|
|
||||||
Or download the compressed archive from PyPI, extract it, and inside it run::
|
|
||||||
|
|
||||||
$ python setup.py install
|
|
||||||
|
|
||||||
For more information, please see http://pillow.readthedocs.org/en/latest/ or below.
|
|
||||||
|
|
||||||
Community Support
|
|
||||||
-----------------
|
|
||||||
|
|
||||||
Developer
|
|
||||||
~~~~~~~~~
|
|
||||||
|
|
||||||
PIL needs you! Please help us maintain the Python Imaging Library here:
|
|
||||||
|
|
||||||
- GitHub (https://github.com/python-imaging/Pillow)
|
|
||||||
- Freenode (irc://irc.freenode.net#pil)
|
|
||||||
- Image-SIG (http://mail.python.org/mailman/listinfo/image-sig)
|
|
||||||
|
|
||||||
Financial
|
|
||||||
~~~~~~~~~
|
|
||||||
|
|
||||||
Pillow is a volunteer effort led by Alex Clark. If you can't help with development, please help us financially; your assistance is very much needed and appreciated!
|
|
||||||
|
|
||||||
.. Note:: Contributors: please add your name and donation preference here, as well as at the bottom of docs/index.rst.
|
|
||||||
|
|
||||||
======================================= =======================================
|
|
||||||
**Developer** **Preference**
|
|
||||||
======================================= =======================================
|
|
||||||
Alex Clark (fork author) http://gittip.com/aclark4life
|
|
||||||
======================================= =======================================
|
|
||||||
|
|
||||||
Developer Notes
|
|
||||||
---------------
|
|
||||||
|
|
||||||
.. Note:: If there is a binary package for your system, that is the easiest way to install Pillow. Currently we only provide binaries for Windows (via Python eggs).
|
|
||||||
|
|
||||||
Build from source
|
|
||||||
~~~~~~~~~~~~~~~~~
|
|
||||||
|
|
||||||
Many of Pillow's features require external libraries:
|
|
||||||
|
|
||||||
* **libjpeg** provides JPEG functionality.
|
|
||||||
|
|
||||||
* Pillow has been tested with libjpeg versions **6b**, **8**, and **9**
|
|
||||||
|
|
||||||
* **zlib** provides access to compressed PNGs
|
|
||||||
|
|
||||||
* **libtiff** provides group4 tiff functionality
|
|
||||||
|
|
||||||
* Pillow has been tested with libtiff versions **3.x** and **4.0**
|
|
||||||
|
|
||||||
* **libfreetype** provides type related services
|
|
||||||
|
|
||||||
* **littlecms** provides color management
|
|
||||||
|
|
||||||
* **libwebp** provides the Webp format.
|
|
||||||
|
|
||||||
* Pillow has been tested with version **0.1.3**, which does not read transparent webp files. Version **0.3.0** supports transparency.
|
|
||||||
|
|
||||||
* **tcl/tk** provides support for tkinter bitmap and photo images.
|
|
||||||
|
|
||||||
If the prerequisites are installed in the standard library locations for your machine (e.g. /usr or /usr/local), no additional configuration should be required. If they are installed in a non-standard location, you may need to configure setuptools to use those locations (i.e. by editing setup.py and/or setup.cfg). Once you have installed the prerequisites, run::
|
|
||||||
|
|
||||||
$ pip install Pillow
|
|
||||||
|
|
||||||
Platform-specific instructions
|
|
||||||
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
|
||||||
|
|
||||||
Linux
|
|
||||||
+++++
|
|
||||||
|
|
||||||
**We do not provide binaries for Linux.** If you didn't build Python from source, make sure you have Python's development libraries installed. In Debian or Ubuntu::
|
|
||||||
|
|
||||||
$ sudo apt-get install python-dev python-setuptools
|
|
||||||
|
|
||||||
Or for Python 3::
|
|
||||||
|
|
||||||
$ sudo apt-get install python3-dev python3-setuptools
|
|
||||||
|
|
||||||
Prerequisites are installed on **Ubuntu 10.04 LTS** with::
|
|
||||||
|
|
||||||
$ sudo apt-get install libtiff4-dev libjpeg62-dev zlib1g-dev libfreetype6-dev liblcms1-dev tcl8.5-dev tk8.5-dev
|
|
||||||
|
|
||||||
Prerequisites are installed with on **Ubuntu 12.04 LTS** or **Raspian Wheezy 7.0** with::
|
|
||||||
|
|
||||||
$ sudo apt-get install libtiff4-dev libjpeg8-dev zlib1g-dev libfreetype6-dev liblcms1-dev libwebp-dev tcl8.5-dev tk8.5-dev
|
|
||||||
|
|
||||||
Distributions
|
|
||||||
^^^^^^^^^^^^^
|
|
||||||
|
|
||||||
.. Note:: XXX Provide links
|
|
||||||
|
|
||||||
Additionally, many Linux distributions now include Pillow (instead of PIL) with their distribution:
|
|
||||||
|
|
||||||
- Fedora
|
|
||||||
- Debian/Ubuntu
|
|
||||||
- ArchLinux
|
|
||||||
|
|
||||||
Mac OS X
|
|
||||||
++++++++
|
|
||||||
|
|
||||||
**We do not provide binaries for OS X.** So you'll need XCode to install Pillow. (XCode 4.2 on 10.6 will work with the Official Python binary distribution. Otherwise, use whatever XCode you used to compile Python.)
|
|
||||||
|
|
||||||
The easiest way to install the prerequisites is via `Homebrew <http://mxcl.github.com/homebrew/>`_. After you install Homebrew, run::
|
|
||||||
|
|
||||||
$ brew install libtiff libjpeg webp littlecms
|
|
||||||
|
|
||||||
If you've built your own Python, then you should be able to install Pillow using::
|
|
||||||
|
|
||||||
$ pip install Pillow
|
|
||||||
|
|
||||||
Windows
|
|
||||||
+++++++
|
|
||||||
|
|
||||||
We provide binaries for Windows in the form of Python Eggs and `Python Wheels <http://wheel.readthedocs.org/en/latest/index.html>`_:
|
|
||||||
|
|
||||||
Python Eggs
|
|
||||||
^^^^^^^^^^^
|
|
||||||
|
|
||||||
.. Note:: Pip does not support Python Eggs; use easy_install instead.
|
|
||||||
|
|
||||||
::
|
|
||||||
|
|
||||||
$ easy_install Pillow
|
|
||||||
|
|
||||||
Python Wheels
|
|
||||||
^^^^^^^^^^^^^
|
|
||||||
|
|
||||||
.. Note:: Experimental. Requires Setuptools >=0.8 and Pip >=1.4.1
|
|
||||||
|
|
||||||
::
|
|
||||||
|
|
||||||
$ pip install --use-wheel Pillow
|
|
||||||
|
|
||||||
Platform support
|
|
||||||
~~~~~~~~~~~~~~~~
|
|
||||||
|
|
||||||
Current platform support for Pillow is documented here:
|
|
||||||
http://pillow.readthedocs.org/en/latest/installation.html#platform-support
|
|
||||||
|
|
|
||||||
Loading…
Reference in New Issue
Block a user