Open Beat Box : A Virtual Drum Machine

IRIX Installation Guide
           ______________________________________________

   Table of Contents
   Installation
   Dependencies
   Chilling

Installation

   Due  to the early stage of our development, you will typically
   not install OBB. You will be able to run it from the place you
   extracted  the  archive but we don't want to scatter all those
   pre-alpha files across your filesystem. We prefer to have them
   enclosed right here is this directory.

   You need to install a few dependencies before you can run OBB,
   let's get started !
     _________________________________________________________

Dependencies

   OBB did not reinvented the wheel nor the raster operations. We
   use  several  packages  and some of them may not be present on
   your system. To run OBB you will need :

     * Qt
     * Python
     * PyQt
     * cSound
     * SDL_mixer
     * Pygame
     _________________________________________________________

Qt

   This  is  the  graphical  user interface (GUI) toolkit we use.
   Just  download  the latest version from the Trolltech web site
   (http://www.trolltech.com).    Qt's   distribution   is   well
   documented  and  not really hard to install. Be warned that it
   will take really long to build.
     _________________________________________________________

Python

   This  is the programming language OBB is written in. It's easy
   too see if it is installed, just type :
     python -V

   you should see something like this :
     Python 2.2.1

   which is good news, or like this :
     bash: python: command not found

   which means you are in trouble. In the later case, you have to
   install  Python. Grab the latest version from the Python's web
   site  (http://python.org),  build it and install it. Python is
   easier  and  faster  to  build  than  Qt so you should have no
   problem here.
     _________________________________________________________

PyQt

   The  things  are getting interesting here. Qt is a really nice
   toolkit  and  Python is a really nice language. Unfortunately,
   Qt  is  written  in C++ so we can't use it directly in Python.
   PyQt  is  a  binding to use Qt in Python. To check if you have
   it, type :
     python -c "import qt"

   You  will  either  have no result and you will get back to the
   command  prompt,  which  means  that  PyQt  is installed, or a
   message like :
     Traceback (most recent call last):
       File "<string>", line 1, in ?
     ImportError: No module named qt

   In  the  latter  case,  you  have to install PyQt. You have to
   download   the   latest  version  from  the  PyQt's  web  site
   (http://www.riverbankcomputing.co.uk/pyqt/index.php).

   There  are  a  few  tricks  that  will  help  you  with PyQt's
   installation.  The  first step is to install Sip that you will
   find  on  the  PyQt's  web site. If the installation complains
   about QTDIR, it's because it is looking for the place where Qt
   is  installed. On most systems this should be /usr/lib/qt3/ so
   just type :
     export QTDIR=/usr/lib/qt3

   Once  Sip  is  installed, you might what to proceed with PyQt.
   Before you build PyQt, have a look at the file README.Linux in
   the  PyQt's  distribution. You will need to modify a few files
   on  some  Linux  distribution. Building PyQt cat take a lot of
   time  but  if  you have enough RAM(I'd say 256M), you can pass
   the -c option to the build.py script :
      python build.py -c

   This  will merge all the PyQt's code in a single big file. The
   build  process  is at least 5 times faster with the -c option.
   You have to be root to build PyQt, not just to install it.
     _________________________________________________________

cSound

   cSound  is the sound synthesizer engine behind OBB. One of the
   goals  of  OBB  is to run using different synthesizer engines,
   left  to  the  preference  of  the  user.  There  is almost no
   documentation  for  the installation so we will guide you. You
   will  find  the different branches of the Linux port of cSound
   at http://www.bright.net/~dlphilp/linux_csound.html and plenty
   of     information     on     all     csound    versions    on
   http://www.csounds.com.

   The    last    time    we   tried   the   branch   hosted   on
   http://www.cs.bath.ac.uk/pub/dream,  it  proved  to  be  quite
   unstable,  but  the  binaries  work  fine.  We  recommend  the
   unofficial   port  hosted  on  ftp://mustec.bgsu.edu/pub/linux
   altough it's not supported anymore. If you ever try the branch
   on   www.cs.bath.ac.uk,   be  warned  that  the  archive  will
   uncompress  the  files  in  the  current  directory instead of
   creating  a  new  one. the unofficial cSound can be built with
   the regular
     ./configure
     make
     make install

   Depending  on  the  packages  installed on you system, you may
   want  to  turn  off  some  option in the configure script like
   --without-x :
     ./configure --without-x

   The  branch  on  www.cs.bath.ac.uk will require you to use the
   Makefile for IRIX :
     make -f Makefile.irix6.5
     make -f Makefile.irix6.5 install
     _________________________________________________________

SDL_mixer

   SDL_mixer provides a portable way to access the sound hardware
   from  several  operating  systems. You can download the source
   distribution from http://www.libsdl.org/projects/SDL_mixer/
     _________________________________________________________

Pygame

   We  use Pygame in OBB much the same way we use PyQt, to access
   the functionality of a C library in Python. Pygame is a really
   small binding, you can download it from http://pygame.org/

   Pygame is installed with the setup.py script :
     python setup.py build
     python setup.py install

   Pygame may warn you that it did not find some dependencies. As
   long  as  it  found the mixer, OBB will play sounds. The other
   dependencies  are  not  needed by OBB but you may be forced to
   install numeric 22.0 if you don't have this version installed.
   You may want to install all pygame's dependincies while you're
   at  it  in  case  you  install a game using Pygame in the near
   future.
     _________________________________________________________

Chilling

   Now  that  the  hard  work  is  done,  we highly recommend the
   consumption of fermented malt beverage.
