	     	         //  //   ///    //  //  //    /////  ///
.	                // //   //  //  //  //  //    //    //
	    .          ////    //  //  //  //  //    ////   ///
	              // //   //  //  //  //  //    //       //          .
	             //  //   ////    ////   ///// /////  /// 
     *         .
				      v1.1	 
				       by	                .          .
                 .

	               //  ///  // // //  //  ///////////////////////
	.             // // // // // //  // //         
	          // // ///// ///// //  //  //   ///   ///// /////            .
       *          ///  // // // //  ////    // // //  //      //
                                          //  // //  ////    //        .      * 
	        //////////////////////////    ///   //      //

      .             .       THIS PROGRAM IS FREEWARE       .            .
*
	          		        ^           .                        
	.                              / \                        *  .        
	    .          .              /   \
     *         .                     /     \    .               .        
                  .       *         /       \
	                     .     /         \           .
	     .                    /           \
       .                         /             \                            .
            *       .           /    CREDITS    \     *        .
                               /    ---------    \     .            *  .
                              Sounds by Jan Hubicka           .            .
                             Graphics by Jan Hubicka
                    *       Programming by Jan Hubicka
  .          .             Assistants:   Kamil   Toman 
                          /      Thomas  Marsh        \  *      .
                         /                             \
                        /          INTRODUCTION:        \
                       /          ---------------        \
    .       *  .      Koules is a fast action  arcade-style       *
                     game for UNIX.  This  version  supports
                    X window  system and  SVGAlib  for Linux.
                   It works in fine (up to 640x480) resolution  .          .
                  with  cool  256 color graphics , multi-player 
		 mode up to 5 players  and sounds . Koules is an 
                original idea. Koules was  developed from scratch 
               /           by Jan Hubicka in July 1995.          \
              /                                                   \       *
  .          /                                                     \ 
            /                     REQUIREMENTS:                     \
    .      /		         ---------------          	     \
          It runs well on computers which can be marked  as faster than
         386DX/40 + math coprocessor (320x200 resolution)  or  486DX2/50
        (640x480 resolution).  UNIX  and  X11/SVGAlib  are also required.  







INSTALL:
--------
LINUX-SVGAlib:
  You  must  be  'root'  to  install  the  game. Edit  the  Makefile.svgalib as 
  appropriate for  your  system. Run 'make -f Makefile.svgalib' to  compile 
  game.  Then run 'make -f Makefile.svgalib install' to install game. Do not 
  forget to remove your old KOULES version if present.

HPUX-no gcc no imake:
  Edit the Makefile.hpux as appropriate for your system. 
  Run 'make -f Makefile.hpux' to  compile game. 
  Then run 'make -f Makefile.hpux install' to install game.

Generic-X11:
  Edit the Imakefile as appropriate for your system. Run xmkmf -a to make 
  Makefile. Run 'make' to compile game. Then run 'make install' to install game.

USAGE:
------
xkoules [-SxslMmpdh]
 -h for help
 -s for small display(320x250)
    for slow machines
 -l for large display(640x480)
    default size
 -p use private colormap
    use only if 'Could not allocate colormap' error is reported
 -S Synchronize with X
    use only for debugging
 -d Disable sound support
    Game will run faster.
 -x Disable X11 pointer
    Use game's own cursor when standard X11's cursor is blinking
 -m use mouse to control player
    If you want to control your player by mouse and you're too lazy 
    to switch it in menu
 -M DISABLE shared memory support
    Slow down the game. Use only if shared memory support crashes.

koules.svga [-slMmdh]
 -h for help
 -s for small display(320x200)
    for worse machines
 -l for large display(640x480)
    default size
 -M disable mouse support
    avoid gpm/selection conflict
 -m use mouse to control player
    If you want to control your player by mouse and you're too lazy 
    to switch it in menu
 -d Disable sound support
    Game will run faster.


				   MENUS:

