mirror of
https://github.com/python-pillow/Pillow.git
synced 2024-11-10 19:56:47 +03:00
129 lines
3.9 KiB
ReStructuredText
129 lines
3.9 KiB
ReStructuredText
.. contents::
|
|
|
|
Pillow
|
|
======
|
|
|
|
Pillow is the "friendly" PIL fork. PIL is the Python Imaging Library. Pillow was
|
|
started for and is currently maintained by the Plone community. But it is used by
|
|
many other folks in the Python web community, and probably elsewhere too.
|
|
|
|
Introduction
|
|
------------
|
|
|
|
The fork author's goal is to foster packaging improvements via:
|
|
|
|
- Publicized development and solicitation of community support.
|
|
- Exploration of packaging problems within the fork, most noticably
|
|
via adding setuptools support but also via clean up & refactoring
|
|
of packaging code.
|
|
|
|
Why a fork?
|
|
-----------
|
|
|
|
PIL is currently not setuptools compatible. Please see
|
|
http://mail.python.org/pipermail/image-sig/2010-August/006480.html for a
|
|
more detailed explanation. Also, PIL's current release/maintenance schedule
|
|
is not compatible with the various & frequent packaging issues that have
|
|
occured.
|
|
|
|
What about image code bugs?
|
|
---------------------------
|
|
|
|
Please report any non-packaging related issues here first:
|
|
|
|
- https://bitbucket.org/effbot/pil-2009-raclette/issues
|
|
|
|
Then open a ticket here:
|
|
|
|
- https://github.com/python-imaging/Pillow/issues
|
|
|
|
and provide a link to the first ticket so we can track the issue(s) upstream.
|
|
This project does not aim to fix image code bugs, but if we can track them
|
|
properly we may consider it. (And the image code could potentially be wholesale
|
|
replaced when the next PIL release comes out.)
|
|
|
|
Documentation
|
|
-------------
|
|
|
|
The API documentation included with PIL has been converted (from HTML) to
|
|
reStructured text (via pandoc) and is now `hosted by readthedocs.org`_.
|
|
|
|
.. _`hosted by readthedocs.org`: http://pillow.readthedocs.org
|
|
|
|
What follows is the original PIL README.
|
|
|
|
Python Imaging Library
|
|
======================
|
|
|
|
Introduction
|
|
------------
|
|
|
|
The Python Imaging Library (PIL) adds image processing capabilities
|
|
to your Python environment. This library provides extensive file
|
|
format support, an efficient internal representation, and powerful
|
|
image processing capabilities.
|
|
|
|
This source kit has been built and tested with Python 2.0 and newer,
|
|
on Windows, Mac OS X, and major Unix platforms. Large parts of the
|
|
library also work on 1.5.2 and 1.6.
|
|
|
|
The main distribution site for this software is:
|
|
|
|
http://www.pythonware.com/products/pil/
|
|
|
|
That site also contains information about free and commercial support
|
|
options, PIL add-ons, answers to frequently asked questions, and more.
|
|
|
|
Development versions (alphas, betas) are available here:
|
|
|
|
http://effbot.org/downloads/
|
|
|
|
The PIL handbook is not included in this distribution; to get the
|
|
latest version, check:
|
|
|
|
http://www.pythonware.com/library/
|
|
|
|
For installation and licensing details, see below.
|
|
|
|
--------------------------------------------------------------------
|
|
Support Options
|
|
--------------------------------------------------------------------
|
|
|
|
Commercial Support
|
|
~~~~~~~~~~~~~~~~~~
|
|
|
|
Secret Labs (PythonWare) offers support contracts for companies using
|
|
the Python Imaging Library in commercial applications, and in mission-
|
|
critical environments. The support contract includes technical support,
|
|
bug fixes, extensions to the PIL library, sample applications, and more.
|
|
|
|
For the full story, check:
|
|
|
|
http://www.pythonware.com/products/pil/support.htm
|
|
|
|
|
|
Free Support
|
|
~~~~~~~~~~~~
|
|
|
|
For support and general questions on the Python Imaging Library, send
|
|
e-mail to the Image SIG mailing list:
|
|
|
|
image-sig@python.org
|
|
|
|
You can join the Image SIG by sending a mail to:
|
|
|
|
image-sig-request@python.org
|
|
|
|
Put "subscribe" in the message body to automatically subscribe to the
|
|
list, or "help" to get additional information. Alternatively, you can
|
|
send your questions to the Python mailing list, python-list@python.org,
|
|
or post them to the newsgroup comp.lang.python. DO NOT SEND SUPPORT
|
|
QUESTIONS TO PYTHONWARE ADDRESSES.
|
|
|
|
|
|
--------------------------------------------------------------------
|
|
Software License
|
|
--------------------------------------------------------------------
|
|
|
|
See COPYING
|