*********************** S O Y A   3 D ******************************
*************************** Intro **********************************

Soya 3D is a high level 3D engine for Python. It relies on OpenGL and
SDL. It is designed with games in mind, and written partly in Python
and partly in C; our goal is to provide a full architecture for making
free (GPL) game of professionnal quality entirely in Python.
Soya can also render on PyGame surface !

Soya 3D currently runs on Linux.

Soya 3D requires:
 - Python 2.2 or more (tested with 2.2.2)
 - OpenGL (tested with Mesa, DRI for Radeon and Nvidia drivers)
 - SDL

The 3D editor requires also:
 - Tkinter
 - PIL     (Python imaging library
            http://www.python.org/sigs/image-sig/Imaging.html)
 - EditObj (http://oomadness.tuxfamily.org/)


*************************** Installation ***************************

Soya3D uses Python distutils for installation.
To install, type the following as root:

cd Soya3D-XXX
python ./setup.py install


*************************** Running ********************************

There are also demos in ./tutorial


Soya 3D comes along with a small 3D editor; you can launch it as
following:

cd Soya3D-XXX
python ./soya/soya_editor


*************************** Documentation **************************

Documentation available on Soya 3D:
 - Some tutorial are available in ./tutorial
 - Some modules have already doc strings !


********************************************************************

Enjoy Soya 3D ! And stop eating meat !

Jiba -- Jean-Baptiste LAMY -- jiba@tuxfamily.org
                              http://oomadness.tuxfamily.org