look at this simple hypertext diagram to understand them:

            /----------------+    
START GAME (---+      +--+   |
X PLAYER ---)--^------+  |   +-------------+
CONTROL----/   |         |                 |
GAME MODE------^---------^-----------------^------------------------------+
DIFFICULTY-----^---------^-----------------^----------------------------+ |
SOUND ON/OFF---^---------^-----------------^---------------------------+| |
QUIT-----------^---------^-----------------^--------------------------+|| |
               |         |                 |                          ||| |
+--------------+         |                 |                          ||| |
|                        +--------------+  |                          ||| |
+----Start game (The fun is begins)    |  |                          ||| |
                                        |  |                          ||| |
+---------------------------------------+stip to (1)               (1)||| |
|								    | ||| |
+----Select number of players (up to 5 player are possible) !!!!!   | ||| |
								    | ||| |
+-------------------------------------------------------------------+ ||| |
|					  			      ||| |
PLAYER 1:(CONTROL MODE)------+					      ||| |
(CONTROL OPTIONS)------------^---+				      ||| |
PLAYER 2:(CONTROL MODE)------+   |				      ||| |
(CONTROL OPTIONS)------------^---+----------------------------------+ ||| |
PLAYER 3:(CONTROL MODE)------+   |				    | ||| |
(CONTROL OPTIONS)------------^---+				    | ||| |
   |                         |   |				    | ||| |
   v                         |    \				    | ||| |
PLAYER 5:(CONTROL MODE)------+-----)---+			    | ||| |
(CONTROL OPTIONS)-----------------/    |			    | ||| |
                                       |			    | ||| |
+--------------------------------------+			    | ||| |
|								    | ||| |
Possible selections:						    | ||| |
KEYBOARD---------------------------------------------------------+  | ||| |
ROTATION KEYBOARD----------------------------------------------+ |  | ||| |
MOUSE--------------------------------------------------------+ | |  | ||| |
JOYSTICK A *-----------------------------------------------+ | | |  | ||| |
JOYSTICK B *---------------------------------------------+ | | | |  | ||| |
                                                         | | | | |  | ||| |
*)available only when JOYSTICK support enabled           | | | | |  | ||| |
+--------------------------------------------------------+ | | | |  | ||| |
|							   | | | |  | ||| |
use second Joystick to control player.			   | | | |  | ||| |
use stick to rotate and button to accelerate		   | | | |  | ||| |
see also JOYSTICK SUPPORT,CONTROL MODE			   | | | |  | ||| |
+----------------------------------------------------------+ | | |  | ||| |
|							     | | |  | ||| |
use first Joystick to control player.			     | | |  | ||| |
use stick to rotate and button to accelerate		     | | |  | ||| |
see also JOYSTICK SUPPORT,CONTROL MODE			     | | |  | ||| |
+------------------------------------------------------------+ | |  | ||| |
|							       | |  | ||| |
use mouse to control player.                                   | |  | ||| |
use pointer to rotate and button to accelerate                 | |  | ||| |
mouse must be configured in				       | |  | ||| |
usr/local/lib/libvga.conf read this file for more              | |  | ||| |
informations.                                                  | |  | ||| |
use arrow to rotate player and button to accelerate.           | |  | ||| |
mouse can be also use to control menus!                        | |  | ||| |
there are no CONTROL OPTIONS supported                         | |  | ||| |
+--------------------------------------------------------------+ |  | ||| |
|                                                                |  | ||| |
use keyboard to control player                                   |  | ||| |
3 keys are used:ACCELERATE,ROTATE LEFT,ROTATE RIGHT              |  | ||| |
note:there are no predefined settings! use CONTROL OPTIONS       |  | ||| |
to set keys!                                                     |  | ||| |
see also: CONTROL OPTIONS , KEYBOARD PROBLEM                     |  | ||| |
+----------------------------------------------------------------+  | ||| |
|                                                                   | ||| |
use keyboard to control player                                      | ||| |
4 keys are used:LEFT RIGHT UP AND DOWN                              | ||| |
there are predefined settings:                                      | ||| |
player 1:cursor box                                                 | ||| |
player 2:Arrows on keypad.                                          | ||| |
player 3: there are no predefined settings! use CONTROL OPTIONS     | ||| |
player 4: there are no predefined settings! use CONTROL OPTIONS     | ||| |
see also: CONTROL OPTIONS , KEYBOARD PROBLEM                        | ||| |
+-------------------------------------------------------------------+ ||| |
|								      ||| |
(CONTROL OPTIONS)may be on of following:			      ||| |
CHANGE KEYS-------------------+					      ||| |
CALIBRATE JOYSTICK A-------+  |					      ||| |
CALIBRATE JOYSTICK B----+  |  +---------------------------------+     ||| |
			|  +---------------------------------+  |     ||| |
