home *** CD-ROM | disk | FTP | other *** search
/ PC World 2005 February / PCWorld_2005-02_cd.bin / software / vyzkuste / pool / foobillard.exe / foobillard-3.0 / README < prev    next >
Text File  |  2003-01-19  |  6KB  |  156 lines
  1.  
  2.                              FooBillard
  3.                        --==##############==--
  4.  
  5.                    Copyright (C) 2001 Florian Berger
  6.                    
  7.                       email: harpin_floh@yahoo.de
  8.                              florian.berger@aec.at
  9.                              
  10.  
  11.     This program is free software; you can redistribute it and/or modify
  12.     it under the terms of the GNU General Public License Version 2 as
  13.     published by the Free Software Foundation;
  14.  
  15.     This program is distributed in the hope that it will be useful,
  16.     but WITHOUT ANY WARRANTY; without even the implied warranty of
  17.     MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  18.     GNU General Public License for more details.
  19.  
  20.     You should have received a copy of the GNU General Public License
  21.     along with this program; if not, write to the Free Software
  22.     Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
  23.  
  24.  
  25. What is FooBillard ?
  26. --------------------
  27.  
  28.    FooBillard is a free OpenGL-billard game for Linux. Why foo?
  29.    Well, actually I had this logo (F.B.-Florian Berger) and then foo sounds a
  30.    bit like pool (Somehow I wasn't quite attracted by the name FoolBillard)
  31.    Actually FooBillard is still under development but the main physics is
  32.    implemented. If you are a billard-pro and you're missing some physics,
  33.    please tell me. Cause I've implemented it like I think it should work,
  34.    which might differ from reality.
  35.  
  36.    You need to have GLUT or SDL installed on your system.
  37.    Furthermore libpng has to be installed for loading the textures.
  38.    And freetype is used for font rendering.
  39.    the fonts included here are lent from http://www.larabiefonts.com
  40.    (see README.FONTS)
  41.    
  42.    The following features are implemented:
  43.     - wood paneled table with gold covers and gold diamonds
  44.     - reflections on balls
  45.     - shadow pixmaps
  46.     - detail switching of balls according to distance
  47.     - zoom in/out - hold right mousebutton
  48.     - FOV +/- - hold right mousebutton + CTRL
  49.     - rotate - hold left mousebutton
  50.     - animated queue
  51.     - simple billard rules for 8 and 9-ball
  52.     - simple AI-Player
  53.     - strength adjustment
  54.     - eccentic hit adjustment (button2+Shift)
  55.     - lensflare
  56.     - commandline options
  57.     - config file (~/.foobillardrc)
  58.     - red green stereo !!!!
  59.     - sound (using SDL)
  60.     - network play
  61.    
  62.    Press <F1> in game for a quick help !
  63.    
  64.    here all keyboard/mouse functions:
  65.     - mouse moving and button1 -> rotate
  66.     - mouse moving and button2 -> zoom
  67.     - mouse moving and button1 after button2 -> place cue ball
  68.     - mouse moving and button2 after button1 -> adjust effet
  69.     - mouse moving and button2 and Ctrl -> FOV - adjust
  70.     - mouse moving and button2 and Shift -> cue offset adjust
  71.     - mouse moving and button1 and Shift -> place cue ball (when active)
  72.     - mouse button3 -> shoot
  73.     - keyboard <space> or <enter> -> shoot
  74.     - keyboard <up>,<down> or <page up>,<page down> strength
  75.     - keyboard <left>,<right> rotate
  76.     - keyboard <ESC> end game
  77.     - keyboard <0> suggest AI-shot
  78.     - keyboard <a> toggle actual player AI/Human
  79.     - keyboard <n> restart game
  80.     - keyboard <b> little benchmark (show fps)
  81.     - keyboard <v> turn vertical help-line on/off
  82.     - keyboard <c>,<F3> toggle cue-view on/off
  83.     - keyboard <f>,<F4> toggle free move mode
  84.     - keyboard <r> toggle simpler reflections (faster - using multitexture)
  85.     - keyboard <s> toggle red/green stereo
  86.     - keyboard <F1> toggle help screen
  87.     - keyboard <F2> birdview (same as <F3>+<F4>+centered pos)
  88.  
  89.  
  90.    red-green stereo:
  91.    -----------------
  92.     one picture is drawn on red channel only, the other one
  93.     on the other both channels (green, blue)
  94.     so you can use either a green or blue or cyan filter for one eye (left),
  95.     and a red one for the other eye (right).
  96.    
  97.    
  98.    network game:
  99.    -------------
  100.    
  101.     * general info:
  102.       commandline network game start is not anymore available
  103.       network game should be started from within the menu.
  104.  
  105.       The host and the client can of course be the same machine.
  106.       The data sent between the computers are only the shot-data,
  107.       like strength, cue offset and direction.
  108.       So if the two machines have different internal floating point
  109.       accuracy, the games might drift apart after a certain amount of time.
  110.       I'm not sure how strong this effect is in practice, cause i only tested
  111.       on similar machines.
  112.  
  113.     * start from menu:
  114.       hit <ESC> to get to the menu,
  115.       select <Network Game>/<As Host> on one computer and
  116.       <Network Game>/<Join>/<OK> on the other machine after having set the
  117.       proper IP in <Network Game>/<Join>/<IP>.
  118.       the <Network Game>/<Port> setting must be the same on both machines.
  119.       the IP of the host machine can also be set on the client machine 
  120.       (the joining one), by adding hostaddr=IP-ADDR in the config file 
  121.       (see below), or by passing it as commandline option:
  122.       --hostaddr=IP-ADDR
  123.       starting from menu the host sends its gamestate variables to the
  124.       client, so every clienside settings get overriden by the host
  125.       (gametype, tablesize, player names, ...)
  126.  
  127.     
  128.    SDL:
  129.    ----
  130.     SDL looks fine, and its easy to add features (here sound).
  131.     But i dont want to switch to SDL fully, because its very "unfriendly"
  132.     to other resources.
  133.     using GLUT i can watch TV (non-overlayed) and run some other apps 
  134.     without any major performance drawbacks.
  135.     (maybe there's a way of programming SDL in a way, that it gets fine 
  136.     performance sharing too - if you konw how, let me know)
  137.     
  138.     
  139.    config file (.foobillardrc):
  140.    ----------------------------
  141.     You can place a config file named ".foobillardrc" in your home directroy.
  142.     This file can contain all possible commandline arguments (without the 
  143.     preceeding "-" and one line for each argument).
  144.     Commandline parameters are parsed afterwards, so they override the
  145.     ".foobillardrc" settings.
  146.    
  147.     
  148.    KNOWN BUGS:
  149.    
  150.    
  151.    TIPS:
  152.    * the strength adjustment is up/down or pageup/pagedown, so many people
  153.      who have installed imwheel can use the mouse wheel to adjust strength :-)
  154.    * by default there is one human player vs. one AI-player
  155.      you can chane this by commanline options ( foobillard --help )
  156.