*******************************************************************
             sipp 2.0  --  3d rendering package

             by         Jonas Yngvesson   jonas-y@isy.liu.se
                        Inge Wallin       ingwa@isy.liu.se

             Linkoping Institute of Technology
             Sweden
*******************************************************************

This is the beta-test release of version 2.0 of SIPP, the SImple
Polygon Processor. SIPP is a library for creating 3-dimensional
scenes and rendering them using a scan-line z-buffer algorithm. A
scene is built up of objects which can be transformed with rotation,
translation and scaling. The objects form hierarchies where each
object can have arbitrarily many subobjects and subsurfaces. A
surface is a number of connected polygons which are rendered with
Phong interpolation of the surface normals.

The library has an internal database for the objects that is to be
rendered. Objects can be installed in, and removed from, this
database at any time.

The library also provides 3-dimensional texture mapping with
automatic interpolation of texture coordinates. Simple anti-aliasing
is performed through double oversampling. A scene can be illuminated
by an arbitrary number of light sources. A basic shading algorithm is
provided with the library, but the user can also use his own shading
algorithms for each surface to produce special effects. Images are
produced in the Portable Pixmap format (ppm) for which many utilities
exist.

The program has some bugs & limitations. See the BUGS entry in the
manuals for more information.

To install the library, edit the Makefile and type 'make install'. If
Your system does not have the drand48() random number generator, change
the macro RANDOM() in sipp.h to use the random number generator available
on your system.

If you only want to make the library but not install it, just type
'make library'.

If you want to make the tests and demonstrations, type 'make demos'. 


The library has so far only been tested on Sun workstations
(SPARCstation & SUN3) but should work on most platforms regardless
of UNIX version. If you run into trouble, let us know.

Please send any enhancements, bug reports and fixes to us.
Especially, if you create nice new object types, we would be
grateful if you sent the C functions creating those to us. We could
then compile a library of object functions and let other people share
the benefits.

Linkoping 19 December 1990

                enjoy! /Jonas & Inge
