[PYTHON IMAGE-SIG] Announcing the Python Imaging Library, release 0.0
Thu, 28 Mar 1996 08:27:35 +0100
Suddently became more busy than usual, so I wasn't able to put the
full 0.1 release together last weekend as promised. However, by
leaving out some portions of the library, I did prepare an even
smaller release last Sunday. Unfortunately, the python.org server is
currently being reorganized, so it took quite a while to sort things
out and upload the stuff safely.
Anyway, you can now download this first experimental release from:
A few notes and caveats:
+ The main idea behind this release is to test portability and the
build procedure. But all comments are of course welcome.
+ There's no documentation, except for a README in the distribution
(which is attached, see below before you try to unpack the release).
To get a grip on the Image class, see the method doc strings
and the sample code in the test scripts.
+ The ImageIO module is not included; you can only read and write
PPM files with this release.
+ There's no built-in display support. There's a mechanism that may
allow you to use Jack Jansen's 'img' library for display purposes,
but that has not been tested yet.
+ To run the test scripts, you need 'xv'.
+ Don't miss the ImageEnhance module (run the test_enhance.py script)
Send any comments, bug reports, or flames to 'firstname.lastname@example.org'.
$Id: README,v 1.1 1996/03/25 08:46:34 fredrik Exp $
Release 0.0 (March 24, 1996)
*** The Python Imaging Library ***
This prerelease is made mainly to check installation on different
platforms, and to give developers and other interested parties access
to the Imaging core library. This release contains most of the stuff
planned for release 0.1, with the exception of the ImageIO codecs,
documentation, and some minor functionality.
For installation and licensing details, see below.
For questions, comments and bug reports, send mail to
*** Build instructions (Unix)
1. Unpack the PIL distribution (the file Imaging-0.0.tar.gz) in your
$ cd Python-1.3 (example)
$ gunzip Imaging-0.0.tar.gz
$ tar xvf Imaging-0.0.tar
2. Go to the Imaging subdirectory that was created in your Python
directory when you unpacked the distribution. Type:
3. To check that this library works as it should, type:
$ make check
4. Go to the Modules subdirectory in your Python directory. Copy
the following text to the end of the Setup file (or Setup.in,
if you haven't already built the interpreter):
_imaging _imagingmodule.c -I../Imaging -L../Imaging -lImaging
5. Build the Python interpreter as usual.
6. In the Imaging subdirectory, type (assuming you linked the module
>>> import Image
If this works, you've successfully added PIL to your Python
environment. There's a few test/demo scripts in the Imaging
directory that you can use to test the library.
7. To install the PIL Python library modules, copy the files named
"Image*.py" and "*ImagePlugin.py" from the Imaging library to your
Python library directory. The following command will do:
$ cp Imaging/*Image*.py /usr/local/lib/python
*** Software License
(The following is a slightly modified version of the standard Python
license. The exception is that you cannot use the C portions of the
library outside a Python environment without my permission. But as
long as you use with a Python interpreter, you can do anything with
the library, except blaming me if it doesn't work as you expect :-)
The Python Imaging Library is copyright (c) 1995-96 Fredrik Lundh.
All rights reserved.
Permission to use, copy, modify, and distribute this Python software
and its associated documentation for any purpose (subject to the
restriction in the following sentence) without fee is hereby granted,
provided that the above copyright notice appears in all copies, and
that both that copyright notice and this permission notice appear in
supporting documentation, and that the name of the author not be used
in advertising or publicity pertaining to distribution of the software
without specific, written prior permission. This permission is
explicitly restricted to the copying and modification of the software
to be exclusively used with a Python interpreter.
THE AUTHOR DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE,
INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS. IN
NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, INDIRECT OR
CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF
USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR
OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
PERFORMANCE OF THIS SOFTWARE.
IMAGE-SIG - SIG on Image Processing with Python
send messages to: email@example.com
administrivia to: firstname.lastname@example.org