Pycadia INSTALL
===============

Requirements
============
* Python >= 2.2    (http://www.python.org)
* Pygame >= 1.5.5  (http://www.pygame.org)

Optional (required for Pycadia GUI):
* PyGTK >= 1.99.16 (http://www.daa.com.au/~james/software/pygtk/)


Installation Notes
==================
Linux:   
1) Extract the contents of the tarball into a suitable folder.

2) Run:
2.1) Pycadia GUI front-end:
        Linux:   ./pycadia.py
    
2.2) SpaceWarpy:
        Linux:   ./spacewarpy.py
    
2.3) Vektoroids:
        Linux:   ./vektoroids.py
        
        
Gentoo-Linux:
1) If you've not already setup a local portage area then:
1.1) In the /etc/make.conf file, add something like:
        PORTDIR_OVERLAY=/usr/local/portage
1.2) Make a directory for pycadia:
        mkdir -p /usr/local/portage/app-games/pycadia
    
2) Copy the pycadia.0.5.1.ebuild file to your local portage area, eg:
        cp pycadia.0.5.1.ebuild /usr/local/portage/app-games/pycadia

3) Merge pycadia:
        emerge pycadia


Windows:
1) Download and run the setup program (pycadia-0.5.1.win32.exe)

*or* 

if you want to try and run the source code, you'll need to:
1) Extract the contents of the tarball into a suitable folder.

2) Set up GTK & PyGTK on Windows systems:
2.1) Download & install the latest GTK runtime from:
        http://www.dropline.net/gtk/download.php
2.2) Download & install the latest PyGTK version from:
        http://www.pcpm.ucl.ac.be/~gustin/win32_ports/
2.3) You may need to add the following to your PATH environment variable:
        <python_drive:\python_dir\DLLS> (eg. c:\python22\DLLS)
        <gtk drive:\gtk2_dir\lib>       (eg. c:\Program Files\Common Files\GTK\2.0\lib)
        (There seems to be a problem that causes a segfault on my Windows 2000 setup when
         I add the above folder to my PATH variable.  Consequently the .png files do not
         load).
2.4) If the fonts look very big in the GUI then try the following gtkrc 
        (eg. c:\Program Files\Common Files\GTK\2.0\etc\gtk-2.0\gtkrc):
            style "win32-font"
             {
               font_name = "sans 8"
             }
             class "*" style "win32-font"
 

===================================================================
Pycadia and SpaceWarpy are Copyright (c) 2002-2003 Andy Balcombe
Vektoroids is Copyright (c) 2002-2003 Paul Buckle and Andy Balcombe
===================================================================

