XBobble (C) Asfand Yar Qazi  2002, 2003

A game of skill and determination!  Pop as many balls as you can....

Requirements

These are the requirements for this package.

    For running only:

    * SDL(www.libsdl.org). Anything over 1.2.0 should be fine.

    * You also need the SDL_mixer and SDL_image libraries, also from
      the above link (even if you don't use sound - sorry.)

    * OpenGL 1.2 or later (I'd give the link to Mesa (www.mesa3d.org),
      a software-only implementation of OpenGL, except that it would
      be too slow! Your hardware manufacturer should really supply
      one, else you're out of luck.)

    In addition, for compiling:

    * The GNU Compiler Collection C++ compiler, version 3.1 or above
      (gcc.gnu.org).  3.0 may work, but apparently it has many
      outstanding bugs in it.

    * GNU make (www.gnu.org/software/make)

    * A POSIX/ISO C/ISO C++ Development environment. Currently, I use
      tools such as 'find', 'rm', etc. Everyone should have these. If
      you're a Unix or clone (BSD, GNU/Linux, Solaris, etc..) user,
      you know what I'm talking about, and you have the tools. For
      Windoze users, sorry, no can do. What might work is Cygwin
      (www.cygwin.org), since I don't use THAT much UNIX specific
      stuff, I try to stick to ISO C++ Standard Library stuff as much
      as possible.

    * ..and most importantly..... my Super-Duper platform-independant
      game design application library libayq (libayq.sf.net). (How
      vain, naming it after myself) (INCLUDED in binary
      distributions.)

Installation

Just type 'gmake' (or just 'make' on Linux) to do it!  I hope it
works... REMEMBER!  Needs gcc 3!  gcc 2.9X don't support all those
nice template features I crave.

The shell-script 'xbobble' basically sets the default 'data_root'
config option to the 'data' directory.  So use it after compilation:

make
./xbobble

Then, run like follows:

XBOBBLE1_OPTIONS="'global_cfg_file' = 'doc/xbobble-sample-config'" xbobble

If you want to avoid the laborious config typing as above, copy the
file 'doc/xbobble-sample-config' to $HOME/.xbobble1.cfg (configuration
stuff is explained in doc/config_info) and just run as './xbobble'.

If you don't initialise a config file, default values for config
options will be used, which may not be to your liking.


Making levels:

Note the first two numbers MUST be the same in each file (13 8).  The
next one determines the number of balls that, after they are launched,
the white bar moves up (which will signal game over if any balls cross
it.)

Then comes a list of numbers (as structured in each of the levels
file) for the initial layout of the balls on the grid.  Any number > 7
means 'no ball', ie that part of the grid is empty.  And that's about
all!  Note the files 'levelX.grid' (where X is an integer) must be
numbered sequentially starting from '1'.