+-----------------------+                                    |  |     ||| |
select it to calibrate second joystick.			     |  |     ||| |
if you still see same menu your joystick is broken           |  |     ||| |
or joystick toolkit is not initialized(see JOYSTICK SUPPORT) |  |     ||| |
otherwise you will see:                                      |  |     ||| |
Move joystick to lower right corner                          |  |     ||| |
look at your joystick:                                       |  |     ||| |
(it is usually futuristic designed black thing)              |  |     ||| |
there is black stick.                                        |  |     ||| |
get it and move it into lower right corner.then press        |  |     ||| |
red button on joystick or space key.                         |  |     ||| |
                                                             |  |     ||| |
then you will see:                                           |  |     ||| |
       Center joystick                                       |  |     ||| |
and press either button or space                             |  |     ||| |
                                                             |  |     ||| |
Place joystick on your desk.center the stick.                |  |     ||| |
and smoothly and slowly press space key.                     |  |     ||| |
+------------------------------------------------------------+  |     ||| |
|								|     ||| |
select it to calibrate first joystick.			        |     ||| |
if you still see same menu your joystick is broken              |     ||| |
or joystick toolkit is not initialized(see JOYSTICK SUPPORT)    |     ||| |
otherwise you will see:                                         |     ||| |
Move joystick to lower right corner                             |     ||| |
look at your joystick:                                          |     ||| |
(it is usually futuristic designed black thing)                 |     ||| |
there is black stick.                                           |     ||| |
get it and move it into lower right corner.then press           |     ||| |
red button on joystick or space key.                            |     ||| |
                                                                |     ||| |
then you will see:                                              |     ||| |
       Center joystick                                          |     ||| |
and press either button or space                                |     ||| |
                                                                |     ||| |
Place joystick on your desk.center the stick.                   |     ||| |
and smoothly and slowly press space key.                        |     ||| |
+---------------------------------------------------------------+     ||| |
|								      ||| |
define your keys:                                                     ||| |
if you see ACCELERATION skip to b)                                    ||| |
if you see UP skip to a)                                              ||| |
a)you have selected KEYBOARD                                          ||| |
  press a key what you want use to move up			      ||| |
  then you will see:                                                  ||| |
  DOWN                                                                ||| |
  press a key what you want use to move down			      ||| |
  then you will see:                                                  ||| |
  LEFT                                                                ||| |
  press a key what you want use to move left			      ||| |
  then you will see:                                                  ||| |
  RIGHT                                                               ||| |
  press key what you want use to move right			      ||| |
  then a you will see:                                                ||| |
see also:KEYBOARD PROBLEMS                                            ||| |
b)you have selected ROTATION KEYBOARD                                  ||| |
  press a key what you want use to accelerate   		      ||| |
  then you will see:                                                  ||| |
  ROTATE LEFT                                                         ||| |
  press a key what you want use to rotate left			      ||| |
  then you will see:                                                  ||| |
  ROTATE RIGHT                                                        ||| |
  press a key what you want use to rotate right			      ||| |
  then you will see:                                                  ||| |
