FooBillard
                       --==##############==--

                   Copyright (C) 2001 Florian Berger
                   
                      email: harpin_floh@yahoo.de
                             florian.berger@aec.at
                             

    This program is free software; you can redistribute it and/or modify
    it under the terms of the GNU General Public License Version 2 as
    published by the Free Software Foundation;

    This program is distributed in the hope that it will be useful,
    but WITHOUT ANY WARRANTY; without even the implied warranty of
    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
    GNU General Public License for more details.

    You should have received a copy of the GNU General Public License
    along with this program; if not, write to the Free Software
    Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.


What is FooBillard ?
--------------------

   FooBillard is an attempt to create a free OpenGL-billard for Linux. Why foo?
   Well, actually I had this logo (F.B.-Florian Berger) and then foo sounds a
   bit like pool (Somehow I wasn't quite attracted by the name FoolBillard)
   Actually FooBillard is still under development but the main physics is
   implemented. If you are a billard-pro and you're missing some physics,
   please tell me. Cause I've implemented it like I think it should work,
   which might differ from reality.

   FooBillard may not even compile on yor machine, because the makefiles are 
   still very crude (possibly you have to change the linking parameters or 
   include directories). 
   You need to have GLU and GLUT installed on your system.
   Furthermore libpng has to be installed for loading the textures.
   
   The following features are implemented:
    - wood paneled table with gold covers and gold diamonds
    - reflections on balls
    - shadow pixmaps
    - detail switching of balls according to distance
    - zoom in/out - hold right mousebutton
    - FOV +/- - hold right mousebutton + CTRL
    - rotate - hold left mousebutton
    - slow rotate - hold left mousebutton and CTRL-key
    - animated queue
    - simple billard rules
    - simple AI-Player
    - strength adjustment
    - eccentic hit adjustment (button2-Shift)
    - lensflare
    - commandline options
    - config file (~/.foobillardrc)
    
   here all keyboard/mouse functions:
    - mouse moving and button1 -> rotate
    - mouse moving and button2 -> zoom
    - mouse moving and button1 and Ctrl -> fine rotate
    - mouse moving and button1 and button2 -> also fine rotate
    - mouse moving and button2 and Ctrl -> FOV - adjust
    - mouse moving and button2 and Shift -> cue offset adjust
    - mouse moving and button1 and Shift -> place cue ball (when active)
    - mouse button3 -> shoot
    - keyboard <space> or <enter> -> shoot
    - keyboard <up>,<down> or <page up>,<page down> strength
    - keyboard <left>,<right> rotate
    - keyboard <ESC> end game
    - keyboard <0> suggest AI-shot
    - keyboard <a> toggle actual player AI/Human
    - keyboard <n> restart game
    - keyboard <b> little benchmark (show fps)
    - keyboard <v> turn vertical help-line on/off
    - keyboard <c> toggle cue-view on/off
    - keyboard <r> toggle simpler reflections (faster - using multitexture)
    

   no distribution or "make install", yet. just type "make" and start the 
   executable "foobillard" from the source directory.
   
   KNOWN BUGS:
   angular momentum transfer between balls is only crudely implemented.
   
   
   TIPS:
   * the strength adjustment is up/down or pageup/pagedown, so many people
     who have installed imwheel can use the mouse wheel to adjust strength :-)
   * by default there is one human player vs. one AI-player
     if you start by "foobillard 2" you will get 2 human players called
     "Human Player" and "Human Player 2" - no own names yet, sorry.