see also:KEYBOARD PROBLEMS                                            ||| |
+---------------------------------------------------------------------+|| |
|								       || |
back to the reality						       || |
NOT RECOMMENDED!!!! VERY DANGEROUS				       || |
RISK OF THE PSYCHICAL ( PHYSICAL ? ) SHOCK              	       || |
+----------------------------------------------------------------------+| |
|								        | |
turns the space sound on/off						| |
+-----------------------------------------------------------------------+ |
menu:									  |
EASY----------------------------+					  |
MEDIUM------------------+	|					  |
HARD-------------+	|	|					  |
                 |	|	|					  |
+----------------+	|	|					  |
|			|	|					  |
only for professionals!	|	|					  |
+-----------------------+	|					  |
|				|					  |
recommended mode			|					  |
+-------------------------------+					  |
|									  |
less fun								  |
+-------------------------------------------------------------------------+
|
menu:
DEATH MATCH(doom)---------------+
COOPERATIVE---------+		|
		    |		|
+-------------------+		|
|				|
default mode.			|
operates in both		|
multi-player and			|
mono-player modes		|
100 levels!			|
+-------------------------------+
|
for doom maniacs  -try to kill each other and stay alive!




VERY VERY EASY, isn't it? :)
                                 -----
                                /     \
                               | o | o |     
===========================OO==============OO=============================

		          PC KEYBOARD PROBLEMS
			 ----------------------
If you feel week go away! I have to tell you a story about stupidity of your 
keyboard controller. Once open a time ?BM (alias Little Yellow) made a stupid
keyboard which is not able to handle more than 4 keys at a time...
... and they lived happily ever after.


			    JOYSTICK SUPPORT
                              (linux only)
			   ------------------
requires joystick toolkit.in distribution is patch for joystick-0.7.1 to 
compile  under newer version of kernel(1.3.x) installation:
tar xzvf joystick-0.7.1.tar.gz
patch -p0 <  <home directory of koules sources>patch
cd joystick-0.7.1
cp joystick.h /usr/include/linux
make joystick.o

before you run game enter
insmod joystick.o
you will see:
js_init: found <number> joysticks

number must be 1 or 2!!!

			     SOUND SUPPORT
                              (linux only)
			    ---------------
koules support voxware sound driver and pcsnd pcspeaker driver.

			         FAQ
				-----

Q:  Sounds not running.
A:  You entered invalid path edit makefile.
    Note on spaces and / at end of path.

Q:  Why this stupid game don't run on my machine?
A:  Your stupid machine is not supported. Buy another one.

Q:  Why game run s l o w l y ?
A:  Try 320x200 or 320x250 version.

Q:  Why game still run s l o w l y ?
A:  Buy sextium ;)

see Koules.FAQ for more

			       COPYING
			      ---------
This program is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 2 of the License, or (at
your option) any later version.

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.


			         BUGS
				------
There is bug in my svgalib.1.2.6/7:
switch to another console, switch back and press enter it will crash your
computer.It is not koules bug!!! Test it on svgalib/demos/keytest!

Koules from the top:

                             .              
		 ---       .  .                    O
		/   \        . .
	       |     |    . . .. ---
	        \   /           /   \        X           O
                 ---           |    O|
                                \  O/
                                 ---       ---
		.       O                 /O O\
	     . . . .                     |     |
	      . . .                       \   /
            .  .X.  .          O           ---
              . . .                         .
             . . . .                       ...
                .                         . . .
                                         . . . .
                                        .   .   .
			H A V E
			  FUN
                           !

please send a note to my e-mail address so I know how many people play Koules.
send any comments, problems, suggestions, donations, flames, ideas for KoulesII
email:
hubicka@limax.paru.cas.cz

smail:
Jan Hubicka
Dukelskych bojovniku 1944
Tabor 39001
Czech Republic

